diff options
author | David Robillard <d@drobilla.net> | 2012-07-09 08:14:31 +0000 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2012-07-09 08:14:31 +0000 |
commit | be74b2dfd8d915808f6be7a82e5821cbecee1814 (patch) | |
tree | cc21fb2460772df573b0584aa2236bd603e46b13 | |
parent | 90a764bd5583611dd9e76a85b7e36d681c20a828 (diff) | |
download | suil-be74b2dfd8d915808f6be7a82e5821cbecee1814.tar.gz suil-be74b2dfd8d915808f6be7a82e5821cbecee1814.tar.bz2 suil-be74b2dfd8d915808f6be7a82e5821cbecee1814.zip |
Factor out documentation fixup stuff to autowaf.
Update Doxygen stuff and improve documentation style.
Update to r70/autowaf.
git-svn-id: http://svn.drobilla.net/lad/trunk/suil@4528 a436a847-0d15-0410-975c-d299462d15a1
-rw-r--r-- | NEWS | 2 | ||||
-rw-r--r-- | doc/reference.doxygen.in | 4 | ||||
-rwxr-xr-x | waf | bin | 92492 -> 93356 bytes | |||
-rw-r--r-- | wscript | 24 |
4 files changed, 6 insertions, 24 deletions
@@ -1,7 +1,7 @@ suil (9999) unstable; - * Fix typo in suil_ui_supported() documentation * Correctly handle resizing for Gtk2 in Qt4 + * Improve documentation -- David Robillard <d@drobilla.net> diff --git a/doc/reference.doxygen.in b/doc/reference.doxygen.in index b2b44c9..c6bf481 100644 --- a/doc/reference.doxygen.in +++ b/doc/reference.doxygen.in @@ -827,7 +827,7 @@ USE_HTAGS = NO # will generate a verbatim copy of the header file for each class for # which an include is specified. Set to NO to disable this. -VERBATIM_HEADERS = YES +VERBATIM_HEADERS = NO #--------------------------------------------------------------------------- # configuration options related to the alphabetical class index @@ -1708,7 +1708,7 @@ GRAPHICAL_HIERARCHY = NO # in a graphical way. The dependency relations are determined by the #include # relations between the files in the directories. -DIRECTORY_GRAPH = YES +DIRECTORY_GRAPH = NO # The DOT_IMAGE_FORMAT tag can be used to set the image format of the images # generated by dot. Possible values are svg, png, jpg, or gif. Binary files differ@@ -36,7 +36,7 @@ def options(opt): def configure(conf): conf.load('compiler_c') conf.load('compiler_cxx') - conf.line_just = 46 + conf.line_just = 40 autowaf.configure(conf) autowaf.display_header('Suil Configuration') @@ -154,27 +154,9 @@ def build(bld): if bld.env['DOCS']: bld.add_post_fun(fix_docs) -def build_dir(ctx, subdir): - if autowaf.is_child(): - return os.path.join('build', APPNAME, subdir) - else: - return os.path.join('build', subdir) - def fix_docs(ctx): - try: - top = os.getcwd() - os.chdir(build_dir(ctx, 'doc/html')) - os.system("sed -i 's/SUIL_API //' group__suil.html") - os.system("sed -i 's/SUIL_DEPRECATED //' group__suil.html") - os.system("sed -i 's/href=\"doc\/style.css\"/href=\"style.css\"/' group__suil.html") - os.remove('index.html') - os.symlink('group__suil.html', 'index.html') - os.chdir(top) - os.chdir(build_dir(ctx, 'doc/man/man3')) - os.system("sed -i 's/SUIL_API //' suil.3") - os.chdir(top) - except: - Logs.error("Failed to fix up %s documentation" % APPNAME) + if ctx.cmd == 'build': + autowaf.make_simple_dox(APPNAME) def upload_docs(ctx): os.system("rsync -ravz --delete -e ssh build/doc/html/ drobilla@drobilla.net:~/drobilla.net/docs/suil/") |