History log of /seL4-refos-master/kernel/manual/Makefile
Revision Date Author Comments
# 79da0792 01-Mar-2020 Gerwin Klein <gerwin.klein@data61.csiro.au>

Convert license tags to SPDX identifiers

This commit also converts our own copyright headers to directly use
SPDX, but leaves all other copyright header intact, only adding the
SPDX ident. As far as possible this commit also merges multiple
Data61 copyright statements/headers into one for consistency.


# 554f812d 08-Nov-2016 Anna Lyons <Anna.Lyons@data61.csiro.au>

mcs: scheduling context donation over ipc

After this commit, threads blocked on an endpoint can recieve a
scheduling context from the thread that wakes the blocked thread.


# bc61a7f3 24-Jun-2019 Anna Lyons <anna@gh.st>

python2 --> python3

Update all scripts and build system to call python3, given python2's
upcoming doom. Use sys.maxsize instead of sys.maxint in one script
(maxint does not exist in python3).


# 63c5ac6d 09-May-2018 Anna Lyons <Anna.Lyons@data61.csiro.au>

manual: use level 3 for syscalls

As syscalls are not part of an inner group, which bumps the level,
they need to start at 3 not 2


# deba85b2 09-May-2018 Anna Lyons <Anna.Lyons@data61.csiro.au>

manual: promote sel4_arch API docs level

This change makes sel4_arch api docs the same level as the base arch api docs. This is because the
header level became too deep for latex section types, and there is not much advantage to such deep
hierarchies.


# da1e73fe 09-May-2018 Anna Lyons <Anna.Lyons@data61.csiro.au>

manual: use int level in parse_doxygen_xml.py

The level argument to parse_doxygen_xml.py was previously a latex section header (either subsection
or subsubsection). This change converts the argument to numerical which is more robust and is not
limited to 2 specific levels.

This change
- alters the level argument to be an int, where 0 = highest level header,
- removes the translation of latex header to markdown,
- adds a new 'level_to_header' function to the generator class, which translates the level number
to a header for that specific output type.


# 65012ae4 30-Apr-2018 Adam Felizzi <a.felizzi@student.unsw.edu.au>

manual: Markdown generation rule in Makefile

Added support to generate the libsel4 api in markdown within the
manual Makefile.


# aae12426 05-Apr-2018 Anna Lyons <Anna.Lyons@data61.csiro.au>

riscv: document API methods


# 567127de 06-Sep-2017 Adrian Danis <Adrian.Danis@data61.csiro.au>

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.


# 0504785f 24-May-2017 Stephen Sherratt <Stephen.Sherratt@data61.csiro.au>

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.


# 324d973d 24-May-2017 Stephen Sherratt <Stephen.Sherratt@data61.csiro.au>

manual: Suppress verbose output when building


# 32af5422 24-May-2017 Stephen Sherratt <Stephen.Sherratt@data61.csiro.au>

manual: Docs for debugg and benchmark syscalls


# 3180e8ab 23-May-2017 Stephen Sherratt <Stephen.Sherratt@data61.csiro.au>

manual: Validate interface files against dtd


# 9f891ab7 23-May-2017 Stephen Sherratt <Stephen.Sherratt@data61.csiro.au>

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.


# ca8c1577 28-Nov-2016 Stephen Sherratt <Stephen.Sherratt@data61.csiro.au>

manual: Generating tex from obj inv header

JIRA: SELFOUR-606


# cbfef30c 28-Nov-2016 Stephen Sherratt <Stephen.Sherratt@data61.csiro.au>

manual: More verbose Makefile printouts

JIRA: SELFOUR-606


# ed053d6d 28-Nov-2016 Stephen Sherratt <Stephen.Sherratt@data61.csiro.au>

manual: Suppressing doxygen warnings

JIRA: SELFOUR-606


# 28d0d334 28-Nov-2016 Stephen Sherratt <Stephen.Sherratt@data61.csiro.au>

manual: Tex filenames derived from doxy filenames

Rather than having a custom naming convention for generated latex files,
we use names based on the names given to xml files generated by doxygen,
which in turn take their names from groups defined in doxygen comments
in various header files.

JIRA: SELFOUR-606


# c464470d 13-Sep-2016 Stephen Sherratt <Stephen.Sherratt@data61.csiro.au>

Syscalls docs in manual generated by doxygen

This adds a dummy header with syscall prototypes with doxygen comments.
The build process for the manual includes parsing these comments using
doxygen. Doxygen produces an xml file which is parsed by a script to
generate latex which is included in the manual. This approach was chosen
over doxygen's native latex output to gain greater control over the
formatting of the generated documentation, and to take advantage of
existing api-formatting support in the sel4 manual.

Related issue: SELFOUR-606


# 91b7da86 17-Jul-2014 TrusthworthySystems <gatekeeper@sel4.systems>

Release snapshot