aboutsummaryrefslogtreecommitdiff
path: root/util/generate_api_docs.sh
diff options
context:
space:
mode:
authorskullydazed <skullydazed@users.noreply.github.com>2018-03-21 23:50:38 -0700
committerJack Humbert <jack.humb@gmail.com>2018-03-22 02:50:38 -0400
commit7c9d5ace143d3cc6d767a354acde814926d566fd (patch)
tree1f2b581b6c9f6278a9e180bfcc8dd86b0a7fd2ef /util/generate_api_docs.sh
parentf0932a8716dc946322c5ebae7f75eaa275c6220c (diff)
downloadqmk_firmware-7c9d5ace143d3cc6d767a354acde814926d566fd.tar.gz
qmk_firmware-7c9d5ace143d3cc6d767a354acde814926d566fd.zip
Generate API docs from source code comments (#2491)
* Generate api docs from source code * Add a bunch of doxygen comments * more doxygen comments * Add the in-progress api docs * script to generate docs from travis * Add doc generation to the travis job * make travis_docs.sh commit the work it does * make sure the docs script exits cleanly
Diffstat (limited to 'util/generate_api_docs.sh')
-rwxr-xr-xutil/generate_api_docs.sh31
1 files changed, 31 insertions, 0 deletions
diff --git a/util/generate_api_docs.sh b/util/generate_api_docs.sh
new file mode 100755
index 000000000..8d7ec3101
--- /dev/null
+++ b/util/generate_api_docs.sh
@@ -0,0 +1,31 @@
1#!/bin/bash
2
3set -x
4
5if ! doxygen -v 2>&1 > /dev/null; then
6 echo "doxygen not found! Please install it!"
7 exit 1
8elif ! moxygen -V 2>&1 > /dev/null; then
9 echo -n "moxygen not found! Would you like to install it? [y/n] "
10 read ANSWER
11 case $ANSWER in
12 y|Y|yes|YES|Yes)
13 npm install -g moxygen
14 ;;
15 *)
16 exit 1
17 ;;
18 esac
19fi
20
21if [ ! -e Doxyfile ]; then
22 echo "Error: You must run this from the top-level qmk_firmware directory!"
23 exit 1
24fi
25
26# Generate the doxygen XML files
27rm -rf doxygen
28doxygen Doxyfile
29
30# Generate the moxygen Markdown files
31moxygen -a -g -o docs/api_%s.md doxygen/xml