147 Commits

Author SHA1 Message Date
Chris Johns
471c5e380f pdf: Revert the changes to the Latex index formatting.
I removed the '_' splitting of long labels from the index when testing
and this puts it back.
2018-08-21 13:55:03 +10:00
Chris Johns
5ce8e43506 build: Fix indexing so it works on HTML and PDF.
- Remove all genindex.rst files, these are generated and should not
  exist in our source.
- Fix the HTML templates so the local specialisation works.
- Add a index link to the sidebar for HTML.

Note, there is no TOC entry for the index in the PDF output and I
cannot figure out how to add one.

Closes #3503
2018-08-21 13:47:40 +10:00
Richard Campbell
2a0664402b RTEMS Docs: Check sphinx version
Sphinx.util.compat module was removed at Sphinx version 1.7.
Imported module was not being used.

Closes #3311.
2018-03-09 13:28:45 -06:00
Chris Johns
8e8094abc8 build: Add extra source to the sphinx build.
Updates #3177.
2017-10-12 20:25:20 -05:00
Chris Johns
5c3683e900 Improve the line spaces for directives and notes. 2017-09-14 21:50:35 +10:00
Sebastian Huber
5fc9f8bc42 common: Remove obsolete latex_use_parts
This configuration is obsolete and no longer documented:

http://www.sphinx-doc.org/en/stable/config.html#options-for-latex-output

The use of parts at the top-level results in ugly documents.
2017-08-25 14:28:27 +02:00
Chris Johns
feb68323b7 coverpage: Fix repeated entries.
Closes #2865.
2017-08-11 13:45:57 +10:00
Chris Johns
efc29ff31b Update copyright notices. 2017-08-11 13:45:52 +10:00
Chris Johns
c68461134e pdf: Update the RTEMS style to work recent Sphinx versions. 2017-08-11 13:45:47 +10:00
Chris Johns
7464b71b59 common/conf: Clean up. 2017-08-11 13:45:41 +10:00
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