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. | -&a.murray; | -July 12, 2004 | -&done; | -
| Rewrite firewall section to cover pf, ipf and ipfw. | -&a.trhodes; | -July 22, 2004 | -&inprogress; | -
| Write a proper synopsis for the Vinum chapter. | -&a.ceri;, 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. | -&a.murray; | -July 13, 2004 | -&done; | -
| Review recently added HTTP Server section. | --- | -July 20, 2004 | -¬started; | -
| Review recently added FTP Server section. | --- | -July 20, 2004 | -¬started; | -
| Add information about setting up a secure web server to the - Apache section. Generating the certificate, getting the - certificate signed, etc.. | -&a.murray; | -July 20, 2004 | -¬started; | -
| Add a section about running a Windows file server with Samba to Network Servers chapter. | --- | -July 20, 2004 | -¬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 | -&inprogress; | -
| Information about running an FTP server should be added to the Network Servers chapter. | -&a.murray; | -July 21, 2004 | -&done; | -
| Add a type attribute to localhost URLs so that these can be - omitted from the printed output. | -&a.murray; | -May 18, 2003 | -&done; | -
| Add <colspecs> to tables as necessary to enhance the print output. | -&a.murray; | -May 18, 2003 | -&inprogress; | -
| Remove all ASCII artwork | -&a.murray; | -May 18, 2003 | -&done; | -
| Update chapter on using modern versions of GNOME | -&a.marcus; | -May 18, 2003 | -&done; | -
| Fix cross-referencing tags to look better in the print - output. | -&a.murray; | -May 18, 2003 | -&inprogress; | -
| Standardize spelling of technical terms | -&a.trhodes; | -May 18, 2003 | -&inprogress; | -
| Make sure all filenames, commands, applications, hostnames, etc - are marked up properly | -&a.blackend; | -May 18, 2003 | -&inprogress; | -
| Update appendix of contributing authors. | -&a.chern; | -July 20, 2004 | -&inprogress; | -
| Update PPP/SLIP chapter | -&a.trhodes; | -May 18, 2003 | -&done; | -
| Clean up the IPSec section | -&a.hmp;, &a.chern; | -October 26, 2003 | -&done; | -
| Add simple illustrations at the beginning of each Part. | -- | May 18, 2003 | -¬started; | -
| Add admonition graphics for Note, Caution, Warning, Tip. | -&a.hrs; | -May 18, 2003 | -&inprogress; | -
| Design the cover. | -Ben Hansen | -July 20, 2004 | -&done; | -
| Update content in introduction chapter for post 5.0 world. | -- | May 18, 2003 | -¬started; | -
| Make front matter look better | -&a.murray; | -May 18, 2003 | -&done; | -
| Review the book for grammatical errors. | -Everyone! | -May 18, 2003 | -&inprogress; | -
| 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 | -¬started; | -
| Make sure all section titles are capitalized properly | -&a.ceri; | -May 18, 2003 | -&done; | -
| Remove gratuitous Q/A sections in favor of more formal - text. (see the end of the ports/packages chapter) | -&a.trhodes; | -May 18, 2003 | -&inprogress; | -
| Add more information about ACPI. | -&a.trhodes; and &a.njl; | -May 18, 2003 | -&done; | -
| Add information about Kerberos5 and adjust Kerberos4 information - accordingly. | -&a.trhodes; | -May 18, 2003 | -&done; | -
| Update Preface. | -&a.murray; | -July 20, 2004 | -&inprogress; | -
| Update bibliography with newer editions, etc. | -- | May 18, 2003 | -¬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 | -¬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 | -¬started; | -
| The Mini-Cartridge section in the disks chapter still needs to - be written. Update: section removed. | -&a.murray; | -July 20, 2004 | -&done; | -
| Add information about network configuration to the install chapter. | -&a.trhodes; | -May 18, 2003 | -&done; | -
| Add some documentation on cron(8). | -&a.trhodes; | -May 18, 2003 | -&done; | -
| Fill undefined glossary terms. | -Everyone! | -August 16, 2004 | -¬started; | -
| Send everything to the printer. | -&a.murray; | -- | ¬started; | -
This project is complete. The 2nd Edition FreeBSD Handbook is - available now from The - FreeBSD Mall. The final manuscript is 653 pages, and the - ISBN number is 1571763031. Thanks to everyone who contributed. - Read the full announcement here.
- -If you've found a typo in the printed version, please send your - fix via send-pr(1) or send it straight to the -doc mailing list. - Thanks!
- -| Task | Responsible | Last updated | Status |
|---|---|---|---|
| Create proposal for Wind River management | -Murray | -May 17, 2001 | -&done; | -
| Add a section on headless installs | -Val | -May 11, 2001 | -&done; | -
| Add a section on installing and using XDM | -Seth | -May 23, 2001 | -&done; | -
| Add section 4.3 on "Using the Packages System". | -Chern | -June 15, 2001 | -&done; | -
| Fix index generation infrastructure in doc.docbook.mk | -Nik | -June 19, 2001 | -&done; | -
| Add a section on installing and using XFree86 4.x | -Chris Shumway | -July 11, 2001 | -&done; | -
| Add a section on installing and using KDE, Gnome, etc. | -Val | -June, 2001 | -&done; | -
| Add a section about amd | -Wylie, Val | -May 11, 2001 | -&done; | -
| Add a chapter about configuration and tuning of FreeBSD | -Chern, Murray | -July 10, 2001 | -&done; | -
| Replace ASCII art with proper figures (17.2.2, 17.6.3, etc..) | -Chern | -July 11, 2001 | -&done; | -
| Add index entries to Chapters 1-2 | -Murray | -June 24, 2001 | -&done; | -
| Add index entries to Chapters 3-4 | -Val | -July 11, 2001 | -&done; | -
| Add index entries to Chapters 5-6 | -Val | -July 11, 2001 | -&done; | -
| Add index entries to Chapters 7-8 | -Val | -June 19, 2001 | -&done; | -
| Add index entries to Chapters 9-10 | -Murray | -June 24, 2001 | -&done; | -
| Add index entries to Chapters 11-12 | -Murray | -June 30, 2001 | -&done; | -
| Add index entries to Chapter 13 | -Val | -July 11, 2001 | -&done; | -
| Add index entries to Chapter 14-15 | -Murray | -June 30, 2001 | -&done; | -
| Add index entries to Chapters 21-22 | -Val | -July 20, 2001 | -&done; | -
| Fix cross-referencing tags to look better in the print - output. | -Murray | -July 20, 2001 | -&done; | -
| Add a tuneable knob to remove PGP keys in print output | -Murray | -July 11, 2001 | -&done; | -
| Clear up copyright issues | -Nik, Murray, Foundation | -August 18, 2001 | -&done; | -
| Enclose author attributions in proper tag | -Murray, Chern | -August 18, 2001 | -&done; | -
| Standardize spelling of technical terms | -Murray, Chern | -July 20, 2001 | -&done; | -
| Make sure all filenames, commands, applications, hostnames, etc - are marked up properly | -Murray, Chern | -July 20, 2001 | -&inprogress; | -
| Write collateattributions.pl script to generate a appendix full - of contributing authors. | -Chern | -August 8, 2001 | -&done; | -
| Fix index entries that show up as ??? | -Chern | -August 6, 2001 | -&done; | -
| Rewrite most of the X11 chapter and get rid of all of Greg - Lehey's original content. | -Murray, Nik, Chris Shumway, Others | -July 20, 2001 | -&done; | -
| Update PPP/SLIP chapter | -Brian Somers | -August 18, 2001 | -&done; | -
| Update Serial chapter | -Murray | -August 18, 2001 | -&done; | -
| Get rid of Appendix F | -Murray | -July 13 | -&done; | -
| Move out-of-scope chapters into Developer's Handbook | -Murray | -July 19 | -&done; | -
| Enhance chapter header print output in stylesheets. | -Murray | -July 19 | -&done; | -
| Setup a WRS Perforce server for the last phase of editing | -Murray | -August 11, 2001 | -&done; | -
| Add simple illustrations at the beginning of each Part. | -Michelle / WRS Art | -August 18, 2001 | -&done; | -
| Add admonition graphics for Note, Caution, Warning, Tip. | -Michelle / WRS Art | -August 23, 2001 | -&inprogress; | -
| Design the cover. | -Michelle / WRS Art | -August 23, 2001 | -&done; | -
| Rewrite Install chapter with sysinstall screenshots, etc from - Randy Pratt's install guide. | -Randy Pratt, Murray, Nik | -August 18, 2001 | -&done; | -
| Update and add more content to Introduction chapter. | -rope jkh into it | -July 20, 2001 | -¬started; | -
| Rewrite "synopsis" sections to 'standard' (see the sound chapter for - a sample). | -Murray, Nik, Chern, Val | -August 18, 2001 | -&done; | -
| Add more content to backups chapter | -- | July 20, 2001 | -&done; | -
| Mark up bibliography properly | -Val | -August 7, 2001 | -&done; | -
| Integrate new bibliography framework | -- | August 7, 2001 | -¬started; | -
| Write colophon | -Murray | -August 23, 2001 | -&done; | -
| Make front matter look better | -Murray | -August 2, 2001 | -&done; | -
| Review the book for grammatical errors. | -Jim, Chern, John Murphy, Everyone! | -August 5, 2001 | -&inprogress; | -
| Finish DocBook Speller's dictionary and setup nightly cronjob to spell - check the Handbook's new additions. | -Chern | -August 6, 2001 | -&inprogress; | -
| Add a section on inetd in Advanced Networking. | -Chern | -August 8, 2001 | -&done; | -
| Make sure all section titles are capitalized properly | -Chern | -August 13, 2001 | -&done; | -
| Remove gratuitous Q/A sections in favor of more formal text. | -- | August 7, 2001 | -¬started; | -
| Write Preface. | -Murray | -August 23, 2001 | -&done; | -
| Write Foreword. | -Jordan | -August 23, 2001 | -&inprogress; | -
| Decide what to do with "Contributing to FreeBSD" chapter. | -Murray, Nik | -August 23, 2001 | -&done; | -
| Update bibliography with newer editions, etc. | -- | August 23, 2001 | -¬started; | -
| Add more indexterms throughout the book. Reorganize some - existing indexterms. | -- | August 23, 2001 | -¬started; | -
| Add information about network configuration to the install chapter. | -Probably Nik | -- | ¬started; | -
| Send everything to the printer. | -Murray | -October 10, 2001 | -&done; | -