git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@21837 a95241bf-73f2-0310-859d-f6bbb57e9c96

docs/user/apidoc.dox

@@ -3,9 +3,9 @@
  * Distributed under the terms of the MIT License.
  *
  * Authors:
- *   Niels Sascha Reedijk, [email protected]
+ *		Niels Sascha Reedijk, [email protected]
  * Proofreaders:
- *   Alan Smale, [email protected]
+ *		Alan Smale, [email protected]
  */
 
 
@@ -15,7 +15,10 @@
 	This article explains how to document the API. Its intended audience are the
 	Haiku developers who want to document their own classes, and also the
 	members of the API Documentation team who want to brush up the
-	documentation.
+	documentation. The guidelines are synchronous with the Haiku Coding
+	Guidelines, which means that the formal requirements are the same where
+	applicable. If you find an inconsistency, it's usually a good idea to
+	report this on the documentation team's mailing list.
 	
 	This document is divided into three sections. \ref formalrequirements
 	describes the demands that are made from the markup and spacing of the
@@ -83,12 +86,12 @@
 * Distributed under the terms of the MIT License.
 *
 * Authors:
-*   Niels Sascha Reedijk, [email protected]
+*		Niels Sascha Reedijk, [email protected]
 * Proofreaders:
-*   Alan Smale, [email protected]
+*		Alan Smale, [email protected]
 * Corresponds to:
-*   /trunk/headers/os/support/String.h  rev 19731
+*		/trunk/headers/os/support/String.h  rev 19731
-*   /trunk/src/kits/support/String.cpp  rev 19731
+*		/trunk/src/kits/support/String.cpp  rev 19731
 */
 	\endverbatim
 
@@ -104,7 +107,7 @@
 		followed by an empty line.
 	-# Then there is a label <tt>Authors:</tt>, which is followed by
 		lines with names and email addresses. The latter one is optional, but
-		recommended.
+		recommended. Each author is preceeded by two tabs after the asterix.
 	-# In the same vein there is the label <tt>Proofreaders:</tt> in case the
 		file has been proofread.
 	-# The final part is underneath the label <tt>Corresponds to:</tt>.

docs/user/support/Archivable.dox

@@ -3,15 +3,15 @@
  * Distributed under the terms of the MIT License.
  *
  * Author:
- *   Niels Sascha Reedijk, [email protected]
+ *		Niels Sascha Reedijk, [email protected]
  *
  * Proofreader:
- *   David Weizades, [email protected]
+ *		David Weizades, [email protected]
- *   Thom Holwerda, [email protected]
+ *		Thom Holwerda, [email protected]
  *
  * Corresponds to:
- *   /trunk/headers/os/support/Archivable.h rev 19972
+ *		/trunk/headers/os/support/Archivable.h rev 19972
- *   /trunk/src/kits/support/Archivable.cpp rev 19095
+ *		/trunk/src/kits/support/Archivable.cpp rev 19095
  */
 
 

docs/user/support/BlockCache.dox

@@ -3,15 +3,15 @@
  * Distributed under the terms of the MIT License.
  *
  * Authors:
- *   Niels Sascha Reedijk, [email protected]
+ * 		Niels Sascha Reedijk, [email protected]
  *
  * Proofreading:
- *   David Weizades, [email protected]
+ * 		David Weizades, [email protected]
- *   Thom Holwerda, [email protected]
+ *		Thom Holwerda, [email protected]
  * 
  * Corresponds to:
- *   /trunk/headers/os/support/BlockCache.h  rev 19972
+ *		/trunk/headers/os/support/BlockCache.h  rev 19972
- *   /trunk/src/kits/support/BlockCache.cpp  rev 4568
+ *		/trunk/src/kits/support/BlockCache.cpp  rev 4568
  */
 
 

docs/user/support/List.dox

@@ -3,16 +3,16 @@
  * Distributed under the terms of the MIT License.
  *
  * Authors:
- *   Niels Sascha Reedijk, [email protected]
+ *		Niels Sascha Reedijk, [email protected]
  * 
  * Proofreading:
- *   David Weizades, [email protected]
+ *		David Weizades, [email protected]
- *   Thom Holwerda, [email protected]
+ *		Thom Holwerda, [email protected]
- *   John Drinkwater, [email protected]
+ *		John Drinkwater, [email protected]
  *
  * Corresponds to:
- *   /trunk/headers/os/support/List.h  rev 19972
+ *		/trunk/headers/os/support/List.h  rev 19972
- *   /trunk/src/kits/support/List.cpp  rev 18649
+ *		/trunk/src/kits/support/List.cpp  rev 18649
  */