137 Commits

Author SHA1 Message Date
Chris Johns
58de62d8be Revert "Add the sphinxcontrib.bibtex extension to the repo."
This reverts commit aa4f8e2e436d6c49e1524a4a3fb164b28632d894.

The contrib has too many dependencies to add into the repo.
2017-08-09 20:19:22 +10:00
Chris Johns
aa4f8e2e43 Add the sphinxcontrib.bibtex extension to the repo. 2017-08-07 21:58:52 +10:00
Chris Johns
33989b6bf6 Add Windows build details.
Actually include the quoting fix for Windows.
2017-03-27 10:31:13 +11:00
Chris Johns
02635812f6 waf: Fix linkcheck and spell commands.
Clean up and remove code that is not needed.

Fix sphinx-build quoting to work on Windows.
2017-03-27 10:27:29 +11:00
Chris Johns
e7f009e549 conf: Update the copyright year. 2017-03-21 08:41:55 +11:00
Chris Johns
228560fdf2 waf: Create the sphinx rule in one place. 2017-03-21 08:41:41 +11:00
Chris Johns
f97be09daf Use a single top level version number. 2017-03-20 12:18:53 +11:00
Chris Johns
1accbe31a5 user: Add tool commands to the user manual. 2017-03-15 15:03:41 +11:00
Chris Johns
91d6c96b4c waf: Configure check the inliner only once. 2017-03-15 15:03:10 +11:00
Chris Johns
ff9d55501f Add a check for Sphinx extensions.
Minor clean up of the configure messages.

Do not re-check sphinx in the nested configures.
2017-02-25 15:05:09 +11:00
Sebastian Huber
c1dddacbee Move extensions to common conf.py 2017-02-22 07:09:21 +01:00
Sebastian Huber
b033e3960b c-user: Add SMP application issues section 2017-02-02 10:46:05 +01:00
Sebastian Huber
7b1c63cf91 c-user: Update clustered scheduling 2017-02-02 09:43:47 +01:00
Sebastian Huber
3966353b33 Do not show page references after internal links 2017-02-01 09:48:31 +01:00
Sebastian Huber
5dcebd4f62 Fix refs.bib entries 2017-02-01 07:58:30 +01:00
Sebastian Huber
8add1793d2 c-user: Add Key concept locking protocols
Update #2412.
Update #2556.
2017-02-01 07:58:30 +01:00
Sebastian Huber
938c49e177 Fix refs.bib entry 2017-01-31 14:30:09 +01:00
Sebastian Huber
a17535d222 c-user: Add timer and timeouts key concept
Update #2554.
2017-01-30 13:52:23 +01:00
Sebastian Huber
73ad65dff0 refs.bib: Add URL 2017-01-30 08:11:37 +01:00
Kuan-Hsun Chen
c660173fa4 c-user: Update overrun handling related functions and structure
State the limited count of postponed_jobs.
Update _rtems_rate_monotonic_get_status() and related structure.
Move "Further Reading" in c-user to references.
Add mentioned papers in ticket #2795 to references.

Update #2795.
2017-01-30 07:58:27 +01:00
Sebastian Huber
0456ee759a Fix some reference titles 2017-01-25 08:36:41 +01:00
Sebastian Huber
f5e8e8068f Sort references 2017-01-25 08:26:39 +01:00
Sebastian Huber
97e1553c06 c-user: Add support for references via bibtex
https://sphinxcontrib-bibtex.readthedocs.io/en/latest/index.html

