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 sgml-mode with
Emacs
- 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.
DTDs and
Entities
&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:
- Internet services. Many Internet Service Providers (ISPs)
find FreeBSD ideal, running WWW, Usenet news, FTP, Email, and other
services. Ready-to-run software like the nginx or Apache web server or the
ProFTPD
or vsftpd
FTP server make it easy to set up a business or
community-centered ISP. Of course, with FreeBSD's unbeatable networking, your users will enjoy
high speed, reliable services.
- X Window workstation. From an inexpensive X terminal to an
advanced X display, FreeBSD works quite well. Free X software (X.Org™) comes with the
system. nVidia offers native
drivers for their high-performance graphics hardware,
and the industry standard
Motif® and
OpenGL®
libraries are supported. The Xfce and LXDE products provide a desktop
environment. The KDE and GNOME desktop environments also
enjoy full support and provide office suite functionality, with
further good functionality available in the LibreOffice, OpenOffice.Org and
TextMaker
products.
- Networking. From packet filtering to routing to name
service, FreeBSD can turn any PC into a Internet firewall, email
host, print server, PC/NFS server, and more.
- Software development. A suite of development tools comes
with FreeBSD, including the GNU C/C++ compiler and debugger.
The LLVM-based clang suite is also provided and will eventually
replace the GNU suite.
&java; and Tcl/Tk development are also
possible for example, and more esoteric programming
languages like Icon work just fine, too. And FreeBSD's shared
libraries have always been easy to make and use. You can also
choose from a wide range of popular and powerful editors, such as
- XEmacs and Vim.
+ Emacs and Vim.
- Net surfing. A real UNIX workstation makes a great Internet
surfboard. FreeBSD versions of Chromium, Firefox
and Opera are available
for serious web users. Surf the web,
publish your own web pages, read Usenet news, and send and receive
email with a FreeBSD system on your desktop.
- Education and research. FreeBSD makes an excellent
research platform because it includes complete source code.
Students and researchers of operating systems or other computer
science fields can benefit greatly from such an open and
well-documented system.
- And much more. Accounting, action games,
MIS databases, scientific visualization, video conferencing,
Internet relay chat (IRC), home automation, multiuser dungeons,
bulletin board systems, image scanning, and more are all real uses
for FreeBSD today.
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.