mirror of
https://github.com/Doodle3D/doodle3d-firmware.git
synced 2026-08-07 09:34:30 +02:00
Add doxify.sh to generate HTML code documentation using ldoc; update documentation in several utility files.
This commit is contained in:
@@ -0,0 +1,18 @@
|
||||
#!/bin/sh
|
||||
|
||||
# Generate Lua source code documentation using ldoc. Change LDOC to the path of your luadoc executable and change WIFIBOX_BASE_DIR to the location of your wifibox source tree, or "." if you really want a relative output directory.
|
||||
# All given options are forwarded to ldoc, -a is already being passed by default.
|
||||
|
||||
LDOC=/opt/local/share/luarocks/bin/ldoc
|
||||
WIFIBOX_BASE_DIR=~/Files/_devel/eclipse-workspace/wifibox
|
||||
|
||||
HTML_PATH=$WIFIBOX_BASE_DIR/docs
|
||||
SRC_DIR=$WIFIBOX_BASE_DIR/src
|
||||
FILESPEC=$WIFIBOX_BASE_DIR/src #replace by config.ld so we can also specify README.md?
|
||||
|
||||
$LDOC -d $HTML_PATH $FILESPEC -a -f markdown $@
|
||||
|
||||
if [ $? -eq 127 ]; then
|
||||
echo "$0: It looks like the ldoc program could not be found, please configure the LDOC variable correctly and make sure ldoc is installed on your system."
|
||||
echo "$0: By default, this script expects ldoc has been installed with luarocks on OSX, which in turn is installed with macports."
|
||||
fi
|
||||
Reference in New Issue
Block a user