diff options
author | Mats Wichmann <mats@linux.com> | 2020-06-10 17:09:09 (GMT) |
---|---|---|
committer | Mats Wichmann <mats@linux.com> | 2020-06-10 17:12:42 (GMT) |
commit | 2f5841806011b1ca123e58ddaa55e4319b5468da (patch) | |
tree | 44c9910e3aa95d45766d6b67a7a3ca5987c3036e /doc/user | |
parent | 07ba4716ef08158da819ec98b4533d06c84c12dc (diff) | |
download | SCons-2f5841806011b1ca123e58ddaa55e4319b5468da.zip SCons-2f5841806011b1ca123e58ddaa55e4319b5468da.tar.gz SCons-2f5841806011b1ca123e58ddaa55e4319b5468da.tar.bz2 |
Documentation updates in perparation for 4.0 [ci skip]
* Switch API docs to readthedocs theme
* Add links in manpage SEE ALSO to external websites. These are not just
live, but also listed out (Linux manpages won't have the hyperlinks)
* Links use docbook5 xlink:href instead of deprecated (claimed to be
removed, but apparently not) ulink syntax
* Comment out manpage Examples section, and leave a pointer to
scons-cookbook.readthedocs.io instead
* Regenerate everything, mainly to pick up compilation_db stuff.
Signed-off-by: Mats Wichmann <mats@linux.com>
Diffstat (limited to 'doc/user')
-rw-r--r-- | doc/user/main.xml | 5 | ||||
-rw-r--r-- | doc/user/misc.xml | 6 |
2 files changed, 6 insertions, 5 deletions
diff --git a/doc/user/main.xml b/doc/user/main.xml index 34555af..dded9cf 100644 --- a/doc/user/main.xml +++ b/doc/user/main.xml @@ -62,6 +62,7 @@ <book xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xmlns:xlink="http://www.w3.org/1999/xlink" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0 http://www.scons.org/dbxsd/v1.0/scons.xsd"> <bookinfo> <title>SCons &buildversion;</title> @@ -74,10 +75,10 @@ <corpauthor>Steven Knight and the SCons Development Team</corpauthor> - <pubdate>2004 - 2019</pubdate> + <pubdate>2004 - 2020</pubdate> <copyright> - <year>2004 - 2019</year> + <year>2004 - 2020</year> <holder>The SCons Foundation</holder> </copyright> diff --git a/doc/user/misc.xml b/doc/user/misc.xml index e430897..bd20397 100644 --- a/doc/user/misc.xml +++ b/doc/user/misc.xml @@ -685,9 +685,9 @@ env.Command('directory_build_info', </para> <para> See - <ulink url="https://clang.llvm.org/docs/JSONCompilationDatabase.html"> - <citetitle>JSON Compilation Database Format Specification¶</citetitle> - </ulink> + <link xlink:href="https://clang.llvm.org/docs/JSONCompilationDatabase.html"> + <citetitle>JSON Compilation Database Format Specification</citetitle> + </link> for complete information </para> |