this was that 'SGMLFLAGS' had to be changed to 'XMLFLAGS' in
share/mk/doc.docbook.mk so that everything continued to build OK.
Approved by: gabor (mentor)
is no longer valid, however there could be added a new chapter on
busdma [1] instead of this one
[1] http://www.freebsd.org/projects/busdma/
PR: docs/126146
Discussed with: jhb
Submitted by: gavin
Approved by: gabor (mentor)
is not defined.
- URL_RELPREFIX must always point the top page's URL
(http://www.FreeBSD.org) in relative form, defined in Makefile.
- &url.base; can be used in doc/<langcode>/*. It will be
replaced with the real URL which points the top page.
For translators: Please make sure to define URL_RELPREFIX to
point the top page. The localized docs have different directory
hierarchy in its URL from the English version.
Tested by: den
At the moment the main content is the Micro Benchmark Checklist posted
to -current by phk and expanded by rwatson. The list did not really fit
in any of the current chapters, so a new chapter was created. I hope
others can add more content to this chapter later.
Content by: phk, rwatson
Reviewed by: phk, josef
No objections: -doc
- 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.
