Make CodingSuggestions show up in the Doxygen pages.

(This used to be commit b3e34ad3207f53310b2d59c07a4cec765a0f81bf)

source3/CodingSuggestions

@@ -1,3 +1,7 @@
+/**
+
+@page CodingSuggestions Coding suggestions
+
 So you want to add code to Samba ...
 
 One of the daunting tasks facing a programmer attempting to write code for
@@ -101,14 +105,22 @@ Here are some other suggestions:
 
 20) Try to use asprintf rather than pstrings and fstrings where possible
 
-21) Use normal C comments /* like this */ instead of C++ comments // like
+21) Use normal C comments / * instead of C++ comments // like
-    this.  Although the C++ comment format is part of the C99 standard,
+    this.  Although the C++ comment format is part of the C99
-    some older vendor C compilers do not accept it.
+    standard, some older vendor C compilers do not accept it.
+
+22) Try to write documentation for API functions and structures
+    explaining the point of the code, the way it should be used, and
+    any special conditions or results.  Mark these with a double-star
+    comment start / ** so that they can be picked up by Doxygen, as in
+    this file.
 
 The suggestions above are simply that, suggestions, but the information may
 help in reducing the routine rework done on new code.  The preceeding list
 is expected to change routinely as new support routines and macros are
 added.
 
-Written by Steve French, with contributions from Simo Sorce and Andrew
+Written by Steve French, with contributions from Simo Sorce, Andrew
-Bartlett.
+Bartlett, Tim Potter and Martin Pool.
+
+**/

source3/Doxyfile

@@ -41,6 +41,8 @@ ENABLED_SECTIONS       =
 MAX_INITIALIZER_LINES  = 30
 OPTIMIZE_OUTPUT_FOR_C  = YES
 SHOW_USED_FILES        = YES
+REFERENCED_RELATION    = YES
+REFERENCED_BY_RELATION = YES
 #---------------------------------------------------------------------------
 # configuration options related to warning and progress messages
 #---------------------------------------------------------------------------
@@ -52,7 +54,8 @@ WARN_LOGFILE           =
 #---------------------------------------------------------------------------
 # configuration options related to the input files
 #---------------------------------------------------------------------------
-INPUT                  = .
+INPUT                  = . \
+                         CodingSuggestions mainpage.dox
 FILE_PATTERNS          = *.c \
                          *.h \
                          *.idl
@@ -79,7 +82,7 @@ HTML_OUTPUT            = html
 HTML_HEADER            = 
 HTML_FOOTER            = 
 HTML_STYLESHEET        = 
-HTML_ALIGN_MEMBERS     = NO
+HTML_ALIGN_MEMBERS     = YE
 GENERATE_HTMLHELP      = NO
 GENERATE_CHI           = NO
 BINARY_TOC             = NO
@@ -123,7 +126,7 @@ GENERATE_XML           = NO
 #---------------------------------------------------------------------------
 # Configuration options related to the preprocessor   
 #---------------------------------------------------------------------------
-ENABLE_PREPROCESSING   = YES
+ENABLE_PREPROCESSING   = NO
 MACRO_EXPANSION        = NO
 EXPAND_ONLY_PREDEF     = NO
 SEARCH_INCLUDES        = YES

source3/mainpage.dox

@@ -0,0 +1,7 @@
+/**
+
+@mainpage
+
+@li \ref CodingSuggestions
+
+**/