[GRASS-SVN] r36188 - grass/branches/releasebranch_6_4

[svn_grass at osgeo.org]

Author: epatton
Date: 2009-03-03 10:05:26 -0500 (Tue, 03 Mar 2009)
New Revision: 36188

Modified:
   grass/branches/releasebranch_6_4/SUBMITTING_DOCS
Log:
Added info on recommended html sections, merge from devbr6 r36187

Modified: grass/branches/releasebranch_6_4/SUBMITTING_DOCS
===================================================================
--- grass/branches/releasebranch_6_4/SUBMITTING_DOCS	2009-03-03 15:01:54 UTC (rev 36187)
+++ grass/branches/releasebranch_6_4/SUBMITTING_DOCS	2009-03-03 15:05:26 UTC (rev 36188)
@@ -22,13 +22,31 @@
 2. Module manual page:
    Place the documentation in HTML format into 'description.html'.
    The easiest way to do this is to study an existing HTML page
-   (to get the page style, e.g. vector/v.to.db/description.html).
-   With a few exceptions header and footer are NOT allowed.
-   You can add figures (PNG format), the figure name prefix should be the 
-   module name. See raster/r.terraflow/description.html for an example.
+   (to get the page style, e.g. vector/v.to.db/v.to.db.html).
+   With a few exceptions, header and footer are NOT allowed.
+   You can add figures (PNG format); the figure name prefix should be the 
+   module name. See raster/r.terraflow/r.terraflow.html for an example.
 
+   A number of major sections should be present in each help page.
+
+   * = Required
+   ! = Suggested
+   . = Optional
+
+   In recommended order
+   --------------------
+
+   * <h2>DESCRIPTION</h2>
+   ! <h2>NOTE</H2>, <h2>NOTES</h2>
+   ! <h2>EXAMPLE</h2>, <h2>EXAMPLES</h2>
+   . <h2>TODO</h2>
+   . <h2>BUGS</h2>
+   . <h2>REFERENCE</h2>, <h2>REFERENCES</h2>
+   * <h2>SEE ALSO</h2>
+   * <h2>AUTHOR</h2>, <h2>AUTHORS</h2>
+
    Note that the parameter information is auto-generated upon
-   compilation. This is done by running module in a virtual session
+   compilation. This is done by running the module in a virtual session
    after compilation (see the output of 'make'). To subsequently
    verify the final HTML page, check the resulting HTML pages which
    will be stored with the name of the module.
@@ -60,7 +78,7 @@
 
 
 5. When submitting new files to the repository set SVN properties,
-   e.g. for HTML file
+   e.g. for HTML file:
     
        svn:mime-type : text/html
        svn:keywords : Author Date Id