- FreeBSD Architecture Handbook, which is a book about the FreeBSD
architecture. The SMP article have also been moved into the new
arch handbook as a separate chapter.
- FreeBSD Developers Handbook, which is a book about developing on
FreeBSD; basically what was left when the architecture parts was
moved away.
o Hook up the new FreeBSD Architecture Handbook to the build.
o Remove the SMP article since it is now part of the FreeBSD
Architecture Handbook.
The relevant files from the FreeBSD Developers Handbook have been
repository copied to the new FreeBSD Architecture Handbook.
This is just step one in the split, both books need some work to be
real seperate books. E.g. the FreeBSD Architecture Handbook still
needs an introduction.
Repository copy by: joe
Requested by: rwatson
Approved by: murray, ceri (mentor)
enable it in en_US.ISO8859-1/ and ja_JP.eucJP/.
- Add PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN"
and l10n.ent for entity localization.
- Use share/misc/docbook.css for indentiation of <programlisting>
and <screen>.
- Add some missing $FreeBSD$.
share/images. To link "generic" images (share/images ones) from
Makefiles use IMAGES_EN and to link localized images use IMAGES.
For an example look at en_US.ISO8859-1/books/handbook/Makefile
kernel access control.
Document the kernel side of the MAC policy architecture. This
is a little out of date at the moment. Some parts to be filled
in as things are developed, and much is subject to change. It
will, however, give developers a good idea of how things work.
Obtained from: TrustedBSD Project
Sponsored by: DARPA, NAI Labs
have by far made the most commits to this document, and I have some
ideas about splitting out the kernel content into a seperate book.
The scope of this document is too large.
* Add a new document-specific variable, HAS_INDEX, to specify if a
given document is marked up with <indexterm> entries.
* Rework the index support so that both HAS_INDEX and GEN_INDEX are
checked before trying to generate an index for a document.
* Only create index.sgml if both HAS_INDEX and GEN_INDEX are set.
This allows us to recursively build the documentation tree with
GEN_INDEX=1 and have it only try to create an index (very time
consuming) for the few documents that are ready for this. Previously,
running "make GEN_INDEX=1" from the top of the doc tree would look for
index terms in every single document.
With this, I hope we can start building our docs with GEN_INDEX set on
freefall so that users browsing the HTML docs will get the benefit of
the index we've been hiding in CVS for 6 months.
* Add chapter on kernel debugging (repo-copied from the Handbook)
* Change "Introduction" part with 4 empty chapters to a
"Introduction" chapter with 4 mostly empty <sect1>s.
* Combine many of the different <part>s that contain only one empty
<chapter> into larger <part>s.
* Add * in front of unfinished chapter names so its very clear what
needs to be worked on.
* Added some <filename> tags where appropriate.