Index: head/en_US.ISO8859-1/books/fdp-primer/psgml-mode/chapter.xml =================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/psgml-mode/chapter.xml (revision 52525) +++ head/en_US.ISO8859-1/books/fdp-primer/psgml-mode/chapter.xml (revision 52526) @@ -1,170 +1,169 @@ Using <literal>sgml-mode</literal> with <application>Emacs</application> - Recent versions of Emacs or - XEmacs (available from the Ports - Collection) contain a very useful package called PSGML (can be - installed from editors/psgml). + Recent versions of Emacs (available + from the Ports Collection) contain a very useful package called + PSGML (can be installed from editors/psgml). Automatically invoked when a file with the .xml extension is loaded, or by typing M-x sgml-mode, it is a major mode for dealing with SGML files, elements and attributes. An understanding of some of the commands provided by this mode can make working with SGML documents such as the Handbook much easier. C-c C-e Runs sgml-insert-element. You will be prompted for the name of the element to insert at the current point. You can use the Tab key to complete the element. Elements that are not valid at the current point will be disallowed. The start and end tags for the element will be inserted. If the element contains other, mandatory, elements then these will be inserted as well. C-c = Runs sgml-change-element-name. Place the point within an element and run this command. You will be prompted for the name of the element to change to. Both the start and end tags of the current element will be changed to the new element. C-c C-r Runs sgml-tag-region. Select some text (move to start of text, C-space, move to end of text, C-space) and then run this command. You will be prompted for the element to use. This element will then be inserted immediately before and after your marked region. C-c - Runs sgml-untag-element. Place the point within the start or end tag of an element you want to remove, and run this command. The element's start and end tags will be removed. C-c C-q Runs sgml-fill-element. Will recursively fill (i.e., reformat) content from the current element in. The filling will affect content in which whitespace is significant, such as within programlisting elements, so run this command with care. C-c C-a Runs sgml-edit-attributes. Opens a second buffer containing a list of all the attributes for the closest enclosing element, and their current values. Use Tab to navigate between attributes, C-k to remove an existing value and replace it with a new one, C-c C-c to close this buffer and return to the main document. C-c C-v Runs sgml-validate. Prompts you to save the current document (if necessary) and then runs an SGML validator. The output from the validator is captured into a new buffer, and you can then navigate from one troublespot to the next, fixing markup errors as you go. C-c / Runs sgml-insert-end-tag. Inserts the end tag for the current open element. Doubtless there are other useful functions of this mode, but those are the ones I use most often. You can also use the following entries in .emacs to set proper spacing, indentation, and column width for working with the Documentation Project. (defun local-sgml-mode-hook (setq fill-column 70 indent-tabs-mode nil next-line-add-newlines nil standard-indent 4 sgml-indent-data t) (auto-fill-mode t) (setq sgml-catalog-files '("/usr/local/share/xml/catalog"))) (add-hook 'psgml-mode-hook '(lambda () (local-psgml-mode-hook))) Index: head/en_US.ISO8859-1/books/fdp-primer/tools/chapter.xml =================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/tools/chapter.xml (revision 52525) +++ head/en_US.ISO8859-1/books/fdp-primer/tools/chapter.xml (revision 52526) @@ -1,143 +1,141 @@ Tools Several software tools are used to manage the FreeBSD documentation and render it to different output formats. Some of these tools are required and must be installed before working through the examples in the following chapters. Some are optional, adding capabilities or making the job of creating documentation less demanding. Required Tools Install textproc/docproj from the Ports Collection. This meta-port installs all the applications required to do useful work with the &os; documentation. Some further notes on particular components are given below. <acronym>DTD</acronym>s and <acronym>Entities</acronym> &os; documentation uses several Document Type Definitions (DTDs) and sets of XML entities. These are all installed by the textproc/docproj port. XHTML DTD (textproc/xhtml) XHTML is the markup language of choice for the World Wide Web, and is used throughout the &os; web site. DocBook DTD (textproc/docbook-xml) DocBook is designed for marking up technical documentation. Most of the &os; documentation is written in DocBook. ISO 8879 entities (textproc/iso8879) Character entities from the ISO 8879:1986 standard used by many DTDs. Includes named mathematical symbols, additional characters in the Latin character set (accents, diacriticals, and so on), and Greek symbols. Optional Tools These applications are not required, but can make working on the documentation easier or add capabilities. Software Vim (editors/vim) A popular editor for working with XML and derived documents, like DocBook XML. - Emacs or - XEmacs - (editors/emacs or - editors/xemacs) + Emacs + (editors/emacs) Both of these editors include a special mode for editing documents marked up according to an XML DTD. This mode includes commands to reduce the amount of typing needed, and help reduce the possibility of errors. Index: head/en_US.ISO8859-1/htdocs/applications.xml =================================================================== --- head/en_US.ISO8859-1/htdocs/applications.xml (revision 52525) +++ head/en_US.ISO8859-1/htdocs/applications.xml (revision 52526) @@ -1,148 +1,148 @@ ]> &title; $FreeBSD$

Experience the possibilities with FreeBSD

FreeBSD can handle nearly any task you would expect of a &unix; workstation, as well as many you might not expect:

FreeBSD is a true open system with full source code.

There is no doubt that so-called open systems are the requirement for today's computing applications. But no commercial vendor-supplied solution is more open than one which includes full source code to the entire operating system, including the kernel and all of the system daemons, programs, and utilities. You can modify any part of FreeBSD to suit your personal, organizational, or corporate needs.

With its generous licensing policy, you can use FreeBSD as the basis for any number of free or commercial applications.

FreeBSD runs thousands of applications.

Because FreeBSD is based on 4.4BSD, an industry-standard version of UNIX, it is easy to compile and run programs. FreeBSD also includes an extensive packages collection and ports collection that bring precompiled and easy-to-build software right to your desktop or enterprise server. There is also a growing number of commercial applications written for FreeBSD.

Here are some examples of the environments in which FreeBSD is used:

FreeBSD is an operating system that will grow with your needs.

Though FreeBSD is free software, it is also user supported software. Any questions you have can be posted to hundreds of FreeBSD developers and users simply by e-mailing the freebsd-questions@FreeBSD.org mailing list.

FreeBSD also has a worldwide group of programmers and writers who fix bugs, add new features and document the system. Support for new devices or special features is an almost constant development process, and the team keeps a special eye out for problems which affect system stability. FreeBSD users are quite proud of not only how fast but how reliable their systems are.

What experts have to say . . .

``FreeBSD handles [our] heavy load quite well and it is nothing short of amazing. Salutations to the FreeBSD team.''

---Mark Hittinger, administrator of WinNet Communications, Inc.