1 mike  1.1 
 2           February 4, 2001 - Mike Brasher - Remarks about documentation
 3           
 4           
 5               1.	There are lots of places where I have blocks like this in headers.
 6           
 7           	////////////////////////////////////////////////////////////////////////
 8           	//
 9           	// Array.h
10           	//
11           	//	Blah blah blah!
12           	//
13           	////////////////////////////////////////////////////////////////////////
14           
15           	I am starting to remove these.
16           
17               2.	Noticed that wer are using templates in a coupld of places. Does DOC++ 
18                   handle these alright? Array.h
19           
20               3.	Is there anyway to cause DOC++ to ignore some classes (like Rep
21           	classes)?
22 mike  1.1 
23               4.  Reformatted some comments in Array.h to get this style:
24           
25           	
26           	    /** This method does something
27           		useful.
28           	    */
29           	    void f();
30           
31           	    /** This last method has a newline after it
32           	        so that lexdisic individuals can see it.
33           	    */
34           	    void g();
35           
36               5.	Wondering whether CGIQueryString should be moved out of
37           	<Pegasus/Common> since it is not really part of the core and
38           	is only used by CGIClient. Perhaps it should reside in CGIClient.
39           
40               6.	Should brief comments be terminated or not with periods?
41           
42           	    /// This method does something.
43 mike  1.1 	    void h();
44           
45               7.	Does DOC++ handle ordinary C-style functions (that are not
46           	methods of classes?
47           
48               
49               8.	I need to provide some explanation of how the data objects work.
50           	When the default constructor is used, the object represents a
51           	null handle, which if referenced, throws a null pointer exception.
52           	
53           
54               9.	Documented Array.h, CGIQueryString.h and Char16.h. Assumed that
55           	we would not overlap on these.
56           
57               10.	Need to talk about ClassDecl.h. Some clarification is needed about
58           	the way the handles work.