Skip site navigation (1) Skip section navigation (2)

FreeBSD Documentation Project: Handbook 3rd Edition

FreeBSD Handbook 3rd Edition

The 3rd Edition FreeBSD Handbook will be published in two volumes, each over 400 pages. Volume I (User Guide) will cover the basics, while Volume II (Administrator's Guide) will cover system administration and more advanced topics.

If you would like to get involved with the production of this edition, please send email to the -doc mailing list. Thanks!

Task Responsible Last updated Status
Create new callout images for the numbers 1 - 25 as the default images with the DocBook stylesheets only go from 1-9 and then fall back on text numbers. This looks bad when we have more than 9 callouts in the text, such as the Security Advisories section of the Security chapter. Update: Numbers up to 15 added from DocBook CVS. Murray Stokely July 12, 2004 Done
Rewrite firewall section to cover pf, ipf and ipfw. Tom Rhodes July 22, 2004 In Progress
Write a proper synopsis for the Vinum chapter. Ceri Davies, via a patch from Kevin Kinsey July 29, 2004 Done
Advanced Network Chapter is almost 100 pages and should be split up. Update: new Network Servers chapter split off separately. Murray Stokely July 13, 2004 Done
Review recently added HTTP Server section. -- July 20, 2004 Not Started
Review recently added FTP Server section. -- July 20, 2004 Not Started
Add information about setting up a secure web server to the Apache section. Generating the certificate, getting the certificate signed, etc.. Murray Stokely July 20, 2004 Not Started
Add a section about running a Windows file server with Samba to Network Servers chapter. -- July 20, 2004 Not Started
Update the DHCP section of the Network Servers chapter to describe omshell and recent DHCP 3.X features now in the base system. UPDATE: omshell is pretty technical and I don't think we really need to get into it in the Handbook? Thoughts? -- July 13, 2004 In Progress
Information about running an FTP server should be added to the Network Servers chapter. Murray Stokely July 21, 2004 Done
Add a type attribute to localhost URLs so that these can be omitted from the printed output. Murray Stokely May 18, 2003 Done
Add <colspecs> to tables as necessary to enhance the print output. Murray Stokely May 18, 2003 In Progress
Remove all ASCII artwork Murray Stokely May 18, 2003 Done
Update chapter on using modern versions of GNOME Joe Marcus Clarke May 18, 2003 Done
Fix cross-referencing tags to look better in the print output. Murray Stokely May 18, 2003 In Progress
Standardize spelling of technical terms Tom Rhodes May 18, 2003 In Progress
Make sure all filenames, commands, applications, hostnames, etc are marked up properly Marc Fonvieille May 18, 2003 In Progress
Update appendix of contributing authors. Chern Lee July 20, 2004 In Progress
Update PPP/SLIP chapter Tom Rhodes May 18, 2003 Done
Clean up the IPSec section Hiten Pandya, Chern Lee October 26, 2003 Done
Add simple illustrations at the beginning of each Part.   May 18, 2003 Not Started
Add admonition graphics for Note, Caution, Warning, Tip. Hiroki Sato May 18, 2003 In Progress
Design the cover. Ben Hansen July 20, 2004 Done
Update content in introduction chapter for post 5.0 world.   May 18, 2003 Not Started
Make front matter look better Murray Stokely May 18, 2003 Done
Review the book for grammatical errors. Everyone! May 18, 2003 In Progress
Implement automated spellchecker for entire Handbook. Chern wrote some Tcl scripts and posted them to doc@ around the time of the second edition work. This could be a starting point.   May 18, 2003 Not Started
Make sure all section titles are capitalized properly Ceri Davies May 18, 2003 Done
Remove gratuitous Q/A sections in favor of more formal text. (see the end of the ports/packages chapter) Tom Rhodes May 18, 2003 In Progress
Add more information about ACPI. Tom Rhodes and Nate Lawson May 18, 2003 Done
Add information about Kerberos5 and adjust Kerberos4 information accordingly. Tom Rhodes May 18, 2003 Done
Update Preface. Murray Stokely July 20, 2004 In Progress
Update bibliography with newer editions, etc.   May 18, 2003 Not Started
Add more indexterms throughout the book. Reorganize some existing indexterms. See the "make indexcheck" functionality for help finding areas of the book where indexterms are sparse.   May 18, 2003 Not Started
Write an introduction for the Serial Communications chapter (note the big "XXX - Write me!" comment). The current Synopsis can probably be adapted for this.   May 19, 2003 Not Started
The Mini-Cartridge section in the disks chapter still needs to be written. Update: section removed. Murray Stokely July 20, 2004 Done
Add information about network configuration to the install chapter. Tom Rhodes May 18, 2003 Done
Add some documentation on cron(8). Tom Rhodes May 18, 2003 Done
Fill undefined glossary terms. Everyone! August 16, 2004 Not Started
Send everything to the printer. Murray Stokely   Not Started