server_common/recastnavigation_v1.6.0
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update Doxygen configuration and conceptual content. (Minor changes.)

Browse Source
This commit is contained in:
Stephen Pratt 2011-08-22 21:43:59 +00:00
parent c150272f99
commit a20f4192f3
3 changed files with 73 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
Docs/Conceptual/license_c.txt
View File

@ -1,24 +1,27 @@
/// @page License License
/// /**
/// @page License License
/// <pre>
/// Copyright (c) 2009-2011 Mikko Mononen memon@inside.org <pre>
/// Copyright (c) 2009-2011 Mikko Mononen memon@inside.org
/// This software is provided 'as-is', without any express or implied
/// warranty. In no event will the authors be held liable for any damages This software is provided 'as-is', without any express or implied
/// arising from the use of this software. warranty. In no event will the authors be held liable for any damages
/// arising from the use of this software.
/// Permission is granted to anyone to use this software for any purpose,
/// including commercial applications, and to alter it and redistribute it Permission is granted to anyone to use this software for any purpose,
/// freely, subject to the following restrictions: including commercial applications, and to alter it and redistribute it
/// freely, subject to the following restrictions:
/// 1. The origin of this software must not be misrepresented; you must not
/// claim that you wrote the original software. If you use this software 1. The origin of this software must not be misrepresented; you must not
/// in a product, an acknowledgment in the product documentation would be claim that you wrote the original software. If you use this software
/// appreciated but is not required. in a product, an acknowledgment in the product documentation would be
/// appreciated but is not required.
/// 2. Altered source versions must be plainly marked as such, and must not be
/// misrepresented as being the original software. 2. Altered source versions must be plainly marked as such, and must not be
/// misrepresented as being the original software.
/// 3. This notice may not be removed or altered from any source distribution.
/// <pre> 3. This notice may not be removed or altered from any source distribution.
</pre>
*/

42
Docs/Readme.txt Normal file
View File

@ -0,0 +1,42 @@
This directory contains source for the documentation. It is also the
build target for doxygen output.
Directory Layout
. (Docs root)
High level content and format files. (E.g. css, header, footer.)
./Conceptual
Conceptual (non-api) documentation such as overviews, how-to's, etc.
The main index page content is also in this directory.
./Extern
API documentation that is located outside the source files.
When the API documentation gets too big or complex for the header
and source files, it goes in this directory.
./Images
Images related to the docuemntation.
Miscellany
One of the requirements for the API documentation is that it
has the minimum possible impact on the declarations in the
header files. So, in general, the header file declarations only
contain summary documentation. The detail documentation
is placed as follows:
1. If an element is defined in a cpp file, then place
the detail documentation in the source file.
2. If an element does not have an associated cpp file, then
place the detail documentation at the end of the header file.
3. If there is a lot of detail documentation cluttering up
the end of a header file, then the content is moved to
a separate file in the Extern directory.

6
Doxyfile
View File

@ -617,7 +617,8 @@ INPUT = Detour \
DetourCrowd \ DetourCrowd \
DetourTileCache \ DetourTileCache \
Recast \ Recast \
Docs\Conceptual Docs\Conceptual \
Docs\Extern
# This tag can be used to specify the character encoding of the source files # This tag can be used to specify the character encoding of the source files
# that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
@ -637,7 +638,8 @@ INPUT_ENCODING = UTF-8
FILE_PATTERNS = *.cpp \ FILE_PATTERNS = *.cpp \
*.h \ *.h \
*_c.txt *_c.txt \
*_api.txt
# The RECURSIVE tag can be used to turn specify whether or not subdirectories # The RECURSIVE tag can be used to turn specify whether or not subdirectories
# should be searched for input files as well. Possible values are YES and NO. # should be searched for input files as well. Possible values are YES and NO.