cfd9e12239
- Move includes.nav*.sgml to share/sgml/navibar.ent and
<lang>/share/sgml/nabibar.l10n.ent.
- Move includes.sgml and includes.xsl to
share/sgml/common.ent, share/sgml/header.ent, <lang>/share/sgml/l10n.ent,
and <lang>?share/sgml/header.l10n.ent.
- Move most of XSLT libraries to share/sgml/*.xsl and
<lang>/share/sgml/*.xsl.
- Move news.xml and other *.xml files for the similar purpose
to share/sgml/*.xml and <lang>/share/sgml/*.xml.
- Switch to use a custom DTD for HTML document. Now we use
"-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension", which is
HTML 4.01 + some entities previously pulled via
"<!ENTITY % includes SYSTEM "includes.sgml"> %includes;" line.
The location of entity file will be resolved by using catalog file.
- Add DOCTYPE declearation to XML documents. This makes the followings
possible:
* Use of &foo; entities for SGML in an XML file instead of defining
{$foo} as the same content.
* &symbolic; entities for Latin characters.
- Duplicated information between SGML and XML, or English and
translated doc, has been removed as much as possible.
44 lines
1.6 KiB
Text
44 lines
1.6 KiB
Text
<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
|
|
<!ENTITY base CDATA "..">
|
|
<!ENTITY date "$FreeBSD: www/en/docproj/doc-set.sgml,v 1.16 2005/11/30 21:43:43 pav Exp $">
|
|
<!ENTITY title "FreeBSD Documentation Project: Documentation Set">
|
|
<!ENTITY % navinclude.docs "INCLUDE">
|
|
]>
|
|
|
|
<html>
|
|
&header;
|
|
|
|
<p>FreeBSD's documentation falls into three basic categories:</p>
|
|
|
|
<ol>
|
|
<li><p><a href="http://www.FreeBSD.org/cgi/man.cgi"><b>The manual pages</b></a></p>
|
|
|
|
<p>The Project does not really concern itself with these, since
|
|
they are a part of the base system. The exception to this is the
|
|
Japanese team, who are translating them. There is no reason other
|
|
volunteers could not step in to translate the manual pages to other
|
|
languages as well.</p>
|
|
|
|
<p>That is not to say that the manual pages are unimportant, far from
|
|
it. It is just that they are intimately tied to specific systems of
|
|
FreeBSD, and most of the time the best person to write the manual
|
|
page is the person that wrote that part of FreeBSD.</p></li>
|
|
|
|
<li><p><a href="../docs/books.html"><b>The Books</b></a></p>
|
|
|
|
<p>The project has a large amount of documentation that is "book
|
|
length", or becoming that way. These include the FreeBSD FAQ and
|
|
the FreeBSD Handbook.</p>
|
|
|
|
<li><p><a href="../docs/books.html#ARTICLES"><b>The Articles</b></a></p>
|
|
|
|
<p>FreeBSD has a wealth of information available in shorter, article
|
|
form -- similar to the tutorials or HOWTO documentation of other
|
|
projects.</p>
|
|
</ol>
|
|
|
|
|
|
<p></p><a href="docproj.html">FreeBSD Documentation Project Home</a>
|
|
&footer;
|
|
</body>
|
|
</html>
|