106 Commits

Author SHA1 Message Date
Amar Takhar
ed3794ea39 Add 'waf linkcheck' to check external references. 2016-05-02 20:51:25 -04:00
Amar Takhar
9b495a2980 Remove incorrect pdflatex/makeindex check. 2016-05-02 20:51:25 -04:00
Amar Takhar
7c1f2154d6 Only require makeindex and pdflatex when trying to build PDF. 2016-05-02 20:51:25 -04:00
Amar Takhar
a316b1ff6d Add support for singlehtml (inlined) HTML file, plus some other fixes.
* This is still broken.
  * Rename sphinx_rtd_theme so it doesn't pickup locally installed ones
  * Add a hack to theme.css to get around inliner bug.
  * Some unrelated fixups in common/waf.py

Unfortunatly several dozen fixes got merged into this.
2016-05-02 20:51:25 -04:00
Amar Takhar
89f234787e Fix typo and add another dependency. 2016-05-02 20:51:24 -04:00
Amar Takhar
14bbcb1ea9 Add minimum version check for Sphinx.
Some distributions have ancient versions we require at least 1.3.
2016-05-02 20:51:24 -04:00
Amar Takhar
9b5801a6e6 Add PDF generation support use with --pdf 2016-05-02 20:51:24 -04:00
Amar Takhar
0abc59dffc Add .svg logos for RTEMS that I made myself.
One is plain SVG the other has the Inkscape metadata in it.
2016-05-02 20:51:24 -04:00
Amar Takhar
2643223689 Add logo.pdf for PDF documents. 2016-05-02 20:51:24 -04:00
Amar Takhar
b99044088c Add missed conf.py.
No idea how this happened.
2016-05-02 20:51:24 -04:00
Chris Johns
4f81ff1700 Clean up of file and directory commands. 2016-05-02 20:51:24 -04:00
Amar Takhar
f916fcaaae Add support for spellchecking with a custom dictionary.
To use:

  1. Install aspell
  2. waf spell <list of files>
     * waf spell mydoc.rst
     * waf spell *.rst

This uses a custom dictionary stored in common/spell/dict/.  We should add all
RTEMS and programming terms to this to ensure we are consistent.

Amar.
2016-05-02 20:51:24 -04:00
Amar Takhar
d389819eea Convert all Unicode to ASCII(128) 2016-05-02 20:51:24 -04:00
Amar Takhar
11e1a6f969 Remove ada_user document.
We are going to make Ada a chapter in the c_user manual to simplify things.
Talked it over with Joel the differences between ada_user and c_users are a lot
smaller than they used to be.

A simple few page chapter will be enough for anyone to know the differences and
will be a lot easier to maintain.
2016-05-02 20:51:24 -04:00
Amar Takhar
3a717592a9 Rework how conf.py is handled.
Needed to switch due to increasing complexity.
2016-05-02 20:51:24 -04:00
Amar Takhar
46498bd4e3 Fix rtemsconfig building.
I'll probably move to a more pythonic way of doing conf.py since this is getting
too complicated.
2016-05-02 20:51:24 -04:00
Amar Takhar
6c6246cace Delete new_chapters document as it is rarely used.
Joel says this was a template used to generate a shell when adding a set of
related APIs.  It was written in 1997 and a good portion is untouched.

If we need this functionality in the new docs we can write something much nicer
using Python to generate the proper reST documentation.
2016-05-02 20:51:24 -04:00
Amar Takhar
d94936ab0b Remove relnotes are per Joel -- it has no use anymore.
It is severely out of date we will write new information elsewhere.  Plus the
new website has a lot of similar info.
2016-05-02 20:51:24 -04:00
Amar Takhar
bbf2836248 Rename old document for reference only. 2016-05-02 20:51:24 -04:00
Amar Takhar
fd6dc8c8de Split document into seperate files by section. 2016-05-02 20:51:24 -04:00
Amar Takhar
1a1be7f456 Fix markup. 2016-05-02 20:51:23 -04:00
Amar Takhar
4783b0d0e4 Split document into seperate files by section. 2016-05-02 20:51:23 -04:00
Amar Takhar
8d87f4dc3b Fix markup. 2016-05-02 20:51:23 -04:00
Amar Takhar
7d8260a9e6 Rename old document for reference only. 2016-05-02 20:51:23 -04:00
Amar Takhar
1264a8f108 Split document into seperate files by section. 2016-05-02 20:51:23 -04:00
Amar Takhar
ec76eca9cc Fix warnings. 2016-05-02 20:51:23 -04:00
Amar Takhar
548f844b3c Rename old document for reference only. 2016-05-02 20:51:23 -04:00
Amar Takhar
b350509172 Split document into seperate files by section. 2016-05-02 20:51:23 -04:00
Amar Takhar
499c09f36e Fix warnings. 2016-05-02 20:51:23 -04:00
Chris Johns
a6b837e9b5 Clean up of general commands. 2016-05-02 20:51:23 -04:00
Amar Takhar
3c29186a50 Rename old document for reference only. 2016-05-02 20:51:23 -04:00
Amar Takhar
d755cbd36f Split document into seperate files by section. 2016-05-02 20:51:23 -04:00
Amar Takhar
c0e0c96ba5 Fix warnings. 2016-05-02 20:51:23 -04:00
Amar Takhar
ef0a063a84 Split document into seperate files by section. 2016-05-02 20:51:23 -04:00
Amar Takhar
7a758c222e Fix warnings. 2016-05-02 20:51:23 -04:00
Amar Takhar
735de5fe51 Move preface/intro one level up so the section is unnumbered. 2016-05-02 20:51:23 -04:00
Amar Takhar
0aa6200eff Rename old document for reference only. 2016-05-02 20:51:23 -04:00
Amar Takhar
6733466adf Split document into seperate files by section. 2016-05-02 20:51:23 -04:00
Amar Takhar
7526578599 Fix markup 2016-05-02 20:51:23 -04:00
Amar Takhar
ca49bfd73b Split document. 2016-05-02 20:51:23 -04:00
Amar Takhar
d01deadf09 Fix markup 2016-05-02 20:51:23 -04:00
Amar Takhar
75a59fd663 Fix images. 2016-05-02 20:51:23 -04:00
Chris Johns
62d03a1324 Clean up config and init. 2016-05-02 20:51:22 -04:00
Amar Takhar
8ca13ed19f Split document. 2016-05-02 20:51:22 -04:00
Chris Johns
e1797c0eb0 Clean up the alias command. 2016-05-02 20:51:22 -04:00
Chris Johns
1d83077e49 Cleaned up to General Commands. 2016-05-02 20:51:22 -04:00
Amar Takhar
c0d6eff67d Split document. 2016-05-02 20:51:22 -04:00
Amar Takhar
11d2a74dae Fix warnings. 2016-05-02 20:51:22 -04:00
Amar Takhar
14d532bb65 Fix section numbering, create TOC, seperate preface. 2016-05-02 20:51:22 -04:00
Amar Takhar
aa3dcf4eb2 Rename old document for reference only. 2016-05-02 20:51:22 -04:00