FreeBSD Documentation Release README				-*- text -*-
$FreeBSD$

This is a collection of documents from the FreeBSD Documentation
Project, in a variety of output formats.

Top-level directories with names of the form <lang>.<encoding> hold
versions of documentation in different languages.  Generally,
documents are written in American English (en_US.ISO8859-1) and
translated to other languages by translation teams.

Beneath the language directories, documents are classified into books
or articles.  Articles are generally 25 pages or less in length, while
books can be any length.

Within the books and articles directories are directories for each
individual document; each can potentially contain multiple renderings
of the document, as described below.

Documents are available in a number of formats.  Some subset of these
formats will be available, depending on how this documentation
collection was built.
   
html		A single HTML file per document (article.html or
		book.html, as appropriate, plus images).

html-split	A collection of smaller, linked HTML files per document
		(index.html, plus images and secondary files).

txt		Plain text (article.txt or book.txt, as appropriate).

pdf		Adobe Portable Document Format, for use with Adobe 
		Acrobat Reader or Ghostscript (article.pdf or book.pdf,
		as appropriate).

ps		Postscript (article.ps or book.ps, as appropriate).

pdb		Palm Pilot database format, for use with the iSilo 
		reader (article.pdb or book.pdb, as appropriate, plus
		a symbolic link formed by combining the directory name
		with a ".pdb" extension).  For more information, see:

		http://www.iSilo.com/

rtf		Microsoft's Rich Text Format (article.rtf or book.rtf,
		as appropriate).  Page numbers are not
		automatically updated when loading this format 
		into Microsoft Word.  Press CTRL+A, CTRL+END, F9, after 
		loading the document, to update the page numbers.

build.txt in the top-level directory gives more information about the
particular set of languages and formats contained in this release
build.

pgpkeyring.txt contains the public PGP/GPG keys of FreeBSD committers,
as taken from the English version of the FreeBSD Handbook.  This file
is suitable for import into a keyring.