Update #2871.
2017-01-18 11:31:46 +01:00
Chris Johns
7956bbffef coverpage: Remove used function. 2017-01-12 13:20:48 +11:00
Chris Johns
321d20a02d coverpage: Make showing the table conditional. 2017-01-12 13:18:43 +11:00
Chris Johns
bceb2860b7 coverpage: Rename the static images directory to match bootstrap. 2017-01-12 13:11:34 +11:00
Chris Johns
9eb8a437bd coverpage: Fix the catalogue table id. 2017-01-12 13:07:13 +11:00
Chris Johns
049097fc80 coverpage: Update the coverpage to have the table collapse.
Add each doc's conf.py as a dependence to catalogue.xml.
2017-01-12 12:56:13 +11:00
Justin Powell
876035b7bd conf.py: Fix build_date() to append correct suffix on all days. 2017-01-11 19:24:46 -06:00
Chris Johns
2591ca6390 html: Embed the catalogue XML in JS.
The is to work around a security issue with Chrome on Windows. This
patches let the cover page load on Chrome and Edge on Windows 10.
2017-01-11 17:04:02 +11:00
Chris Johns
ecf82d1b3d html: Add support for an HTML cover page for releases. 2017-01-11 15:56:04 +11:00
Chris Johns
9aa52b9130 waf: Add a title to the XML Catalogue. 2017-01-10 22:34:47 +11:00
Chris Johns
782b4fec71 waf: Improved XML Catalogue generator. 2017-01-10 10:11:05 +11:00
Chris Johns
1a9b02e20d waf: Create an XML Catalogue. 2017-01-09 23:13:02 +11:00
Chris Johns
9330bfbaa7 waf: Users without the extra fonts need to use '--disable-extra-fonts' to build PDF. 2016-11-09 17:08:05 +11:00
Chris Johns
a91dd5c695 latex: Increase the depth of subsections. 2016-11-09 11:42:30 +11:00
Chris Johns
227aaea494 waf: Get a copy of the optional packages. 2016-11-08 16:08:54 +11:00
Chris Johns
2fdbc9826f waf: Use the good fonts if installed. 2016-11-08 15:58:58 +11:00
Chris Johns
daea85e3b2 pdf: Format lists for directives to sit on the next line. 2016-11-08 15:28:32 +11:00
Chris Johns
5a7280afd7 PDF: Do not use lato and inconsolata fonts. Not widely supported. 2016-11-07 11:18:04 +11:00
Chris Johns
ea91103855 waf: Add a program test for pygmentize. 2016-11-07 10:33:17 +11:00
Christian Mauderer
b6272bbd56 waf: Fix ''NoneType' object is not iterable' 2016-11-07 10:05:13 +11:00
Chris Johns
25c0a23445 waf: Fix the host version check. 2016-11-06 12:40:41 +11:00
Chris Johns
8330198edc waf: Add support to handle missing Latex packages on hosts they are not available on.
It appears the support for texlive packages on some hosts is variable. This patch
lets us add missing packages to our source tree so a PDF can be built on
those hosts. The quality of the PDFs created may vary as some short cuts may
have been take. For example lato is a font and only the sty file as been added
and not the actual font which means it's use will default to another font.
2016-11-06 12:02:47 +11:00
Chris Johns
74194f7538 waf: Check for texlive packages and report an error is not found. 2016-11-04 16:22:42 +11:00
Chris Johns
9024cfbc7f waf: Fix the bnode issue when building in a manual directory. 2016-11-04 08:44:37 +11:00
Chris Johns
6207c37d9c waf: Use separate doctrees so avoid sphinx clashes. 2016-11-03 15:22:49 +11:00
Chris Johns
d3226d3d09 pdf: Make the copyright the same as the html. 2016-11-03 14:42:34 +11:00
Chris Johns
64a3db7073 conf: Make the build date use a nicer day format. 2016-11-03 14:41:39 +11:00
Chris Johns
0bc9c6d3de waf: Have configure set building pdf and/or singlehtml.
Move selecting pdf and singlehtml to the configure stage so it
is sticky for all builds. This means a top level build will always
build all formats that have been configured.

Do not complete the configure stage if tools are missing for the
configured output.

Add singlehtml support using the inliner tool. It is nice.

Remove the groups as waf can track the dependences. This lets the
manuals build in parallel.
2016-11-03 14:30:47 +11:00