and I may have missed some SGML-ification, but let's give more
visibility to the chapter, so others can help me improve it too.
PR: docs/94419
Submitted by: Daniel Gerzo <danger@rulez.sk>
Audit - not hooked up to the build, but provided for when the audit framework
becomes available in the base system.
GEOM - Incomplete, only covers striping and mirroring since that is all I
have tested. Incomplete is better than nothing in my opinion. This one is
hooked up to the build.
new chapter all its own, currently in the 'network communications'
part as chapter 24.
Add a small paragraph at the bottom of the security chapter synopsis
noting that additional security topics are covered in the MAC chapter
and the Firewall chapter.
While here add some missing punctuation, cleanup the whitespace, add
missing </para> tags, add a synopsis, and of course
s/<sectN/<sectN-1/.
or ideas submitted to the trustedbsd-discuss mailing list by 'User Bugghy'
and from his mini-walkthrough.
Reviewed by: -doc, TrustedBSD-discuss, rwatson
- add doc.common.mk, which defines variables, targets, and
dependencies commonly used in www/ and doc/.
- move www/<lang>/includes.xsl to the language independent
directory and split into several files.
- add transtable*.xsl and transtable.xml to support localized
mirror names.
- make doc/{en_US.ISO8859-1,ja_JP.eucJP}/books/handbook/ use
mirrors.xml (mirrors and eresources).
- make www/{en,ja}/index.xsl use mirrors.xml.
For details, please see doc/share/sgml/README.mirrors for the moment.
Reviewed by: simon and Alex Dupre <sysadmin@alexdupre.com>
repo-copy from sound). This is based on the old sound chapter, but
includes video and other multimedia related bits. More will be added to
it shortly and various parts will be cleaned up, but I wanted to get
this in the tree before I do anything else to it.
The sound chapter has been removed from the build, but I haven't cvs
rm'd it yet (though I will in about 24 hrs time).
Mostly submitted by: Ross Lippert <ripper@eskimo.com>
moving to a separate article. This chapter is not appropriate for the
current handbook, it will stick out even more as we split the handbook
into smaller books, and a separate article is more conducive to being
linked from the navigation bar on the main page just like the OpenBSD
and NetBSD web sites.
"Contributors List" article.
Remove the list of contributors from the "Contributing to FreeBSD"
chapter.
Remove the "High Priority Tasks" and "Medium Priority Tasks" from the
"Contributing to FreeBSD" chapter since this destined to always be
hopelessly out of date. Keep the information about what we always
need.
sections have been moved off into separate tutorials and "Jordan's
picks" of Pentium-class motherboards will just have to be missed ;)
The Handbook is now "only" 681 pages (without the index turned on).
section of the Handbook.
Submitted by: Chern Lee <chern.lee@windriver.com>
Obtained from: Mike Smith's configuration tutorial, and
tuning(7) by Matt Dillon
tags LINUXDOC_2_DOCBOOK_START and LINUXDOC_2_DOCBOOK from doc/handbook/.
Note that the LINUXDOC_2_DOCBOOK tag is not necessarily at the HEAD of
the file. So some files won't show changes because changes were applied
after I laid down the LINUXDOC_2_DOCBOOK tag.
Not everything was merged. In some cases, URLs had been shortened;
http://www.freebsd.org/docproj/
becomes
../docproj/
This is a mistake, since users browsing the Handbook on their own machine
can't be expected to have links like this work. Of course, for mirrors,
they'll end up pointing back to the main site. For the mean time, do
nothing -- this will need an entity defined to reference the base URL
of the FreeBSD site, individual mirrors can set this as necessary.
Notice how some files (on the left) are merged to the same file (on
the right). This is because the new Handbook file structure is organised
on DocBook chapter lines.
Files with no revision number in the "From" column didn't exist when I
started the conversion.
File From -> To Merged to files...
---------------------------------------------------------------
anoncvs.sgml -> 1.1 cutting-edge/chapter.sgml
authors.sgml 1.93 -> 1.118 authors.ent
backups.sgml -> 1.4 backups/chapter.sgml
bibliography.sgml 1.33 -> 1.37 bibliography/chapter.sgml
contrib.sgml 1.274 -> 1.312 staff/chapter.sgml
ctm.sgml 1.22 -> 1.23 cutting-edge/chapter.sgml
cvsup.sgml 1.36 -> 1.40 cutting-edge/chapter.sgml
disks.sgml -> 1.3 disks/chapter.sgml
eresources.sgml 1.39 -> 1.50 eresources/chapter.sgml
firewalls.sgml 1.19 -> 1.20 security/chapter.sgml
handbook.sgml 1.83 -> 1.91 handbook.sgml
history.sgml 1.24 -> 1.25 introduction/chapter.sgml
install.sgml 1.65 -> 1.67 install/chapter.sgml
isdn.sgml 1.12 -> 1.15 advanced-networking/chapter.sgml
kerberos.sgml 1.12 -> 1.13 security/chapter.sgml
kernelconfig.sgml 1.31 -> 1.32 kernelconfig/chapter.sgml
kerneldebug.sgml 1.17 -> 1.19 kerneldebug/chapter.sgml
linuxemu.sgml 1.22 -> 1.24 linuxemu/chapter.sgml
memoryuse.sgml 1.11 -> 1.12 internals/chapter.sgml
mirrors.sgml 1.80 -> 1.92 mirrors/chapter.sgml
nutshell.sgml 1.14 -> 1.15 introduction/chapter.sgml
pgpkeys.sgml 1.25 -> 1.28 pgpkeys/chapter.sgml
policies.sgml 1.16 -> 1.18 policies/chapter.sgml
porting.sgml 1.93 -> 1.112 contrib/chapter.sgml
ports.sgml 1.29 -> 1.31 ports/chapter.sgml
printing.sgml 1.21 -> 1.22 printing/chapter.sgml
relnotes.sgml 1.24 -> 1.28 introduction/chapter.sgml [1]
submitters.sgml 1.161 -> 1.246 contrib/chapter.sgml
synching.sgml 1.12 -> 1.13 cutting-edge/chapter.sgml
userppp.sgml 1.28 -> 1.30 ppp-and-slip/chapter.sgml
[1] A chunk of relnotes.sgml is in an IGNORED marked section. Why?
Submitted by: A bunch (~ 50%) of merging done by Charles A. Wimmer
(cawimm@FreeBSD.ORG), rest by Nik.
chapter.sgml in a directory named according to the value the id
attribute on that chapter.
Added chapters.ent, which lists the entities for each chapter.
Updated handbook.sgml to use these entities.