By: Junkbuster Developers
- $Id: developer-manual.sgml,v 1.4 2001/09/23 10:13:48 swa Exp $
+ $Id: developer-manual.sgml,v 1.5 2001/10/31 18:16:51 swa Exp $
The developer manual gives the users information on how to help the
developer team. It provides guidance on coding, testing, documentation
3. Documentation Guidelines
- All docs should be ...
-
- * in a format that is widely used. I propose HTML.
- * we either
- + generate man pages from the documentation (let's _NOT_ write
- them manually), or
- + we have a man page that points to the documentation (I
- propose this option)
- * have a consistent layout
- * have a link to the latest version of the document (i.e. point to a
- URL at sf)
- * be consistent with the redirect script (i.e. the junkbuster
- program points via the redirect URL at sf to valid end-points in
- the document)
- * started from scratch but recycle parts from the original
- junkbuster documents
+ All docs are in SGML format and located in the doc/source directory.
+
+ How do you update the webserver (i.e. the pages on sourceforge)?
+
+ 1. Run make dok (which uses the documents in doc/source to update all
+ text files in doc/text and to update all web documents in
+ doc/webserver.
+ 2. Run make webserver which copies all files from doc/webserver to
+ the sourceforge webserver via scp.
_________________________________________________________________
4. Coding Guidelines
4.8. Addendum: Template for files and function comment blocks:
Example for file comments:
-const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.4 2001/09/23 10:13:
-48 swa Exp $";
+const char FILENAME_rcs[] = "$Id: developer-manual.sgml,v 1.5 2001/10/31 18:16:
+51 swa Exp $";
/*********************************************************************
*
* File : $Source$
Example for file header comments:
#ifndef _FILENAME_H
#define _FILENAME_H
-#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.4 2001/09/23 10:13:4
-8 swa Exp $"
+#define FILENAME_H_VERSION "$Id: developer-manual.sgml,v 1.5 2001/10/31 18:16:5
+1 swa Exp $"
/*********************************************************************
*
* File : $Source$