X-Git-Url: https://granicus.if.org/sourcecode?a=blobdiff_plain;f=docs%2Fmanual%2Fdeveloper%2Fdocumenting.html.en;h=7025a0f0170c82f0fc354a17a6906d427edc2b9f;hb=6bb3d694de02870e5fe962eacfd168228d67fd58;hp=5fef9988e4af0661be00a0b0de1bd34377083b96;hpb=66ebad0a7cd09b04c04f3af7a1fe791f2a101a59;p=apache diff --git a/docs/manual/developer/documenting.html.en b/docs/manual/developer/documenting.html.en index 5fef9988e4..7025a0f017 100644 --- a/docs/manual/developer/documenting.html.en +++ b/docs/manual/developer/documenting.html.en @@ -5,20 +5,28 @@ This file is generated from xml source: DO NOT EDIT XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --> -
Apache HTTP Server Version 2.1
+Apache HTTP Server Version 2.5
Apache 2.0 uses Doxygen to - document the APIs and global variables in the the code. This will explain +Apache > HTTP Server > Documentation > Version 2.5 > Developer Documentation
Apache 2.4 uses Doxygen to + document the APIs and global variables in the code. This will explain the basics of how to document using Doxygen.
The deffunc
is not always necessary. DoxyGen does not
have a full parser in it, so any prototype that use a macro in the
return type declaration is too complex for scandoc. Those functions
@@ -45,25 +53,25 @@
/**
- * return the final element of the pathname
- * @param pathname The path to get the final element of
- * @return the final element of the path
- * @tip Examples:
- * <pre>
- * "/foo/bar/gum" -> "gum"
- * "/foo/bar/gum/" -> ""
- * "gum" -> "gum"
- * "wi\\n32\\stuff" -> "stuff"
- * </pre>
- * @deffunc const char * ap_filename_of_pathname(const char *pathname)
- */
+ * return the final element of the pathname
+ * @param pathname The path to get the final element of
+ * @return the final element of the path
+ * @tip Examples:
+ * <pre>
+ * "/foo/bar/gum" -> "gum"
+ * "/foo/bar/gum/" -> ""
+ * "gum" -> "gum"
+ * "wi\\n32\\stuff" -> "stuff"
+ * </pre>
+ * @deffunc const char * ap_filename_of_pathname(const char *pathname)
+ */
At the top of the header file, always include:
/**
- * @package Name of library header
- */
+ * @package Name of library header
+ */
Doxygen uses a new HTML file for each package. The HTML files are named @@ -72,7 +80,31 @@
For a further discussion of the possibilities please refer to the Doxygen site.