Bruce Mitchener
b942a50441
Fix trivial comment typos.
2018-03-27 10:51:26 +11:00
Anna Lyons
05b83acd95
SELFOUR-1016: Require auth cap to set prio/mcp
...
This fixes confused deputy problem when setting priorities/mcps.
2018-02-26 11:24:22 +11:00
Kofi Doku Atuah
8e7f9fbbab
Manual: Correction of the name of the Zynq board
2018-02-08 15:13:11 +11:00
Kofi Doku Atuah
e2c7814017
PR: Clarify which ODROID machine
2018-02-08 14:11:59 +11:00
Kofi Doku Atuah
6062e0dac1
CAMKES-637: Manual: Hardware debug API: Document supported platforms
...
These are the platforms on which seL4test is able to successfully execute the
breakpoint tests.
2018-02-07 15:20:40 +11:00
Hesham Almatary
a66feddb8c
Manual: Delete a sentence that's not valid anymore
2017-10-24 15:09:16 +11:00
Adrian Danis
567127defe
manual: Expand parts of the x86 virtualisation documentation
...
This provides documentation for kernel design of the x86 virtualisation, the additional
syscall and object invocations. The ARM design is not fully expanded.
2017-09-18 14:01:46 +10:00
Kent McLeod
76dd101fe1
manual: fix python script to be python3 compatible
2017-09-18 11:28:33 +10:00
Hesham Almatary
c1851e3f1c
Manual: vspace.tex - document cache operations on page directories
2017-08-09 10:01:00 +10:00
Kent McLeod
d3e90341d6
manual: remove some unused tex commands
2017-06-29 12:06:39 +10:00
Kent McLeod
8e3598bdcf
SELFOUR-912: migrate ARM docs from latex to xml
2017-06-29 12:06:39 +10:00
Anna Lyons
2a52a3f7c7
manual: remove some unused tex commands
2017-06-28 11:47:02 +10:00
Anna Lyons
422118c3e6
SELFOUR-913: migrate x86 docs from latex to xml
2017-06-28 11:47:00 +10:00
Anna Lyons
192a4162ee
manual: allow non sec autorefs
...
Previously anything in an autoref block was assumed to reference
a section, which isn't true. Change 'sec' to 'label' and move the
'sec' prefix into the label itself.
2017-06-27 16:22:34 +10:00
Anna Lyons
40c61e5c18
Fix licenses (the rest)
2017-06-22 15:29:12 +10:00
Anna Lyons
adb7916041
manual: fix double escaping bug
2017-06-20 10:22:59 +10:00
Anna Lyons
cd9e1c9a39
manual: support for itemized lists
2017-06-19 14:43:54 +10:00
Anna Lyons
93d2ed6a77
manual: fix script licenses
2017-06-19 13:59:08 +10:00
Anna Lyons
4d7c272ba7
manual: appease pylint
2017-06-19 13:59:08 +10:00
Anna Lyons
b1ef79e32f
manual: refactor + cleanup parse_doxygen_xml.py
...
- use 'recursive=False' rather than 'content' to only search children
- use a parse table instead of if a long if/else
- fix nested lists
- use get_text from beautiful_soup rather than home brewed
- don't call latex_escape explicitly
2017-06-19 13:59:08 +10:00
Anna Lyons
10801bd891
SELFOUR-962: allow API level description in manual
2017-06-19 13:59:08 +10:00
Anna Lyons
c6056ecbe9
SELFOUR-961: allow lists in API docs
...
this change
- converts ordered doxygen lists to enumerate
- also wraps the benchmark config names in texttt
2017-06-19 13:59:08 +10:00
Anna Lyons
6b69024674
manual: use BeautifulSoup in parse_doxygen_xml
...
Use BeautifulSoup instead of minidom, for more powerful features
2017-06-19 13:59:08 +10:00
Stephen Sherratt
8db82c2065
manual: Correct manual label for X86_Page_MapIO
2017-06-02 16:34:49 +10:00
Stephen Sherratt
e5c0d63c71
manual: Explicitly say TODO where doc is missing
2017-06-02 15:34:45 +10:00
Stephen Sherratt
0504785f98
manual: Variable for python interpreter
...
This allows the manual to be built with `PYTHON=mypython make`, to
invoke the python scripts involved in generating documentation with a
particular version of python. The scripts are compatible with both
python2 and python3, but this should simplify debugging if this ever
stops being the case. If no value of PYTHON is specified, the default
value of "python" is used.
2017-06-02 15:34:45 +10:00
Stephen Sherratt
e29b1e8fb0
manual: Docstrings for gen_invocations script
2017-06-02 15:34:45 +10:00
Stephen Sherratt
aee7a3cbc8
manual: Remove unused import
2017-06-02 15:34:45 +10:00
Stephen Sherratt
7ee77f2933
manual: Comments to docstrings
2017-06-02 15:34:45 +10:00
Stephen Sherratt
324d973dc1
manual: Suppress verbose output when building
2017-06-02 15:34:45 +10:00
Stephen Sherratt
748f571855
manual: Include prototypes for undocumented fns
2017-06-02 15:34:45 +10:00
Stephen Sherratt
fee7c9bd0d
manual: More robust hanlding of xml errors
...
When generating latex from doxygen-generated xml, if an expected element
is not found in the xml, raise a meaningful exception.
2017-06-02 15:34:45 +10:00
Stephen Sherratt
d8e6a00115
manual: Improve handling of return type docs
...
If no documentation is provided for the return value of a function, the
documentation generator will attempt to infer the documentation based on
the return type.
2017-06-02 15:34:45 +10:00
Stephen Sherratt
32af54221f
manual: Docs for debugg and benchmark syscalls
2017-06-02 15:34:45 +10:00
Stephen Sherratt
c4500519a5
manual: Less fragile handling of arch types
2017-06-02 15:34:45 +10:00
Stephen Sherratt
5cf5b16594
manual: Correct ia32 to x86 in some sections
2017-06-02 15:34:45 +10:00
Stephen Sherratt
3f2f66de2a
manual: Use generated api docs in manual
2017-06-02 15:34:45 +10:00
Stephen Sherratt
e426676c63
manual: Handle case where api has no methods
2017-06-02 15:34:45 +10:00
Stephen Sherratt
3180e8ab53
manual: Validate interface files against dtd
2017-06-02 15:34:45 +10:00
Stephen Sherratt
9f891ab7df
manual: Generate sections for arch-specific calls
...
This just creates the sections with appropriate names and function
prototypes, with no textual description of what the functions do.
2017-06-02 15:34:45 +10:00
Stephen Sherratt
58cbddecff
manual: Parameterize \apidoc cmd with section type
2017-06-02 15:34:45 +10:00
Stephen Sherratt
ef74899681
manual: Docstring for gen_invocations stript
2017-05-23 16:27:09 +10:00
Stephen Sherratt
b2c84ed806
manual: Build system compatible with python3
2017-05-23 16:27:01 +10:00
Adrian Danis
133883c004
manual: Correct underscore
2017-05-22 14:32:06 +10:00
Corey Richardson
95be1939d3
manual: clarify that extraLen is in bytes
2017-05-18 13:32:21 -04:00
Corey Richardson
c0667b48a6
Fix note about numIOPTLevels
2017-05-18 13:30:02 -04:00
Adrian Danis
ddc58f3f82
manual: document bootinfo register
2017-03-08 09:25:47 +11:00
Adrian Danis
099b45074f
libsel4: Deprecate bootinfo management
2017-03-08 09:25:47 +11:00
Adrian Danis
7836f76cf9
Extend bootinfo to support potentially arbitrary additional structures
...
This provides a future proof interface for extending the bootinfo region with additional
kinds of optional architecture and platform specific information. The basic idea is to
report the size of a region directly following the bootinfo frame, which is made up of
a series of 'chunks'. Each chunk has an identifier (describing what it is) and a length,
allowing unknown chunks to be skipped in favor of examining the remaining of the chunks.
2017-02-16 14:34:52 +11:00
Adrian Danis
1ec4128baa
manual: Brief description of ARM ioSpaceCaps
2017-02-16 11:37:45 +11:00