---++!! How to Write Documentation for NPL and ParaEngine NPL and ParaEngine uses [[http://www.doxygen.org/][Doxygen]] to document the APIs and global variables in the code. This will explain the basics of how to document using Doxygen. ---++ Brief Description To start a documentation block, use /**<br />To end a documentation block, use */ In the middle of the block, there are multiple tags we can use: For Cpp code: %CODE{"cpp"}% Description of this functions purpose<br />@param parameter_name description<br />@return description /**<br />* return the final element of the pathname<br />* @param pathname The path to get the final element of<br />* @return the final element of the path<br />* @tip Examples: */ At the top of the header file, always include: /**<br />* @package Name of library header<br />*/ %ENDCODE% For NPL code: %CODE{"lua"}% --[[ Title: math lib funcions Author(s): LiXizhi Date: 2007/10/18 Desc: Use Lib: ------------------------------------------------------- NPL.load("(gl)script/ide/mathlib.lua"); ------------------------------------------------------- ]] if(not mathlib) then mathlib={}; end -- Conversion Quaternion to Euler -- @param q1: {x,y,z,w} -- @return: heading, attitude, bank -- @note: code converted from http://www.euclideanspace.com/maths/geometry/rotations/conversions/quaternionToEuler/index.htm function mathlib.QuatToEuler(q1) end %ENDCODE% Doxygen uses a new HTML file for each package. The HTML files are named {Name_of_library_header}.html, so try to be concise with your names. For a further discussion of the possibilities please refer to [[http://www.doxygen.org/][the Doxygen site]].
E
dit
|
A
ttach
|
P
rint version
|
H
istory
: r1
|
B
acklinks
|
V
iew topic
|
Ra
w
edit
|
M
ore topic actions
Topic revision: r1 - 2008-03-01
-
LiXizhi
Home
Site map
CCWeb web
HaqiTeen web
Main web
ParaEngine web
TWiki web
Main Web
Users
Groups
Index
Search
Changes
Notifications
RSS Feed
Statistics
导航页WebTopMenu
Preferences
开发指南
Getting Started
ParacraftSDK
NPL
MCML
NPL Reference Manual
美术Mod
Account
Log In
English
简体中文
簡體中文
E
dit
A
ttach
Copyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki?
Send feedback