Remove release-related documentation from the base repository,
moved to the doc repository (see revisions r51045:r51061). Sponsored by: The FreeBSD Foundation
This commit is contained in:
Glen Barber
parent
b949cc41d1
commit
b1bad39103
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=324338
@ -1,38 +0,0 @@
|
||||
# $FreeBSD$
|
||||
#
|
||||
# The user can override the default language to build and install
|
||||
# with the RELNOTES_LANG variable.
|
||||
#
|
||||
.if defined(RELNOTES_LANG) && !empty(RELNOTES_LANG)
|
||||
SUBDIR+= ${RELNOTES_LANG}
|
||||
.else
|
||||
SUBDIR+= en_US.ISO8859-1
|
||||
.endif
|
||||
SUBDIR+= share/xml
|
||||
|
||||
RELN_ROOT?= ${.CURDIR}
|
||||
|
||||
.if exists(/usr/local/bin/svn)
|
||||
SVN?= /usr/local/bin/svn
|
||||
.elif exists(/usr/bin/svn)
|
||||
SVN?= /usr/bin/svn
|
||||
.else
|
||||
SVN?= /usr/bin/svnlite
|
||||
.endif
|
||||
|
||||
SVNFLAGS?= -r HEAD
|
||||
|
||||
update:
|
||||
.if !exists(${SVN})
|
||||
@echo "--------------------------------------------------------------"
|
||||
@echo ">>> Updating ${RELN_ROOT} requires ${SVN}."
|
||||
@echo "--------------------------------------------------------------"
|
||||
@exit 1
|
||||
.endif
|
||||
@echo "--------------------------------------------------------------"
|
||||
@echo ">>> Updating ${.CURDIR}"
|
||||
@echo "--------------------------------------------------------------"
|
||||
@(cd ${.CURDIR} && ${SVN} update ${SVNFLAGS})
|
||||
|
||||
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
|
||||
.include "${DOC_PREFIX}/share/mk/doc.subdir.mk"
|
||||
@ -1,127 +0,0 @@
|
||||
-*- text -*-
|
||||
RELNOTESng README
|
||||
Bruce A. Mah <bmah@freebsd.org>
|
||||
$FreeBSD$
|
||||
|
||||
This is the top-level directory for RELNOTESng, a re-write of
|
||||
FreeBSD's *.TXT documentation files. They have been converted to
|
||||
DocBook, and versions of the documents can be now be built for various
|
||||
supported architectures. The output files can be rendered in any
|
||||
format supported by the FreeBSD Documentation Project (for example,
|
||||
ASCII text, PDF, PS, HTML).
|
||||
|
||||
RELNOTESng requires that the FreeBSD doc/ sources are installed; it
|
||||
leverages off of much of the DocProj build infrastructure, including
|
||||
DocBook extensions and stylesheets. If the doc/ sources are not
|
||||
installed in /usr/src, their location should be specified with the
|
||||
DOC_PREFIX Makefile variable. RELNOTESng also requires the DocProj
|
||||
build tools, which can easily be installed with the textproc/docproj
|
||||
port in the Ports Collection.
|
||||
|
||||
Notable files and directories:
|
||||
|
||||
share/mk/doc.relnotes.mk
|
||||
Common Makefile definitions for RELNOTESng. These definitions
|
||||
mostly accommodate the fact that we're building DocProj-like
|
||||
documents outside the doc/ tree.
|
||||
share/xml/catalog
|
||||
Main SGML catalog for all language-neutral (and default EN)
|
||||
stylesheet and entity files. Can be overridden if needed for
|
||||
translations.
|
||||
share/xml/default.dsl
|
||||
All documents build with this file as a stylesheet. All it
|
||||
does is to make it possible to use the document catalogs to
|
||||
locate the "real" stylesheet by reference, rather than having
|
||||
to specify it by pathname.
|
||||
share/xml/release.dsl
|
||||
Language-neutral stylesheet. This stylesheet supports
|
||||
the arch= attribute on (all?) DocBook elements; elements with
|
||||
an arch= attribute are only included in the output if their
|
||||
value is equal to the value of the &arch; entity. In the
|
||||
future, arch= could be a list of possible &arch; entity values
|
||||
that match, such as "i386,sparc64".
|
||||
share/xml/release.ent
|
||||
Release information. Need to update the entry definitions in
|
||||
this file when rolling new revisions; these should take effect
|
||||
in all documents.
|
||||
|
||||
en_US.ISO8859-1/share/xml/release.dsl
|
||||
Language-dependent stylesheet for en, but also the default for
|
||||
translations if they don't override the settings here. This
|
||||
stylesheet sets the email footer at the bottom of HTML pages,
|
||||
as well as a few other parameters. If necessary for
|
||||
translations, this file can be overridden with
|
||||
*/share/xml/release.dsl and */share/xml/catalog.
|
||||
|
||||
*/relnotes/common/
|
||||
Directory for multi-architecture release notes files.
|
||||
*/relnotes/*/
|
||||
Directories for architecture-specific release notes files.
|
||||
|
||||
*/hardware/common/
|
||||
Directory for multi-architecture hardware notes files.
|
||||
*/hardware/*/
|
||||
Directories for architecture-specific hardware notes files.
|
||||
|
||||
*/installation/common/
|
||||
Directory for multi-architecture installation notes files.
|
||||
Note that the FreeBSD DocProj build infrastructure does
|
||||
not handle documents (or subdirectories) named "install"
|
||||
well, so we call our document "installation" and do
|
||||
a hack when it gets installed into a distribution to fix
|
||||
this up.
|
||||
*/installation/*/
|
||||
Directories for architecture-specific release notes files.
|
||||
|
||||
*/errata/
|
||||
Directory for errata document.
|
||||
|
||||
*/readme/
|
||||
Directory for (introductory) document.
|
||||
|
||||
If building the release notes "standalone" (in other words, not part
|
||||
of a release), it may be necessary (depending on the relative
|
||||
locations of the checked-out src/ and doc/ directories) to set the
|
||||
DOC_PREFIX Makefile variable to point to the top directory of the doc/
|
||||
tree. For example:
|
||||
|
||||
% make DOC_PREFIX=/usr/doc all
|
||||
|
||||
All definition of the "current" version of FreeBSD is contained in the
|
||||
share/xml/release.ent file; release engineers should peruse the
|
||||
contents of this file carefully when doing version number bumps.
|
||||
|
||||
When creating content for the architecture-dependent files, authors
|
||||
should use the arch= attribute to elements that are specific to a
|
||||
particular machine architecture. The value of this attribute should
|
||||
be a single word that indicates for which architecture the current
|
||||
element will be included. For example:
|
||||
|
||||
<para arch="sparc64">SPARC64-specific text</para>
|
||||
|
||||
The currently-supported architectures are amd64, arm, i386,
|
||||
powerpc and sparc64. An element may appear for multiple architectures
|
||||
by specifying a comma-separated list of architectures
|
||||
(i.e. arch="sparc64,amd64").
|
||||
|
||||
When creating a translation, make a new directory under this
|
||||
directory with a language code (paralleling the DocProj directory
|
||||
structure). If necessary, new language-dependent HTML footers can be
|
||||
generated by making a new language-dependent
|
||||
${LANG}/share/xml/release.dsl, a ${LANG}/share/xml/catalog that
|
||||
points to it, and a new definition in the Makefiles that adds
|
||||
${LANG}/share/xml/catalog to EXTRA_CATALOGS. Except for the Makefile
|
||||
changes, this is the same procedure that is used for creating a new
|
||||
translation for DocProj files.
|
||||
|
||||
RELNOTESng is now enabled by default in the FreeBSD release-build
|
||||
process. It can be disabled by setting NODOC=YES when building a
|
||||
release (note that this is the same variable that disables DocProj
|
||||
documentation builds).
|
||||
|
||||
Release builders can set which language gets built with the
|
||||
RELNOTES_LANG variable; note that this is different from the
|
||||
DOC_LANG variable because (at least initially) most languages
|
||||
will have localized DocProj files but not localized release notes.
|
||||
The default language, if none is specified, is en_US.ISO8859-1.
|
||||
|
||||
@ -1,16 +0,0 @@
|
||||
# $FreeBSD$
|
||||
|
||||
RELN_ROOT?= ${.CURDIR}/..
|
||||
|
||||
SUBDIR = relnotes
|
||||
SUBDIR+= hardware
|
||||
SUBDIR+= readme
|
||||
SUBDIR+= errata
|
||||
|
||||
COMPAT_SYMLINK = en
|
||||
|
||||
LANGCODE=en_US.ISO8859-1
|
||||
_LANGCODE=en_US.ISO8859-1
|
||||
|
||||
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
|
||||
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
|
||||
@ -1,19 +0,0 @@
|
||||
# $FreeBSD$
|
||||
|
||||
RELN_ROOT?= ${.CURDIR}/../..
|
||||
.ifdef NO_LANGCODE_IN_DESTDIR
|
||||
DESTDIR?= ${DOCDIR}/errata
|
||||
.else
|
||||
DESTDIR?= ${DOCDIR}/en_US.ISO8859-1/errata
|
||||
.endif
|
||||
|
||||
DOC?= article
|
||||
FORMATS?= html
|
||||
INSTALL_COMPRESSED?= gz
|
||||
INSTALL_ONLY_COMPRESSED?=
|
||||
|
||||
# SGML content
|
||||
SRCS+= article.xml
|
||||
|
||||
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
|
||||
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
|
||||
@ -1,100 +0,0 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
|
||||
"http://www.FreeBSD.org/XML/share/xml/freebsd50.dtd" [
|
||||
<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN"
|
||||
"http://www.FreeBSD.org/release/XML/release.ent">
|
||||
%release;
|
||||
<!ENTITY security SYSTEM "../../share/xml/security.xml">
|
||||
<!ENTITY errata SYSTEM "../../share/xml/errata.xml">
|
||||
]>
|
||||
|
||||
<article xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||||
version="5.0">
|
||||
<info>
|
||||
<title>&os; &release; Errata </title>
|
||||
|
||||
<author><orgname>The &os; Project</orgname></author>
|
||||
|
||||
<pubdate>$FreeBSD$</pubdate>
|
||||
|
||||
<copyright>
|
||||
<year>2015</year>
|
||||
|
||||
<holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
|
||||
</copyright>
|
||||
|
||||
<legalnotice xml:id="trademarks" role="trademarks">
|
||||
&tm-attrib.freebsd;
|
||||
&tm-attrib.intel;
|
||||
&tm-attrib.sparc;
|
||||
&tm-attrib.general;
|
||||
</legalnotice>
|
||||
|
||||
<abstract>
|
||||
<para>This document lists errata items for &os; &release;,
|
||||
containing significant information discovered after the release
|
||||
or too late in the release cycle to be otherwise included in the
|
||||
release documentation.
|
||||
This information includes security advisories, as well as news
|
||||
relating to the software or documentation that could affect its
|
||||
operation or usability. An up-to-date version of this document
|
||||
should always be consulted before installing this version of
|
||||
&os;.</para>
|
||||
|
||||
<para>This errata document for &os; &release;
|
||||
will be maintained until the release of &os; &release.next;.</para>
|
||||
</abstract>
|
||||
</info>
|
||||
|
||||
<sect1 xml:id="intro">
|
||||
<title>Introduction</title>
|
||||
|
||||
<para>This errata document contains <quote>late-breaking news</quote>
|
||||
about &os; &release;
|
||||
Before installing this version, it is important to consult this
|
||||
document to learn about any post-release discoveries or problems
|
||||
that may already have been found and fixed.</para>
|
||||
|
||||
<para>Any version of this errata document actually distributed
|
||||
with the release (for example, on a CDROM distribution) will be
|
||||
out of date by definition, but other copies are kept updated on
|
||||
the Internet and should be consulted as the <quote>current
|
||||
errata</quote> for this release. These other copies of the
|
||||
errata are located at
|
||||
<link xlink:href="https://www.FreeBSD.org/releases/" />,
|
||||
plus any sites
|
||||
which keep up-to-date mirrors of this location.</para>
|
||||
|
||||
<para>Source and binary snapshots of &os; &release.branch; also
|
||||
contain up-to-date copies of this document (as of the time of
|
||||
the snapshot).</para>
|
||||
|
||||
<para>For a list of all &os; CERT security advisories, see
|
||||
<link xlink:href="https://www.FreeBSD.org/security/"/>.</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="security">
|
||||
<title>Security Advisories</title>
|
||||
|
||||
&security;
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="errata">
|
||||
<title>Errata Notices</title>
|
||||
|
||||
&errata;
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="open-issues">
|
||||
<title>Open Issues</title>
|
||||
|
||||
<para>No open issues.</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="late-news">
|
||||
<title>Late-Breaking News</title>
|
||||
|
||||
<para>No news.</para>
|
||||
</sect1>
|
||||
</article>
|
||||
@ -1,30 +0,0 @@
|
||||
# $FreeBSD$
|
||||
|
||||
RELN_ROOT?= ${.CURDIR}/../..
|
||||
|
||||
.ifdef NO_LANGCODE_IN_DESTDIR
|
||||
DESTDIR?= ${DOCDIR}/hardware
|
||||
.else
|
||||
DESTDIR?= ${DOCDIR}/en_US.ISO8859-1/hardware
|
||||
.endif
|
||||
|
||||
DOC?= article
|
||||
FORMATS?= html
|
||||
INSTALL_COMPRESSED?= gz
|
||||
INSTALL_ONLY_COMPRESSED?=
|
||||
|
||||
JADEFLAGS+= -V %generate-article-toc%
|
||||
|
||||
# SGML content
|
||||
SRCS+= article.xml
|
||||
SRCS+= ${DEV-AUTODIR}/catalog-auto
|
||||
SRCS+= ${DEV-AUTODIR}/dev-auto.ent
|
||||
|
||||
CATALOGS+= -c ${DEV-AUTODIR}/catalog-auto
|
||||
|
||||
URL_RELPREFIX?= ../../../..
|
||||
|
||||
HWNOTES_MI= 1
|
||||
|
||||
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
|
||||
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,24 +0,0 @@
|
||||
# $FreeBSD$
|
||||
|
||||
RELN_ROOT?= ${.CURDIR}/../..
|
||||
.ifdef NO_LANGCODE_IN_DESTDIR
|
||||
DESTDIR?= ${DOCDIR}/readme
|
||||
.else
|
||||
DESTDIR?= ${DOCDIR}/en_US.ISO8859-1/readme
|
||||
.endif
|
||||
|
||||
DOC?= article
|
||||
FORMATS?= html
|
||||
INSTALL_COMPRESSED?= gz
|
||||
INSTALL_ONLY_COMPRESSED?=
|
||||
|
||||
#
|
||||
# SRCS lists the individual SGML files that make up the document. Changes
|
||||
# to any of these files will force a rebuild
|
||||
#
|
||||
|
||||
# SGML content
|
||||
SRCS+= article.xml
|
||||
|
||||
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
|
||||
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
|
||||
@ -1,411 +0,0 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
|
||||
"../../../share/xml/freebsd50.dtd" [
|
||||
<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
|
||||
%release;
|
||||
]>
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-indent-data: t
|
||||
sgml-omittag: nil
|
||||
sgml-always-quote-attributes: t
|
||||
End:
|
||||
-->
|
||||
<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
||||
<info><title>&os; &release.current; README</title>
|
||||
|
||||
|
||||
<author><orgname>The &os; Project</orgname></author>
|
||||
|
||||
<pubdate>$FreeBSD$</pubdate>
|
||||
|
||||
<copyright>
|
||||
<year>2000</year>
|
||||
<year>2001</year>
|
||||
<year>2002</year>
|
||||
<year>2003</year>
|
||||
<year>2004</year>
|
||||
<year>2005</year>
|
||||
<year>2006</year>
|
||||
<year>2007</year>
|
||||
<year>2008</year>
|
||||
<year>2009</year>
|
||||
<year>2010</year>
|
||||
<year>2011</year>
|
||||
<year>2012</year>
|
||||
<year>2013</year>
|
||||
<year>2014</year>
|
||||
<year>2015</year>
|
||||
<holder role="mailto:doc@FreeBSD.org">The &os; Documentation Project</holder>
|
||||
</copyright>
|
||||
|
||||
<legalnotice xml:id="trademarks" role="trademarks">
|
||||
&tm-attrib.freebsd;
|
||||
&tm-attrib.intel;
|
||||
&tm-attrib.opengroup;
|
||||
&tm-attrib.sparc;
|
||||
&tm-attrib.general;
|
||||
</legalnotice>
|
||||
|
||||
<abstract>
|
||||
<para>This document gives a brief introduction to &os;
|
||||
&release.current;. It includes some information on how to
|
||||
obtain &os;, a listing of various ways to contact the &os;
|
||||
Project, and pointers to some other sources of
|
||||
information.</para>
|
||||
</abstract>
|
||||
</info>
|
||||
|
||||
<sect1 xml:id="intro">
|
||||
<title>Introduction</title>
|
||||
|
||||
<para>This distribution is a &release.type; of &os; &release.current;, the
|
||||
latest point along the &release.branch; branch.</para>
|
||||
|
||||
<sect2>
|
||||
<title>About &os;</title>
|
||||
|
||||
<para>&os; is an operating system based on 4.4 BSD Lite for
|
||||
AMD64 and Intel EM64T based PC hardware (&arch.amd64;),
|
||||
Intel, AMD, Cyrix or NexGen <quote>x86</quote> based PC hardware (&arch.i386;),
|
||||
and &ultrasparc; machines (&arch.sparc64;). Versions
|
||||
for the &arm; (&arch.arm;), &mips; (&arch.mips;), and
|
||||
&powerpc; (&arch.powerpc;) architectures are currently under
|
||||
development as well. &os; works with a wide variety of
|
||||
peripherals and configurations and can be used for everything
|
||||
from software development to games to Internet Service
|
||||
Provision.</para>
|
||||
|
||||
<para>This release of &os; contains everything you need to run
|
||||
such a system, including full source code for the kernel and
|
||||
all utilities in the base distribution. With the source
|
||||
distribution installed, you can literally recompile the entire
|
||||
system from scratch with one command, making it ideal for
|
||||
students, researchers, or users who simply want to see how it
|
||||
all works.</para>
|
||||
|
||||
<para>A large collection of third-party ported software (the
|
||||
<quote>Ports Collection</quote>) is also provided to make it
|
||||
easy to obtain and install all your favorite traditional &unix;
|
||||
utilities for &os;. Each <quote>port</quote> consists of a
|
||||
set of scripts to retrieve, configure, build, and install a
|
||||
piece of software, with a single command. Over &os.numports;
|
||||
ports, from editors to programming languages to graphical
|
||||
applications, make &os; a powerful and comprehensive operating
|
||||
environment that extends far beyond what's provided by many
|
||||
commercial versions of &unix;. Most ports are also available as
|
||||
pre-compiled <quote>packages</quote>, which can be quickly
|
||||
installed from the installation program.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Target Audience</title>
|
||||
|
||||
<para releasetype="current">This &release.type; is aimed primarily at early adopters
|
||||
and various other users who want to get involved with the
|
||||
ongoing development of &os;. While the &os; development team
|
||||
tries its best to ensure that each &release.type; works as
|
||||
advertised, &release.branch; is very much a
|
||||
work-in-progress.</para>
|
||||
|
||||
<para releasetype="current">The basic requirements for using this &release.type; are
|
||||
technical proficiency with &os; and an understanding of the
|
||||
ongoing development process of &os; &release.branch; (as
|
||||
discussed on the &a.current;).</para>
|
||||
|
||||
<para releasetype="current">For those more interested in doing business with &os; than
|
||||
in experimenting with new &os; technology, formal releases
|
||||
(such as &release.prev.stable;) are frequently more appropriate.
|
||||
Releases undergo a period of testing and quality assurance
|
||||
checking to ensure high reliability and dependability.</para>
|
||||
|
||||
<para releasetype="snapshot">This &release.type; is aimed primarily at early adopters
|
||||
and various other users who want to get involved with the
|
||||
ongoing development of &os;. While the &os; development team
|
||||
tries its best to ensure that each &release.type; works as
|
||||
advertised, &release.branch; is very much a
|
||||
work-in-progress.</para>
|
||||
|
||||
<para releasetype="snapshot">The basic requirements for using this &release.type; are
|
||||
technical proficiency with &os; and an understanding of the
|
||||
ongoing development process of &os; &release.branch; (as
|
||||
discussed on the &a.current;).</para>
|
||||
|
||||
<para releasetype="snapshot">For those more interested in doing business with &os; than
|
||||
in experimenting with new &os; technology, formal releases
|
||||
(such as &release.prev.stable;) are frequently more appropriate.
|
||||
Releases undergo a period of testing and quality assurance
|
||||
checking to ensure high reliability and dependability.</para>
|
||||
|
||||
<para releasetype="release">This &release.type; of &os; is suitable for all users. It
|
||||
has undergone a period of testing and quality assurance
|
||||
checking to ensure the highest reliability and
|
||||
dependability.</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="obtain">
|
||||
<title>Obtaining &os;</title>
|
||||
|
||||
<para>&os; may be obtained in a variety of ways. This section
|
||||
focuses on those ways that are primarily useful for obtaining a
|
||||
complete &os; distribution, rather than updating an existing
|
||||
installation.</para>
|
||||
|
||||
<sect2>
|
||||
<title>CDROM and DVD</title>
|
||||
|
||||
<para>&os; -RELEASE distributions may be ordered on CDROM or DVD
|
||||
from several publishers. This is frequently the most
|
||||
convenient way to obtain &os; for new installations, as it
|
||||
provides a convenient way to quickly reinstall the system if
|
||||
necessary. Some distributions include some of the optional,
|
||||
precompiled <quote>packages</quote> from the &os; Ports
|
||||
Collection, or other extra material.</para>
|
||||
|
||||
<para>A list of the CDROM and DVD publishers known to the
|
||||
project are listed in the <link xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
|
||||
&os;</quote></link> appendix to the Handbook.</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>FTP</title>
|
||||
|
||||
<para>You can use FTP to retrieve &os; and any or all of its
|
||||
optional packages from <uri xlink:href="ftp://ftp.FreeBSD.org/">ftp://ftp.FreeBSD.org/</uri>, which is the official
|
||||
&os; release site, or any of its
|
||||
<quote>mirrors</quote>.</para>
|
||||
|
||||
<para>Lists of locations that mirror &os; can be found in the
|
||||
<link xlink:href="&url.books.handbook;/mirrors-ftp.html">FTP
|
||||
Sites</link> section of the Handbook.
|
||||
Finding a close (in networking terms) mirror from which to
|
||||
download the distribution is highly recommended.</para>
|
||||
|
||||
<para>Additional mirror sites are always welcome. Contact
|
||||
<email>freebsd-admin@FreeBSD.org</email> for more details on
|
||||
becoming an official mirror site. You can also find useful
|
||||
information for mirror sites at the <link xlink:href="&url.articles.hubs;/">Mirroring
|
||||
&os;</link> article.</para>
|
||||
|
||||
<para>Mirrors generally contain the ISO images generally used to
|
||||
create a CDROM of a &os; release. They usually also contain
|
||||
floppy disk images (for applicable platforms), as well as the
|
||||
files necessary to do an installation over the network.
|
||||
Finally mirrors sites usually contain a set of packages for
|
||||
the most current release.</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="contacting">
|
||||
<title>Contacting the &os; Project</title>
|
||||
|
||||
<sect2>
|
||||
<title>Email and Mailing Lists</title>
|
||||
|
||||
<para>For any questions or general technical support issues,
|
||||
please send mail to the &a.questions;.</para>
|
||||
|
||||
<para>If you're tracking the &release.branch; development efforts, you
|
||||
<emphasis>must</emphasis> join the &a.current;, in order to
|
||||
keep abreast of recent developments and changes that may
|
||||
affect the way you use and maintain the system.</para>
|
||||
|
||||
<para>Being a largely-volunteer effort, the &os;
|
||||
Project is always happy to have extra hands willing to help—there are already far more desired enhancements than
|
||||
there is time to implement them. To contact the developers on
|
||||
technical matters, or with offers of help, please send mail to
|
||||
the &a.hackers;.</para>
|
||||
|
||||
<para>Please note that these mailing lists can experience
|
||||
<emphasis>significant</emphasis> amounts of traffic. If you
|
||||
have slow or expensive mail access, or are only interested in
|
||||
keeping up with major &os; events, you may find it
|
||||
preferable to subscribe instead to the &a.announce;.</para>
|
||||
|
||||
<para>All of the mailing lists can be freely joined by anyone
|
||||
wishing to do so. Visit the <link xlink:href="&url.base;/mailman/listinfo">
|
||||
&os; Mailman Info Page</link>. This will give you more
|
||||
information on joining the various lists, accessing archives,
|
||||
etc. There are a number of mailing lists targeted at special
|
||||
interest groups not mentioned here; more information can be
|
||||
obtained either from the Mailman pages or the <link xlink:href="&url.base;/support.html#mailing-list">mailing
|
||||
lists section</link> of the &os; Web site.</para>
|
||||
|
||||
<important>
|
||||
<para>Do <emphasis>not</emphasis> send email to the lists
|
||||
asking to be subscribed. Use the Mailman interface
|
||||
instead.</para>
|
||||
</important>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Submitting Problem Reports</title>
|
||||
|
||||
<para>Suggestions, bug reports and contributions of code are
|
||||
always valued—please do not hesitate to report any
|
||||
problems you may find. Bug reports with attached fixes are of
|
||||
course even more welcome.</para>
|
||||
|
||||
<para>The preferred method to submit bug reports from a machine
|
||||
with Internet connectivity is to use the
|
||||
<application>Bugzilla</application> bug tracker.
|
||||
<quote>Problem Reports</quote> (PRs) submitted in this way
|
||||
will be filed and their progress tracked; the &os; developers
|
||||
will do their best to respond to all reported bugs as soon as
|
||||
possible. <link
|
||||
xlink:href="https://bugs.FreeBSD.org/search/">A list of all
|
||||
active PRs</link> is available on the &os; Web site; this
|
||||
list is useful to see what potential problems other users have
|
||||
encountered.</para>
|
||||
|
||||
<para>Note that &man.send-pr.1; is deprecated.</para>
|
||||
|
||||
<para>For more information, <link
|
||||
xlink:href="&url.articles.problem-reports;/"><quote>Writing
|
||||
&os; Problem Reports</quote></link>, available on the &os;
|
||||
Web site, has a number of helpful hints on writing and
|
||||
submitting effective problem reports.</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="seealso">
|
||||
<title>Further Reading</title>
|
||||
|
||||
<para>There are many sources of information about &os;; some are
|
||||
included with this distribution, while others are available
|
||||
on-line or in print versions.</para>
|
||||
|
||||
<sect2 xml:id="release-docs">
|
||||
<title>Release Documentation</title>
|
||||
|
||||
<para>A number of other files provide more specific information
|
||||
about this &release.type; distribution. These files are
|
||||
provided in various formats. Most distributions will include
|
||||
both ASCII text (<filename>.TXT</filename>) and HTML
|
||||
(<filename>.HTM</filename>) renditions. Some distributions
|
||||
may also include other formats such as Portable Document Format
|
||||
(<filename>.PDF</filename>).
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para><filename>README.TXT</filename>: This file, which
|
||||
gives some general information about &os; as well as
|
||||
some cursory notes about obtaining a
|
||||
distribution.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><filename>RELNOTES.TXT</filename>: The release
|
||||
notes, showing what's new and different in &os;
|
||||
&release.current; compared to the previous release (&os;
|
||||
&release.prev;).</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><filename>HARDWARE.TXT</filename>: The hardware
|
||||
compatibility list, showing devices with which &os; has
|
||||
been tested and is known to work.</para>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para><filename>ERRATA.TXT</filename>: Release errata.
|
||||
Late-breaking, post-release information can be found in
|
||||
this file, which is principally applicable to releases
|
||||
(as opposed to snapshots). It is important to consult
|
||||
this file before installing a release of &os;, as it
|
||||
contains the latest information on problems which have
|
||||
been found and fixed since the release was
|
||||
created.</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
|
||||
<para>On platforms that support &man.bsdinstall.8; (currently
|
||||
&arch.amd64;, &arch.i386;, and &arch.sparc64;), these documents are generally available via the
|
||||
Documentation menu during installation. Once the system is
|
||||
installed, you can revisit this menu by re-running the
|
||||
&man.bsdinstall.8; utility.</para>
|
||||
|
||||
<note>
|
||||
<para>It is extremely important to read the errata for any
|
||||
given release before installing it, to learn about any
|
||||
<quote>late-breaking news</quote> or post-release problems.
|
||||
The errata file accompanying each release (most likely right
|
||||
next to this file) is already out of date by definition, but
|
||||
other copies are kept updated on the Internet and should be
|
||||
consulted as the <quote>current errata</quote> for this
|
||||
release. These other copies of the errata are located at
|
||||
<uri xlink:href="&url.base;/releases/">&url.base;/releases/</uri> (as
|
||||
well as any sites which keep up-to-date mirrors of this
|
||||
location).</para>
|
||||
</note>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Manual Pages</title>
|
||||
|
||||
<para>As with almost all &unix; like operating systems, &os; comes
|
||||
with a set of on-line manual pages, accessed through the
|
||||
&man.man.1; command or through the <link xlink:href="http://www.FreeBSD.org/cgi/man.cgi">hypertext manual
|
||||
pages gateway</link> on the &os; Web site. In general, the
|
||||
manual pages provide information on the different commands and
|
||||
APIs available to the &os; user.</para>
|
||||
|
||||
<para>In some cases, manual pages are written to give
|
||||
information on particular topics. Notable examples of such
|
||||
manual pages are &man.tuning.7; (a guide to performance tuning),
|
||||
&man.security.7; (an introduction to &os; security), and
|
||||
&man.style.9; (a style guide to kernel coding).</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>Books and Articles</title>
|
||||
|
||||
<para>Two highly-useful collections of &os;-related information,
|
||||
maintained by the &os; Project,
|
||||
are the &os; Handbook and &os; FAQ (Frequently Asked
|
||||
Questions document). On-line versions of the <link xlink:href="&url.books.handbook;/">Handbook</link>
|
||||
and <link xlink:href="&url.books.faq;/">FAQ</link>
|
||||
are always available from the <link xlink:href="&url.base;/docs.html">&os; Documentation
|
||||
page</link> or its mirrors. If you install the
|
||||
<filename>doc</filename> distribution set, you can use a Web
|
||||
browser to read the Handbook and FAQ locally. In particular,
|
||||
note that the Handbook contains a step-by-step guide to
|
||||
installing &os;.</para>
|
||||
|
||||
<para>A number of on-line books and articles, also maintained by
|
||||
the &os; Project, cover more-specialized, &os;-related topics.
|
||||
This material spans a wide range of topics, from effective use
|
||||
of the mailing lists, to dual-booting &os; with other
|
||||
operating systems, to guidelines for new committers. Like the
|
||||
Handbook and FAQ, these documents are available from the &os;
|
||||
Documentation Page or in the <filename>doc</filename>
|
||||
distribution set.</para>
|
||||
|
||||
<para>A listing of other books and documents about &os; can be
|
||||
found in the <link xlink:href="&url.books.handbook;/bibliography.html">bibliography</link>
|
||||
of the &os; Handbook. Because of &os;'s strong &unix; heritage,
|
||||
many other articles and books written for &unix; systems are
|
||||
applicable as well, some of which are also listed in the
|
||||
bibliography.</para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="acknowledgements">
|
||||
<title>Acknowledgments</title>
|
||||
|
||||
<para>&os; represents the cumulative work of many hundreds, if not
|
||||
thousands, of individuals from around the world who have worked
|
||||
countless hours to bring about this &release.type;. For a
|
||||
complete list of &os; developers and contributors, please see
|
||||
<link xlink:href="&url.articles.contributors;/"><quote>Contributors
|
||||
to &os;</quote></link> on the &os; Web site or any of its
|
||||
mirrors.</para>
|
||||
|
||||
<para>Special thanks also go to the many thousands of &os; users
|
||||
and testers all over the world, without whom this &release.type;
|
||||
simply would not have been possible.</para>
|
||||
</sect1>
|
||||
</article>
|
||||
@ -1,24 +0,0 @@
|
||||
# $FreeBSD$
|
||||
|
||||
RELN_ROOT?= ${.CURDIR}/../..
|
||||
|
||||
.ifdef NO_LANGCODE_IN_DESTDIR
|
||||
DESTDIR?= ${DOCDIR}/relnotes
|
||||
.else
|
||||
DESTDIR?= ${DOCDIR}/en_US.ISO8859-1/relnotes
|
||||
.endif
|
||||
|
||||
DOC?= article
|
||||
FORMATS?= html
|
||||
INSTALL_COMPRESSED?= gz
|
||||
INSTALL_ONLY_COMPRESSED?=
|
||||
|
||||
JADEFLAGS+= -V %generate-article-toc%
|
||||
|
||||
# SGML content
|
||||
SRCS+= article.xml
|
||||
|
||||
URL_RELPREFIX?= ../../../..
|
||||
|
||||
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
|
||||
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
|
||||
@ -1,402 +0,0 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN"
|
||||
"../../../share/xml/freebsd50.dtd" [
|
||||
<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN" "release.ent">
|
||||
%release;
|
||||
<!ENTITY % sponsor PUBLIC "-//FreeBSD//ENTITIES Sponsor Specification//EN" "sponsor.ent">
|
||||
%sponsor;
|
||||
<!ENTITY % vendor PUBLIC "-//FreeBSD//ENTITIES Vendor Specification//EN" "vendor.ent">
|
||||
%vendor;
|
||||
<!ENTITY security SYSTEM "../../share/xml/security.xml">
|
||||
<!ENTITY errata SYSTEM "../../share/xml/errata.xml">
|
||||
]>
|
||||
<article xmlns="http://docbook.org/ns/docbook"
|
||||
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0">
|
||||
|
||||
<info>
|
||||
<title>&os; &release.current; Release Notes</title>
|
||||
|
||||
<author>
|
||||
<orgname>The &os; Project</orgname>
|
||||
</author>
|
||||
|
||||
<pubdate>$FreeBSD$</pubdate>
|
||||
|
||||
<!-- Last rev: 288943 -->
|
||||
|
||||
<copyright>
|
||||
<year>2016</year>
|
||||
<holder role="mailto:doc@FreeBSD.org">The &os; Documentation
|
||||
Project</holder>
|
||||
</copyright>
|
||||
|
||||
<legalnotice xml:id="trademarks" role="trademarks">
|
||||
&tm-attrib.freebsd;
|
||||
&tm-attrib.ibm;
|
||||
&tm-attrib.ieee;
|
||||
&tm-attrib.intel;
|
||||
&tm-attrib.sparc;
|
||||
&tm-attrib.general;
|
||||
</legalnotice>
|
||||
|
||||
<abstract>
|
||||
<para>The release notes for &os; &release.current; contain
|
||||
a summary of the changes made to the &os; base system on the
|
||||
&release.branch; development line. This document lists
|
||||
applicable security advisories that were issued since the last
|
||||
release, as well as significant changes to the &os; kernel and
|
||||
userland. Some brief remarks on upgrading are also
|
||||
presented.</para>
|
||||
</abstract>
|
||||
</info>
|
||||
|
||||
<sect1 xml:id="intro">
|
||||
<title>Introduction</title>
|
||||
|
||||
<para>This document contains the release notes for &os;
|
||||
&release.current;. It describes recently added, changed, or
|
||||
deleted features of &os;. It also provides some notes on
|
||||
upgrading from previous versions of &os;.</para>
|
||||
|
||||
<para releasetype="current">The &release.type; distribution to
|
||||
which these release notes apply represents the latest point
|
||||
along the &release.branch; development branch since
|
||||
&release.branch; was created. Information regarding pre-built,
|
||||
binary &release.type; distributions along this branch can be
|
||||
found at <uri
|
||||
xlink:href="&release.url;">&release.url;</uri>.</para>
|
||||
|
||||
<para releasetype="snapshot">The &release.type; distribution to
|
||||
which these release notes apply represents a point along the
|
||||
&release.branch; development branch between &release.prev; and
|
||||
the future &release.next;. Information regarding pre-built,
|
||||
binary &release.type; distributions along this branch can be
|
||||
found at <uri
|
||||
xlink:href="&release.url;">&release.url;</uri>.</para>
|
||||
|
||||
<para releasetype="release">This distribution of &os;
|
||||
&release.current; is a &release.type; distribution. It can be
|
||||
found at <uri xlink:href="&release.url;">&release.url;</uri> or
|
||||
any of its mirrors. More information on obtaining this (or
|
||||
other) &release.type; distributions of &os; can be found in the
|
||||
<link
|
||||
xlink:href="&url.books.handbook;/mirrors.html"><quote>Obtaining
|
||||
&os;</quote> appendix</link> to the <link
|
||||
xlink:href="&url.books.handbook;/">&os;
|
||||
Handbook</link>.</para>
|
||||
|
||||
<para>All users are encouraged to consult the release errata
|
||||
before installing &os;. The errata document is updated with
|
||||
<quote>late-breaking</quote> information discovered late in the
|
||||
release cycle or after the release. Typically, it contains
|
||||
information on known bugs, security advisories, and corrections
|
||||
to documentation. An up-to-date copy of the errata for &os;
|
||||
&release.current; can be found on the &os; Web site.</para>
|
||||
|
||||
<para>This document describes the most user-visible new or changed
|
||||
features in &os; since &release.prev;. In general, changes
|
||||
described here are unique to the &release.branch; branch unless
|
||||
specifically marked as &merged; features.</para>
|
||||
|
||||
<para>Typical release note items document recent security
|
||||
advisories issued after &release.prev;, new drivers or hardware
|
||||
support, new commands or options, major bug fixes, or
|
||||
contributed software upgrades. They may also list changes to
|
||||
major ports/packages or release engineering practices. Clearly
|
||||
the release notes cannot list every single change made to &os;
|
||||
between releases; this document focuses primarily on security
|
||||
advisories, user-visible changes, and major architectural
|
||||
improvements.</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="upgrade">
|
||||
<title>Upgrading from Previous Releases of &os;</title>
|
||||
|
||||
<para arch="amd64,i386">Binary upgrades between RELEASE versions
|
||||
(and snapshots of the various security branches) are supported
|
||||
using the &man.freebsd-update.8; utility. The binary upgrade
|
||||
procedure will update unmodified userland utilities, as well as
|
||||
unmodified GENERIC kernels distributed as a part of an official
|
||||
&os; release. The &man.freebsd-update.8; utility requires that
|
||||
the host being upgraded have Internet connectivity.</para>
|
||||
|
||||
<para>Source-based upgrades (those based on recompiling the &os;
|
||||
base system from source code) from previous versions are
|
||||
supported, according to the instructions in
|
||||
<filename>/usr/src/UPDATING</filename>.</para>
|
||||
|
||||
<important>
|
||||
<para>Upgrading &os; should only be attempted after backing up
|
||||
<emphasis>all</emphasis> data and configuration files.</para>
|
||||
</important>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="security-errata">
|
||||
<title>Security and Errata</title>
|
||||
|
||||
<para>This section lists the various Security Advisories and
|
||||
Errata Notices since &release.prev;.</para>
|
||||
|
||||
<sect2 xml:id="security">
|
||||
<title>Security Advisories</title>
|
||||
|
||||
&security;
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="errata">
|
||||
<title>Errata Notices</title>
|
||||
|
||||
&errata;
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="userland">
|
||||
<title>Userland</title>
|
||||
|
||||
<para>This section covers changes and additions to userland
|
||||
applications, contributed software, and system utilities.</para>
|
||||
|
||||
<sect2 xml:id="userland-config">
|
||||
<title>Userland Configuration Changes</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="userland-programs">
|
||||
<title>Userland Application Changes</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="userland-contrib">
|
||||
<title>Contributed Software</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="userland-installer">
|
||||
<title>Installation and Configuration Tools</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="userland-rc">
|
||||
<title><filename class="directory">/etc/rc.d</filename>
|
||||
Scripts</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="userland-periodic">
|
||||
<title><filename class="directory">/etc/periodic</filename>
|
||||
Scripts</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="userland-libraries">
|
||||
<title>Runtime Libraries and API</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="userland-abi">
|
||||
<title>ABI Compatibility</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="kernel">
|
||||
<title>Kernel</title>
|
||||
|
||||
<para>This section covers changes to kernel configurations, system
|
||||
tuning, and system control parameters that are not otherwise
|
||||
categorized.</para>
|
||||
|
||||
<sect2 xml:id="kernel-bugfix">
|
||||
<title>Kernel Bug Fixes</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="kernel-config">
|
||||
<title>Kernel Configuration</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="kernel-sysctl">
|
||||
<title>System Tuning and Controls</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="drivers">
|
||||
<title>Devices and Drivers</title>
|
||||
|
||||
<para>This section covers changes and additions to devices and
|
||||
device drivers since &release.prev;.</para>
|
||||
|
||||
<sect2 xml:id="drivers-device">
|
||||
<title>Device Drivers</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="drivers-storage">
|
||||
<title>Storage Drivers</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="drivers-network">
|
||||
<title>Network Drivers</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="hardware">
|
||||
<title>Hardware Support</title>
|
||||
|
||||
<para>This section covers general hardware support for physical
|
||||
machines, hypervisors, and virtualization environments, as well
|
||||
as hardware changes and updates that do not otherwise fit in
|
||||
other sections of this document.</para>
|
||||
|
||||
<sect2 xml:id="hardware-support">
|
||||
<title>Hardware Support</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="hardware-virtualization">
|
||||
<title>Virtualization Support</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="hardware-arm">
|
||||
<title>ARM Support</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="storage">
|
||||
<title>Storage</title>
|
||||
|
||||
<para>This section covers changes and additions to file systems
|
||||
and other storage subsystems, both local and networked.</para>
|
||||
|
||||
<sect2 xml:id="storage-general">
|
||||
<title>General Storage</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="storage-net">
|
||||
<title>Networked Storage</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="storage-zfs">
|
||||
<title>ZFS</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="storage-geom">
|
||||
<title>&man.geom.4;</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="boot">
|
||||
<title>Boot Loader Changes</title>
|
||||
|
||||
<para>This section covers the boot loader, boot menu, and other
|
||||
boot-related changes.</para>
|
||||
|
||||
<sect2 xml:id="boot-loader">
|
||||
<title>Boot Loader Changes</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="boot-menu">
|
||||
<title>Boot Menu Changes</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="network">
|
||||
<title>Networking</title>
|
||||
|
||||
<para>This section describes changes that affect networking in
|
||||
&os;.</para>
|
||||
|
||||
<sect2 xml:id="network-protocols">
|
||||
<title>Network Protocols</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="ports">
|
||||
<title>Ports Collection and Package Infrastructure</title>
|
||||
|
||||
<para>This section covers changes to the &os; Ports
|
||||
Collection, package infrastructure, and package maintenance and
|
||||
installation tools.</para>
|
||||
|
||||
<sect2 xml:id="ports-infrastructure">
|
||||
<title>Infrastructure Changes</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="ports-packages ">
|
||||
<title>Packaging Changes</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="doc">
|
||||
<title>Documentation</title>
|
||||
|
||||
<para>This section covers changes to the &os; Documentation
|
||||
Project sources and toolchain.</para>
|
||||
|
||||
<sect2 xml:id="doc-sources">
|
||||
<title>Documentation Source Changes</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
|
||||
<sect2 xml:id="doc-toolchain">
|
||||
<title>Documentation Toolchain Changes</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
<sect1 xml:id="releng">
|
||||
<title>Release Engineering and Integration</title>
|
||||
|
||||
<para>This section convers changes that are specific to the
|
||||
&os; Release Engineering processes.</para>
|
||||
|
||||
<sect2 xml:id="releng-changes">
|
||||
<title>Integration Changes</title>
|
||||
|
||||
<para> </para>
|
||||
</sect2>
|
||||
</sect1>
|
||||
</article>
|
||||
@ -1,12 +0,0 @@
|
||||
<?xml version="1.0"?>
|
||||
<!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN"
|
||||
"http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
|
||||
|
||||
<!-- $FreeBSD$ -->
|
||||
|
||||
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
|
||||
<rewriteSystem systemIdStartString="http://www.FreeBSD.org/release/XML/lang/"
|
||||
rewritePrefix="../../"/>
|
||||
<rewriteURI uriStartString="http://www.FreeBSD.org/release/XML/lang/"
|
||||
rewritePrefix="../../"/>
|
||||
</catalog>
|
||||
@ -1,28 +0,0 @@
|
||||
<?xml version="1.0"?>
|
||||
<!-- $FreeBSD$ -->
|
||||
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
||||
version='1.0'
|
||||
xmlns="http://www.w3.org/TR/xhtml1/transitional"
|
||||
xmlns:db="http://docbook.org/ns/docbook"
|
||||
exclude-result-prefixes="db">
|
||||
|
||||
<xsl:param name="release.url"/>
|
||||
<xsl:param name="release.branch"/>
|
||||
<xsl:param name="release.maillist"/>
|
||||
|
||||
<xsl:template name="user.footer.content">
|
||||
<p align="center"><small>This file, and other release-related documents,
|
||||
can be downloaded from <a href="{$release.url}"><xsl:value-of select="$release.url"/></a>.</small></p>
|
||||
|
||||
<p align="center"><small>For questions about FreeBSD, read the
|
||||
<a href="http://www.FreeBSD.org/docs.html">documentation</a> before
|
||||
contacting <<a href="mailto:questions@FreeBSD.org">questions@FreeBSD.org</a>>.</small></p>
|
||||
|
||||
<p align="center"><small>All users of FreeBSD <xsl:value-of select="$release.branch"/> should
|
||||
subscribe to the <<a href="mailto:{$release.maillist}@FreeBSD.org"><xsl:value-of select="$release.maillist"/>@FreeBSD.org</a>>
|
||||
mailing list.</small></p>
|
||||
|
||||
<p align="center"><small>For questions about this documentation,
|
||||
e-mail <<a href="mailto:doc@FreeBSD.org">doc@FreeBSD.org</a>>.</small></p>
|
||||
</xsl:template>
|
||||
</xsl:stylesheet>
|
||||
@ -1,61 +0,0 @@
|
||||
# -*- makefile -*-
|
||||
#
|
||||
# $FreeBSD$
|
||||
#
|
||||
# Sample makefile for rendering and uploading RELNOTESng files outside
|
||||
# the build tree.
|
||||
#
|
||||
|
||||
ARCHS= amd64 i386 powerpc sparc64
|
||||
MULTITEXTS=
|
||||
UNITEXTS= hardware readme relnotes errata
|
||||
|
||||
IMAGEDIR= .imagedir
|
||||
RHOST= freefall.freebsd.org
|
||||
RDIR= public_html/relnotes/CURRENT
|
||||
DOCDIR= ./release/doc
|
||||
LANG= en_US.ISO8859-1
|
||||
|
||||
DOC_PREFIX?= /usr/doc
|
||||
CSS_SHEET?= ${DOC_PREFIX}/share/misc/docbook.css
|
||||
FORMATS?= html txt pdf
|
||||
|
||||
BUILD_OPTIONS+= URLS_ABSOLUTE=YES
|
||||
|
||||
all:
|
||||
(cd ${DOCDIR}; ${MAKE} DOC_PREFIX=${DOC_PREFIX} FORMATS="${FORMATS}" ${BUILD_OPTIONS} all)
|
||||
|
||||
lint:
|
||||
(cd ${DOCDIR}; ${MAKE} DOC_PREFIX=${DOC_PREFIX} lint)
|
||||
|
||||
image: all
|
||||
@echo "#"
|
||||
@echo "# Creating local image"
|
||||
@echo "#"
|
||||
rm -rf ${IMAGEDIR}
|
||||
mkdir ${IMAGEDIR}
|
||||
cp -p ${CSS_SHEET} ${IMAGEDIR}/docbook.css
|
||||
for i in ${ARCHS}; do \
|
||||
for j in ${MULTITEXTS}; do \
|
||||
for k in ${FORMATS}; do \
|
||||
cp -p ${DOCDIR}/${LANG}/$${j}/$${i}/article.$${k} ${IMAGEDIR}/$${j}-$${i}.$${k} ; \
|
||||
done; \
|
||||
done; \
|
||||
done
|
||||
for j in ${UNITEXTS}; do \
|
||||
for k in ${FORMATS}; do \
|
||||
cp -p ${DOCDIR}/${LANG}/$${j}/article.$${k} ${IMAGEDIR}/$${j}.$${k} ; \
|
||||
done; \
|
||||
done
|
||||
|
||||
push: image
|
||||
@echo "#"
|
||||
@echo "# Pushing to ${RHOST}"
|
||||
@echo "#"
|
||||
# (cd ${IMAGEDIR}; tar -cf - .) | gzip -c -9 | (ssh ${RHOST} "( cd ${RDIR}; gunzip -c | tar -xf -)" )
|
||||
(cd ${IMAGEDIR}; rsync -azuv * ${RHOST}:${RDIR})
|
||||
rm -rf ${IMAGEDIR}
|
||||
|
||||
clean:
|
||||
(cd ${DOCDIR}; ${MAKE} DOC_PREFIX=${DOC_PREFIX} FORMATS="${FORMATS}" clean)
|
||||
rm -rf ${IMAGEDIR}
|
||||
@ -1,176 +0,0 @@
|
||||
#
|
||||
# Copyright (c) 2004-2006 The FreeBSD Project
|
||||
# All rights reserved.
|
||||
#
|
||||
# Redistribution and use in source and binary forms, with or without
|
||||
# modification, are permitted provided that the following conditions
|
||||
# are met:
|
||||
# 1. Redistributions of source code must retain the above copyright
|
||||
# notice, this list of conditions and the following disclaimer.
|
||||
# 2. Redistributions in binary form must reproduce the above copyright
|
||||
# notice, this list of conditions and the following disclaimer in the
|
||||
# documentation and/or other materials provided with the distribution.
|
||||
#
|
||||
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
||||
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
# ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
||||
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
# SUCH DAMAGE.
|
||||
#
|
||||
# $FreeBSD$
|
||||
#
|
||||
|
||||
#
|
||||
# This file is used by man2hwnotes.pl to set which drivers are usable
|
||||
# on which architectures.
|
||||
#
|
||||
# Format:
|
||||
#
|
||||
# Empty lines, and lines beginning with "#" are ignored.
|
||||
# <Driver name><tab><arch>[,<arch>...]
|
||||
#
|
||||
aac i386,amd64
|
||||
adv i386,amd64
|
||||
adw i386,amd64
|
||||
aha i386
|
||||
ahb i386
|
||||
ahd i386,sparc64,amd64
|
||||
aic i386,amd64
|
||||
amd i386,amd64
|
||||
arcmsr i386,amd64
|
||||
asr i386
|
||||
ath i386,amd64,sparc64
|
||||
aue i386,amd64,powerpc
|
||||
axe i386,amd64,powerpc
|
||||
bce i386,amd64
|
||||
bge i386,sparc64,amd64
|
||||
bktr i386
|
||||
bt i386,amd64
|
||||
bxe i386,amd64
|
||||
cdce i386,amd64,powerpc
|
||||
ciss i386,amd64
|
||||
ce i386
|
||||
cm i386
|
||||
cnw i386,amd64
|
||||
cp i386
|
||||
ctau i386
|
||||
cue i386,amd64,powerpc
|
||||
cx i386
|
||||
cxgb i386,amd64
|
||||
de i386,amd64
|
||||
dpt i386,amd64
|
||||
ed i386
|
||||
ep i386,amd64
|
||||
esp sparc64
|
||||
ex i386,amd64
|
||||
fe i386,amd64
|
||||
fwohci i386,sparc64,amd64,powerpc
|
||||
hifn i386,amd64
|
||||
hpt27xx i386,amd64
|
||||
hptiop i386,amd64
|
||||
hptmv i386,amd64
|
||||
hptrr i386,amd64
|
||||
ida i386
|
||||
ie i386
|
||||
iir i386,amd64
|
||||
ips i386,amd64
|
||||
isci i386,amd64
|
||||
ixgb i386,amd64
|
||||
kue i386,amd64,powerpc
|
||||
lge i386,amd64
|
||||
mfi i386,amd64
|
||||
mlx i386,amd64
|
||||
mly i386,amd64
|
||||
msk i386,amd64
|
||||
mxge i386,amd64
|
||||
my i386
|
||||
ncr i386,amd64
|
||||
ncv i386
|
||||
nfe i386,amd64
|
||||
ng_bt3c i386,amd64
|
||||
ng_ubt i386,amd64
|
||||
nsp i386
|
||||
nxge i386,amd64
|
||||
oce i386,amd64
|
||||
ohci i386,amd64,powerpc
|
||||
oltr i386
|
||||
otus i386,amd64
|
||||
pcn i386,amd64
|
||||
pst i386
|
||||
qlxgb amd64
|
||||
qlxgbe amd64
|
||||
qlxge amd64
|
||||
rc i386
|
||||
ral i386,amd64
|
||||
rsu i386,amd64
|
||||
rue i386,amd64
|
||||
rum i386,amd64
|
||||
run i386,amd64
|
||||
safe i386,amd64
|
||||
sbp i386,sparc64,amd64
|
||||
sfgxe amd64
|
||||
sn i386,amd64
|
||||
snd_ad1816 i386,amd64
|
||||
snd_als4000 i386
|
||||
snd_atiixp i386,amd64
|
||||
snd_audiocs sparc64
|
||||
snd_cmi i386,amd64
|
||||
snd_cs4281 i386,amd64
|
||||
snd_csa i386,amd64
|
||||
snd_ds1 i386,amd64
|
||||
snd_emu10k1 i386,amd64
|
||||
snd_emu10kx i386,amd64
|
||||
snd_envy24 i386,amd64
|
||||
snd_envy24ht i386,amd64
|
||||
snd_es137x i386,sparc64,amd64
|
||||
snd_ess i386,amd64
|
||||
snd_fm801 i386,amd64
|
||||
snd_gusc i386,amd64
|
||||
snd_hda i386,amd64
|
||||
snd_hdspe i386,amd64
|
||||
snd_ich i386,amd64
|
||||
snd_maestro i386,amd64
|
||||
snd_maestro3 i386,amd64
|
||||
snd_mss i386
|
||||
snd_neomagic i386,amd64
|
||||
snd_sbc i386,amd64
|
||||
snd_solo i386,amd64
|
||||
snd_spicds i386,amd64
|
||||
snd_t4dwave i386,amd64,sparc64
|
||||
snd_via8233 i386,amd64
|
||||
snd_via82c686 i386,amd64
|
||||
snd_vibes i386,amd64
|
||||
stg i386
|
||||
ti i386,amd64,sparc64
|
||||
tl i386,amd64
|
||||
trm i386,amd64
|
||||
twa i386,amd64
|
||||
twe i386,amd64
|
||||
tws i386,amd64
|
||||
ubsa i386,amd64
|
||||
ubsec i386,amd64
|
||||
ubser i386,amd64
|
||||
ucycom i386,amd64
|
||||
udav i386,amd64
|
||||
uftdi i386,amd64
|
||||
uhci i386,amd64,powerpc
|
||||
ulpt i386,amd64,powerpc
|
||||
umass i386,amd64,powerpc
|
||||
umodem i386,amd64
|
||||
uplcom i386,amd64
|
||||
ural i386,amd64
|
||||
urio i386,amd64,powerpc
|
||||
uvisor i386,amd64
|
||||
uvscom i386,amd64
|
||||
vpo i386
|
||||
vx i386,amd64
|
||||
vxge i386,amd64
|
||||
wb i386,amd64
|
||||
xe i386,amd64
|
||||
zyd i386,amd64
|
||||
@ -1,533 +0,0 @@
|
||||
#!/usr/bin/perl -w
|
||||
# Emacs should use -*- cperl -*- mode
|
||||
#
|
||||
# Copyright (c) 2003-2006 Simon L. Nielsen <simon@FreeBSD.org>
|
||||
# All rights reserved.
|
||||
#
|
||||
# Redistribution and use in source and binary forms, with or without
|
||||
# modification, are permitted provided that the following conditions
|
||||
# are met:
|
||||
# 1. Redistributions of source code must retain the above copyright
|
||||
# notice, this list of conditions and the following disclaimer.
|
||||
# 2. Redistributions in binary form must reproduce the above copyright
|
||||
# notice, this list of conditions and the following disclaimer in the
|
||||
# documentation and/or other materials provided with the distribution.
|
||||
#
|
||||
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
||||
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
# ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
||||
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
# SUCH DAMAGE.
|
||||
#
|
||||
# $FreeBSD$
|
||||
#
|
||||
|
||||
# Parse the list of supported hardware out of section 4 manual pages
|
||||
# and output it on stdout as SGML/DocBook entities.
|
||||
|
||||
# The script will look for the following line in the manual page:
|
||||
# .Sh HARDWARE
|
||||
# and make an entity of the content until the line containing:
|
||||
# .Sh
|
||||
#
|
||||
# For Lists only the first line will be printed. If there are
|
||||
# arguments to the .It command, only the argument will be printed.
|
||||
|
||||
# Usage:
|
||||
# man2hwnotes.pl [-cl] [-d 0-6] [-a <archlist file>] [-o <outputfile>]
|
||||
# <manualpage> [<manualpage> ...]
|
||||
|
||||
use strict;
|
||||
use Getopt::Std;
|
||||
use Digest::MD5 qw(md5_hex);
|
||||
|
||||
# Section from manual page to extract
|
||||
my $hwlist_sect = "HARDWARE";
|
||||
|
||||
# Override default archtecture list for some devices:
|
||||
my $archlist_file = "dev.archlist.txt";
|
||||
my %archlist;
|
||||
|
||||
# Globals
|
||||
my $compat_mode = 0; # Enable compat for old Hardware Notes style
|
||||
my $debuglevel = 0;
|
||||
my $only_list_out = 0; # Should only lists be generated in the output?
|
||||
my @out_lines; # Single lines
|
||||
my @out_dev; # Device entities
|
||||
|
||||
# Getopt
|
||||
my %options = ();
|
||||
if (!getopts("a:cd:lo:",\%options)) {
|
||||
die("$!: Invalid command line arguments in ", __LINE__, "\n");
|
||||
}
|
||||
|
||||
if (defined($options{c})) {
|
||||
$compat_mode = 1;
|
||||
}
|
||||
if (defined($options{d})) {
|
||||
$debuglevel = $options{d};
|
||||
}
|
||||
if (defined($options{a})) {
|
||||
$archlist_file = $options{a};
|
||||
}
|
||||
if (defined($options{l})) {
|
||||
$only_list_out = 1;
|
||||
}
|
||||
|
||||
my $outputfile = $options{o};
|
||||
|
||||
if ($debuglevel > 0) {
|
||||
# Don't do output buffering in debug mode.
|
||||
$| = 1;
|
||||
}
|
||||
|
||||
load_archlist($archlist_file);
|
||||
|
||||
if (defined($outputfile)) {
|
||||
open(OLDOUT, ">&STDOUT") || die("$!: Could not open STDOUT in ", __LINE__, ".\n");
|
||||
open(STDOUT, ">$outputfile") || die("$!: Could not open $outputfile in ", __LINE__, ".\n");
|
||||
}
|
||||
|
||||
print <<EOT;
|
||||
<!--
|
||||
These are automatically generated device lists for FreeBSD hardware notes.
|
||||
-->
|
||||
EOT
|
||||
|
||||
if ($only_list_out) {
|
||||
# Print the default device preamble entities
|
||||
print "<!ENTITY hwlist.preamble.pre 'The'>\n";
|
||||
print "<!ENTITY hwlist.preamble.post 'driver supports:'>\n";
|
||||
}
|
||||
|
||||
foreach my $page (@ARGV) {
|
||||
if ($page !~ m/\.4$/) {
|
||||
dlog(2, "Skipped $page (not *.4)");
|
||||
next;
|
||||
}
|
||||
dlog(2, "Parsing $page");
|
||||
parse($page);
|
||||
|
||||
if (@out_lines) {
|
||||
print join("\n", @out_lines), "\n";
|
||||
}
|
||||
if (@out_dev) {
|
||||
print join("\n", @out_dev), "\n";
|
||||
}
|
||||
|
||||
@out_lines = ();
|
||||
@out_dev = ();
|
||||
}
|
||||
|
||||
if (defined($outputfile)) {
|
||||
open(STDOUT, ">&OLDOUT") || die("$!: Could not open STDOUT in ", __LINE__, ".\n");
|
||||
close(OLDOUT) || die("$!: Could not close OLDOUT in ", __LINE__, ".\n");
|
||||
}
|
||||
|
||||
sub normalize (@) {
|
||||
my @lines = @_;
|
||||
|
||||
foreach my $l (@lines) {
|
||||
$l =~ s/\\&//g;
|
||||
$l =~ s:([\x21-\x2f\x5b-\x60\x7b-\x7f]):sprintf("&\#\%d;", ord($1)):eg;
|
||||
# Make sure ampersand is encoded as & since jade seems to
|
||||
# be confused when it is encoded as & inside an entity.
|
||||
$l =~ s/&/&/g;
|
||||
}
|
||||
return (wantarray) ? @lines : join "", @lines;
|
||||
}
|
||||
|
||||
sub parse {
|
||||
my ($manpage) = @_;
|
||||
|
||||
my $cur_mansection;
|
||||
my $found_hwlist = 0;
|
||||
my %mdocvars;
|
||||
$mdocvars{isin_hwlist} = 0;
|
||||
$mdocvars{isin_list} = 0;
|
||||
$mdocvars{first_para} = 1;
|
||||
$mdocvars{parabuf} = "";
|
||||
$mdocvars{listtype} = "";
|
||||
$mdocvars{it_nr} = 0;
|
||||
|
||||
open(MANPAGE, "$manpage") || die("$!: Could not open $manpage in ", __LINE__, ".\n");
|
||||
while(<MANPAGE>) {
|
||||
chomp;
|
||||
my $line = $_;
|
||||
|
||||
dlog(5, "Read '$line'");
|
||||
|
||||
# Find commands
|
||||
if (s/^\.(.*)$/$1/) {
|
||||
my $cmd = $1;
|
||||
|
||||
# Detect, and ignore, comment lines
|
||||
if (s/^\\"(.*)$/$1/) {
|
||||
next;
|
||||
}
|
||||
|
||||
$cmd =~ s/^([^ ]+).*$/$1/;
|
||||
|
||||
if (/^Nm "?(\w+)"?/ && !defined($mdocvars{Nm})) {
|
||||
dlog(3, "Setting Nm to $1");
|
||||
$mdocvars{Nm} = $1;
|
||||
# "_" cannot be used for an entity name.
|
||||
$mdocvars{EntNm} = $1;
|
||||
$mdocvars{EntNm} =~ s,_,.,g;
|
||||
|
||||
} elsif (/^Nm$/) {
|
||||
if (defined($mdocvars{Nm}) && $mdocvars{Nm} ne "") {
|
||||
parabuf_addline(\%mdocvars, "&man.".$mdocvars{EntNm}.".$cur_mansection;");
|
||||
} else {
|
||||
dlog(2, "Warning: Bad Nm call in $manpage");
|
||||
}
|
||||
|
||||
} elsif (/^Sh (.+)$/) {
|
||||
dlog(4, "Setting section to $1");
|
||||
my $cur_section = $1;
|
||||
|
||||
flush_out(\%mdocvars);
|
||||
|
||||
if ($cur_section =~ /^${hwlist_sect}$/) {
|
||||
dlog(2, "Found the device section ${hwlist_sect}");
|
||||
$mdocvars{isin_hwlist} = 1;
|
||||
$found_hwlist = 1;
|
||||
add_sgmltag(\%mdocvars, "<!ENTITY hwlist.".$mdocvars{cur_manname}." '");
|
||||
if ($only_list_out) {
|
||||
add_sgmltag("<para xmlns=\"http://docbook.org/ns/docbook\">&hwlist.preamble.pre; " .
|
||||
"&man.".$mdocvars{EntNm}.".$cur_mansection; " .
|
||||
"&hwlist.preamble.post;</para>");
|
||||
}
|
||||
} elsif ($mdocvars{isin_hwlist}) {
|
||||
dlog(2, "Found a HWLIST STOP key!");
|
||||
add_sgmltag(\%mdocvars, "'>");
|
||||
$mdocvars{isin_hwlist} = 0;
|
||||
}
|
||||
if ($mdocvars{isin_list}) {
|
||||
dlog(1, "Warning: Still in list, but just entered new " .
|
||||
"section. This is probably due to missing .El; " .
|
||||
"check manual page for errors.");
|
||||
# If we try to recover from this we will probably
|
||||
# just end with bad SGML output and it really
|
||||
# should be fixed in the manual page so we don't
|
||||
# even try to "fix" this.
|
||||
}
|
||||
|
||||
|
||||
} elsif (/^Dt ([^ ]+) ([^ ]+)/) {
|
||||
dlog(4, "Setting mansection to $2");
|
||||
$mdocvars{cur_manname} = lc($1);
|
||||
$cur_mansection = $2;
|
||||
|
||||
# "_" cannot be used for an entity name.
|
||||
$mdocvars{cur_manname} =~ s,_,.,g;
|
||||
|
||||
} elsif (/^It ?(.*)$/) {
|
||||
my $txt = $1;
|
||||
|
||||
$mdocvars{it_nr}++;
|
||||
|
||||
# Flush last item
|
||||
if ($mdocvars{parabuf} ne "") {
|
||||
add_listitem(\%mdocvars);
|
||||
}
|
||||
|
||||
# Remove quotes, if any.
|
||||
$txt =~ s/"(.*)"/$1/;
|
||||
|
||||
if ($mdocvars{listtype} eq "column") {
|
||||
# Ignore first item when it is likely to be a
|
||||
# header.
|
||||
if ($mdocvars{it_nr} == 1 && $txt =~ m/^(Em|Sy) /) {
|
||||
dlog(2, "Skipping header line in column list");
|
||||
next;
|
||||
}
|
||||
# Only extract the first column.
|
||||
$txt =~ s/ Ta /\t/g;
|
||||
$txt =~ s/([^\t]+)\t.*/$1/;
|
||||
}
|
||||
|
||||
# Remove Li commands
|
||||
$txt =~ s/^Li //g;
|
||||
|
||||
parabuf_addline(\%mdocvars, normalize($txt));
|
||||
} elsif (/^Bl/) {
|
||||
$mdocvars{isin_list} = 1;
|
||||
flush_out(\%mdocvars);
|
||||
add_sgmltag(\%mdocvars, "<itemizedlist xmlns=\"http://docbook.org/ns/docbook\">");
|
||||
|
||||
if (/-tag/) {
|
||||
$mdocvars{listtype} = "tag";
|
||||
# YACK! Hack for ata(4)
|
||||
if ($mdocvars{Nm} eq "ata") {
|
||||
$mdocvars{listtype} = "tagHACK";
|
||||
}
|
||||
} elsif (/-bullet/) {
|
||||
$mdocvars{listtype} = "bullet";
|
||||
} elsif (/-column/) {
|
||||
$mdocvars{listtype} = "column";
|
||||
} else {
|
||||
$mdocvars{listtype} = "unknown";
|
||||
}
|
||||
dlog(2, "Listtype set to $mdocvars{listtype}");
|
||||
} elsif (/^El/) {
|
||||
if ($mdocvars{parabuf} ne "") {
|
||||
add_listitem(\%mdocvars);
|
||||
}
|
||||
|
||||
add_sgmltag(\%mdocvars, "</itemizedlist>");
|
||||
$mdocvars{isin_list} = 0;
|
||||
} elsif (/^Tn (.+)$/) {
|
||||
# For now we print TradeName text as regular text.
|
||||
my ($txt, $punct_str) = split_punct_chars($1);
|
||||
|
||||
parabuf_addline(\%mdocvars, normalize($txt . $punct_str));
|
||||
} elsif (/^Xr ([^ ]+) (.+)$/) {
|
||||
my ($xr_sect, $punct_str) = split_punct_chars($2);
|
||||
my $txt;
|
||||
|
||||
# We need to check if the manual page exist to avoid
|
||||
# breaking the doc build just because of a broken
|
||||
# reference.
|
||||
#$txt = "&man.$1.$xr_sect;$punct_str";
|
||||
$txt = "$1($xr_sect)$punct_str";
|
||||
parabuf_addline(\%mdocvars, normalize($txt));
|
||||
} elsif (/^Dq (.+)$/) {
|
||||
my ($txt, $punct_str) = split_punct_chars($1);
|
||||
|
||||
parabuf_addline(\%mdocvars,
|
||||
normalize("<quote xmlns=\"http://docbook.org/ns/docbook\">$txt</quote>$punct_str"));
|
||||
} elsif (/^Sx (.+)$/) {
|
||||
if ($mdocvars{isin_hwlist}) {
|
||||
dlog(1, "Warning: Reference to another section in the " .
|
||||
"$hwlist_sect section in " . $mdocvars{Nm} .
|
||||
"(${cur_mansection})");
|
||||
}
|
||||
parabuf_addline(\%mdocvars, normalize($1));
|
||||
} elsif (/^Pa (.+)$/) {
|
||||
my ($txt, $punct_str) = split_punct_chars($1);
|
||||
|
||||
$txt = make_ulink($txt) . $punct_str;
|
||||
parabuf_addline(\%mdocvars, normalize($txt));
|
||||
} elsif (/^Pp/) {
|
||||
dlog(3, "Got Pp command - forcing new para");
|
||||
flush_out(\%mdocvars);
|
||||
} elsif (/^Fx (.+)/) {
|
||||
dlog(3, "Got Fx command");
|
||||
parabuf_addline(\%mdocvars, "FreeBSD $1");
|
||||
} elsif (/^Fx/) {
|
||||
dlog(3, "Got Fx command");
|
||||
parabuf_addline(\%mdocvars, "FreeBSD");
|
||||
} elsif (/^Em (.+)$/) {
|
||||
my ($txt, $punct_str) = split_punct_chars($1);
|
||||
|
||||
parabuf_addline(\%mdocvars,
|
||||
normalize("<emphasis xmlns=\"http://docbook.org/ns/docbook\">$txt</emphasis>$punct_str"));
|
||||
} else {
|
||||
# Ignore all other commands.
|
||||
dlog(3, "Ignoring unknown command $cmd");
|
||||
}
|
||||
} else {
|
||||
# This is then regular text
|
||||
parabuf_addline(\%mdocvars, normalize($_));
|
||||
}
|
||||
}
|
||||
close(MANPAGE) || die("$!: Could not close $manpage in ", __LINE__, ".\n");
|
||||
if (! $found_hwlist) {
|
||||
dlog(2, "Hardware list not found in $manpage");
|
||||
}
|
||||
}
|
||||
|
||||
sub dlog {
|
||||
my ($level, $txt) = @_;
|
||||
|
||||
if ($level <= $debuglevel) {
|
||||
print STDERR "$level: $txt\n";
|
||||
}
|
||||
}
|
||||
|
||||
# Output a SGML tag.
|
||||
sub add_sgmltag {
|
||||
my ($mdocvars, $txt) = (@_);
|
||||
|
||||
# We only care about the HW list for now.
|
||||
if (${$mdocvars}{isin_hwlist}) {
|
||||
push(@out_dev, $txt);
|
||||
}
|
||||
}
|
||||
|
||||
# Add a text entity, and return the used entity name.
|
||||
sub add_txt_ent {
|
||||
my ($itemtxt) = (@_);
|
||||
my ($entity_name);
|
||||
|
||||
# Convert mdoc(7) minus
|
||||
$itemtxt =~ s/\\-/-/g;
|
||||
|
||||
$itemtxt =~ s/'/‘/g;
|
||||
|
||||
$entity_name = "hwlist." . md5_hex($itemtxt);
|
||||
dlog(4, "Adding '$itemtxt' as entity $entity_name");
|
||||
push(@out_lines, "<!ENTITY $entity_name '$itemtxt'>");
|
||||
|
||||
return ($entity_name);
|
||||
}
|
||||
sub flush_out {
|
||||
my ($mdocvars) = (@_);
|
||||
my ($entity_name, $out);
|
||||
my $para_arch = "";
|
||||
|
||||
if (!${$mdocvars}{isin_hwlist} || ${$mdocvars}{parabuf} eq "") {
|
||||
return;
|
||||
}
|
||||
|
||||
$entity_name = add_txt_ent(${$mdocvars}{parabuf});
|
||||
${$mdocvars}{parabuf} = "";
|
||||
if(defined($archlist{${$mdocvars}{Nm}})) {
|
||||
if ($compat_mode) {
|
||||
$para_arch = ' arch="' . $archlist{${$mdocvars}{Nm}} . '"';
|
||||
} else {
|
||||
$para_arch = '[' . $archlist{${$mdocvars}{Nm}} . '] ';
|
||||
}
|
||||
}
|
||||
if ($compat_mode) {
|
||||
$out = "<para xmlns=\"http://docbook.org/ns/docbook\"".$para_arch.">&".$entity_name.";</para>";
|
||||
} else {
|
||||
if (${$mdocvars}{first_para}) {
|
||||
$out = "<para xmlns=\"http://docbook.org/ns/docbook\">".$para_arch."&".$entity_name.";</para>";
|
||||
} else {
|
||||
$out = "<para xmlns=\"http://docbook.org/ns/docbook\">&".$entity_name.";</para>";
|
||||
}
|
||||
${$mdocvars}{first_para} = 0;
|
||||
}
|
||||
|
||||
dlog(4, "Flushing parabuf");
|
||||
add_sgmltag($mdocvars, $out);
|
||||
}
|
||||
|
||||
# Add a new list item from the "parabuf".
|
||||
sub add_listitem {
|
||||
my ($mdocvars) = (@_);
|
||||
my ($listitem, $entity_name);
|
||||
my $para_arch = "";
|
||||
|
||||
$entity_name = add_txt_ent(${$mdocvars}{parabuf});
|
||||
${$mdocvars}{parabuf} = "";
|
||||
|
||||
if ($compat_mode) {
|
||||
if(defined($archlist{${$mdocvars}{Nm}})) {
|
||||
$para_arch = ' arch="' . $archlist{${$mdocvars}{Nm}} . '"';
|
||||
}
|
||||
}
|
||||
$listitem = "<listitem><para".$para_arch.">&".$entity_name.";</para></listitem>";
|
||||
dlog(4, "Adding '$listitem' to out_dev");
|
||||
push(@out_dev, $listitem);
|
||||
|
||||
}
|
||||
|
||||
# Add a line to the "paragraph buffer"
|
||||
sub parabuf_addline {
|
||||
my $mdocvars = shift;
|
||||
my ($txt) = (@_);
|
||||
|
||||
dlog(5, "Now in parabuf_addline for '$txt'");
|
||||
|
||||
# We only care about the HW list for now.
|
||||
if (!${$mdocvars}{isin_hwlist}) {
|
||||
dlog(6, "Exiting parabuf_addline due to: !\${\$mdocvars}{isin_hwlist}");
|
||||
return;
|
||||
}
|
||||
if ($txt eq "") {
|
||||
dlog(6, "Exiting parabuf_addline due to: \$txt eq \"\"");
|
||||
return;
|
||||
}
|
||||
|
||||
if ($only_list_out && !${$mdocvars}{isin_list}) {
|
||||
dlog(6, "Exiting parabuf_addline due to: ".
|
||||
"\$only_list_out && !\${\$mdocvars}{isin_list}");
|
||||
return;
|
||||
}
|
||||
|
||||
# We only add the first line for "tag" lists
|
||||
if (${$mdocvars}{parabuf} ne "" && ${$mdocvars}{isin_list} &&
|
||||
${$mdocvars}{listtype} eq "tag") {
|
||||
dlog(6, "Exiting parabuf_addline due to: ".
|
||||
"\${\$mdocvars}{parabuf} ne \"\" && \${\$mdocvars}{isin_list} && ".
|
||||
"\${\$mdocvars}{listtype} eq \"tag\"");
|
||||
return;
|
||||
}
|
||||
|
||||
if (${$mdocvars}{parabuf} ne "") {
|
||||
${$mdocvars}{parabuf} .= " ";
|
||||
}
|
||||
|
||||
dlog(4, "Adding '$txt' to parabuf");
|
||||
|
||||
${$mdocvars}{parabuf} .= $txt;
|
||||
}
|
||||
|
||||
sub load_archlist {
|
||||
my ($file) = (@_);
|
||||
|
||||
my $lineno = 0;
|
||||
|
||||
dlog(2, "Parsing archlist $file");
|
||||
|
||||
open(FILE, "$file") || die("$!: Could not open archlist $file in ", __LINE__, ".\n");
|
||||
while(<FILE>) {
|
||||
chomp;
|
||||
$lineno++;
|
||||
|
||||
if (/^#/ || $_ eq "") {
|
||||
next;
|
||||
}
|
||||
|
||||
if (/(\w+)\t([\w,]+)/) {
|
||||
dlog(4, "For driver $1 setting arch to $2");
|
||||
$archlist{$1} = $2;
|
||||
} else {
|
||||
dlog(1, "Warning: Could not parse archlist line $lineno");
|
||||
}
|
||||
}
|
||||
|
||||
close(FILE);
|
||||
}
|
||||
|
||||
# Check if a character is a mdoc(7) punctuation character.
|
||||
sub is_punct_char {
|
||||
my ($str) = (@_);
|
||||
|
||||
return (length($str) == 1 && $str =~ /[\.,:;()\[\]\?!]/);
|
||||
}
|
||||
|
||||
# Split out the punctuation characters of a mdoc(7) line.
|
||||
sub split_punct_chars {
|
||||
my ($str) = (@_);
|
||||
my (@stritems, $stritem, $punct_str);
|
||||
|
||||
$punct_str = "";
|
||||
@stritems = split(/ /, $str);
|
||||
|
||||
while (defined($stritem = $stritems[$#stritems]) &&
|
||||
is_punct_char($stritem)) {
|
||||
$punct_str = $stritem . $punct_str;
|
||||
pop(@stritems);
|
||||
}
|
||||
|
||||
return (join(' ', @stritems), $punct_str);
|
||||
}
|
||||
|
||||
# Create a ulink, if the string contains an URL.
|
||||
sub make_ulink {
|
||||
my ($str) = (@_);
|
||||
|
||||
$str =~ s,(http://[^ ]+),<link xmlns=\"http://docbook.org/ns/docbook\" xlink:href="$1"></link>,;
|
||||
|
||||
return $str;
|
||||
}
|
||||
@ -1,54 +0,0 @@
|
||||
# $FreeBSD$
|
||||
|
||||
DOC_PREFIX?= ${RELN_ROOT}/../../../doc
|
||||
|
||||
# XXX
|
||||
RELEASETYPE!= grep -o 'release.type "[a-z]*"' ${RELN_ROOT}/share/xml/release.ent | sed 's|[a-z.]* "\([a-z]*\)"|\1|'
|
||||
RELEASEURL!= grep -o 'release.url \"[^\"]*\"' ${RELN_ROOT}/share/xml/release.ent | sed 's|[^ ]* "\([^"]*\)"|\1|'
|
||||
RELEASEBRANCH!= grep -o 'release.branch "\([^"]*\)"' ${RELN_ROOT}/share/xml/release.ent | sed 's|[^ ]* "\([^"]*\)"|\1|'
|
||||
RELEASEMAILLIST!= grep -o 'release.maillist "\([^"]*\)"' ${RELN_ROOT}/share/xml/release.ent | sed 's|[^ ]* "\([^"]*\)"|\1|'
|
||||
.if ${RELEASETYPE} == "current"
|
||||
PROFILING+= --param profile.attribute "'releasetype'" --param profile.value "'current'"
|
||||
.elif ${RELEASETYPE} == "snapshot"
|
||||
PROFILING+= --param profile.attribute "'releasetype'" --param profile.value "'snapshot'"
|
||||
.elif ${RELEASETYPE} == "release"
|
||||
PROFILING+= --param profile.attribute "'releasetype'" --param profile.value "'release'"
|
||||
.endif
|
||||
XSLTPROCFLAGS+= --param release.url "'${RELEASEURL}'"
|
||||
XSLTPROCFLAGS+= --param release.branch "'${RELEASEBRANCH}'"
|
||||
XSLTPROCFLAGS+= --param release.maillist "'${RELEASEMAILLIST}'"
|
||||
XSLTPROCFLAGS+= --param toc.section.depth "'3'"
|
||||
|
||||
# Find the RELNOTESng document catalogs
|
||||
EXTRA_CATALOGS+= file://${RELN_ROOT}/${LANGCODE}/share/xml/catalog.xml \
|
||||
file://${RELN_ROOT}/share/xml/catalog.xml
|
||||
|
||||
XSLXHTML= http://www.FreeBSD.org/release/XML/share/xml/release.xsl
|
||||
|
||||
#
|
||||
# Automatic device list generation:
|
||||
#
|
||||
.if exists(${RELN_ROOT}/../man4)
|
||||
MAN4DIR?= ${RELN_ROOT}/../man4
|
||||
.elif exists(${RELN_ROOT}/../../man4)
|
||||
MAN4DIR?= ${RELN_ROOT}/../../man4
|
||||
.else
|
||||
MAN4DIR?= ${RELN_ROOT}/../../share/man/man4
|
||||
.endif
|
||||
MAN4PAGES?= ${MAN4DIR}/*.4 ${MAN4DIR}/man4.*/*.4
|
||||
ARCHLIST?= ${RELN_ROOT}/share/misc/dev.archlist.txt
|
||||
DEV-AUTODIR= ${RELN_ROOT:S/${.CURDIR}/${.OBJDIR}/}/share/xml
|
||||
CLEANFILES+= ${DEV-AUTODIR}/dev-auto.ent
|
||||
|
||||
MAN2HWNOTES_CMD=${RELN_ROOT}/share/misc/man2hwnotes.pl
|
||||
.if defined(HWNOTES_MI)
|
||||
MAN2HWNOTES_FLAGS=
|
||||
.else
|
||||
MAN2HWNOTES_FLAGS= -c
|
||||
.endif
|
||||
|
||||
# Dependency that the article makefiles can use to pull in
|
||||
# dev-auto.ent.
|
||||
${DEV-AUTODIR}/catalog-auto ${DEV-AUTODIR}/dev-auto.ent: ${MAN4PAGES} \
|
||||
${ARCHLIST} ${MAN2HWNOTES_CMD}
|
||||
cd ${RELN_ROOT}/share/xml && make MAN2HWNOTES_FLAGS=${MAN2HWNOTES_FLAGS} dev-auto.ent
|
||||
@ -1,11 +0,0 @@
|
||||
# $FreeBSD$
|
||||
|
||||
RELN_ROOT?= ${.CURDIR}/../..
|
||||
|
||||
.include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
|
||||
.include "${DOC_PREFIX}/share/mk/doc.project.mk"
|
||||
|
||||
dev-auto.ent: ${MAN4PAGES} ${ARCHLIST} ${MAN2HWNOTES_CMD}
|
||||
${PERL} ${MAN2HWNOTES_CMD} ${MAN2HWNOTES_FLAGS} -a ${ARCHLIST} -o ${.TARGET} ${MAN4PAGES}
|
||||
|
||||
all: dev-auto.ent
|
||||
@ -1,13 +0,0 @@
|
||||
<?xml version="1.0"?>
|
||||
<!-- $FreeBSD$ -->
|
||||
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
|
||||
<rewriteSystem systemIdStartString="http://www.FreeBSD.org/release/XML/"
|
||||
rewritePrefix="../../"/>
|
||||
<rewriteURI uriStartString="http://www.FreeBSD.org/release/XML/"
|
||||
rewritePrefix="../../"/>
|
||||
|
||||
<public publicId="-//FreeBSD//ENTITIES Release Specification//EN" uri="release.ent"/>
|
||||
<public publicId="-//FreeBSD//ENTITIES Sponsor Specification//EN" uri="sponsor.ent"/>
|
||||
<public publicId="-//FreeBSD//ENTITIES Vendor Specification//EN" uri="vendor.ent"/>
|
||||
<public publicId="-//FreeBSD//ENTITIES Auto Generated Device Lists//EN" uri="dev-auto.ent"/>
|
||||
</catalog>
|
||||
@ -1,28 +0,0 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!--
|
||||
The FreeBSD Documentation Project
|
||||
|
||||
$FreeBSD$
|
||||
-->
|
||||
<informaltable frame="none" pgwide="1">
|
||||
<tgroup cols="3">
|
||||
<colspec colwidth="40%"/>
|
||||
<colspec colwidth="30%"/>
|
||||
<colspec colwidth="30%"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Errata</entry>
|
||||
<entry>Date</entry>
|
||||
<entry>Topic</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry><para>No errata notices.</para></entry>
|
||||
<entry><para> </para></entry>
|
||||
<entry><para> </para></entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
@ -1,81 +0,0 @@
|
||||
<!-- -*- sgml -*-
|
||||
|
||||
$FreeBSD$
|
||||
|
||||
OS Release Information -->
|
||||
|
||||
<!-- Version of the OS we're describing. This needs to be updated
|
||||
with each new release. -->
|
||||
<!ENTITY release.current "12.0-CURRENT">
|
||||
|
||||
<!-- The previous version used for comparison in the "What's New"
|
||||
section. For -CURRENT, we might point back to the last
|
||||
branchpoint. -->
|
||||
<!ENTITY release.prev "11.0-RELEASE">
|
||||
|
||||
<!-- The previous stable release, useful for pointing user's at the
|
||||
release they SHOULD be running if they don't want the bleeding
|
||||
edge. -->
|
||||
<!ENTITY release.prev.stable "10.3-RELEASE">
|
||||
|
||||
<!-- The next version to be released, usually used for snapshots. -->
|
||||
<!ENTITY release.next "12.0-RELEASE">
|
||||
|
||||
<!-- The name of this branch. -->
|
||||
<!ENTITY release.branch "12-CURRENT">
|
||||
|
||||
<!-- The URL for obtaining this version of FreeBSD. -->
|
||||
<!ENTITY release.url "https://www.FreeBSD.org/snapshots/">
|
||||
|
||||
<!-- The URL for Security Advisories and Errata Notices. -->
|
||||
<!ENTITY security.url "https://www.FreeBSD.org/security/advisories">
|
||||
|
||||
<!-- The recommended mailing list to track. -->
|
||||
<!ENTITY release.maillist "current">
|
||||
|
||||
<!-- The type of release (usually this will be either "snapshot"
|
||||
or "release" -->
|
||||
<!-- WARNING: Do not forget to also change the release type in
|
||||
doc.relnotes.mk when updating this -->
|
||||
<!ENTITY release.type "snapshot">
|
||||
<!ENTITY % release.type.current "INCLUDE">
|
||||
<!ENTITY % release.type.snapshot "IGNORE">
|
||||
<!ENTITY % release.type.release "IGNORE">
|
||||
|
||||
<![%release.type.current;[
|
||||
<!ENTITY release '&release.current;'>
|
||||
]]>
|
||||
<![%release.type.snapshot;[
|
||||
<!ENTITY release '&release.prev;'>
|
||||
]]>
|
||||
<![%release.type.release;[
|
||||
<!ENTITY release '&release.current;'>
|
||||
]]>
|
||||
<!ENTITY release ''>
|
||||
|
||||
<!-- The manpaths for man page references -->
|
||||
<!ENTITY release.man.url "https://www.FreeBSD.org/cgi/man.cgi">
|
||||
<!ENTITY release.manpath.xorg "7.5.1">
|
||||
<!ENTITY release.manpath.netbsd "5.1">
|
||||
<!ENTITY release.manpath.freebsd-ports "Ports">
|
||||
<!ENTITY release.manpath.freebsd "10-current">
|
||||
|
||||
<!-- Text constants which probably don't need to be changed.-->
|
||||
|
||||
<!-- Name of our OS. This is almost certainly going to remain
|
||||
FreeBSD, but we might want to try to do some other formatting or
|
||||
other fancy markup on it in the future. -->
|
||||
<!ENTITY os "FreeBSD">
|
||||
|
||||
<!-- Architecture names -->
|
||||
<!ENTITY arch.amd64 "amd64">
|
||||
<!ENTITY arch.arm "arm">
|
||||
<!ENTITY arch.arm64 "aarch64">
|
||||
<!ENTITY arch.i386 "i386">
|
||||
<!ENTITY arch.mips "mips">
|
||||
<!ENTITY arch.powerpc "powerpc">
|
||||
<!ENTITY arch.powerpc64 "powerpc64">
|
||||
<!ENTITY arch.sparc64 "sparc64">
|
||||
|
||||
<!-- The marker for MFCs. -->
|
||||
<!ENTITY merged "MERGED">
|
||||
@ -1,106 +0,0 @@
|
||||
<?xml version="1.0"?>
|
||||
<!-- $FreeBSD$ -->
|
||||
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
||||
version='1.0'
|
||||
xmlns="http://www.w3.org/TR/xhtml1/transitional"
|
||||
xmlns:db="http://docbook.org/ns/docbook"
|
||||
exclude-result-prefixes="db">
|
||||
|
||||
<xsl:import href="http://www.FreeBSD.org/XML/share/xml/freebsd-xhtml.xsl"/>
|
||||
|
||||
<xsl:import href="http://www.FreeBSD.org/release/XML/lang/share/xml/release.xsl"/>
|
||||
|
||||
<xsl:param name="release.url"/>
|
||||
<xsl:param name="release.branch"/>
|
||||
<xsl:param name="release.maillist"/>
|
||||
|
||||
<xsl:template name="paragraph">
|
||||
<xsl:param name="class" select="''"/>
|
||||
<xsl:param name="content"/>
|
||||
|
||||
<xsl:variable name="p">
|
||||
<p>
|
||||
<xsl:choose>
|
||||
<xsl:when test="$class != ''">
|
||||
<xsl:call-template name="common.html.attributes">
|
||||
<xsl:with-param name="class" select="$class"/>
|
||||
</xsl:call-template>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:call-template name="locale.html.attributes"/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
<xsl:if test="@arch">
|
||||
<xsl:value-of select="concat('[', @arch, ']')"/>
|
||||
<xsl:value-of select='" "'/>
|
||||
</xsl:if>
|
||||
<xsl:copy-of select="$content"/>
|
||||
<xsl:value-of select='" "'/>
|
||||
<xsl:if test="@revision">
|
||||
<xsl:element name="a">
|
||||
<xsl:attribute name="href">
|
||||
<xsl:value-of select="concat('http://svn.freebsd.org/viewvc/base?view=revision&revision=', @revision)"/>
|
||||
</xsl:attribute>
|
||||
<xsl:value-of select="concat('[r', @revision, ']')"/>
|
||||
</xsl:element>
|
||||
</xsl:if>
|
||||
<xsl:if test="@contrib">
|
||||
<xsl:element name="span">
|
||||
<xsl:attribute name="class">
|
||||
<xsl:value-of select="'contrib'"/>
|
||||
</xsl:attribute>
|
||||
<xsl:choose>
|
||||
<xsl:when test="@contrib = 'sponsor'">
|
||||
<xsl:if test="@sponsor != ''">
|
||||
(Sponsored by
|
||||
<xsl:choose>
|
||||
<xsl:when test="@sponsorurl != ''">
|
||||
<xsl:element name="a">
|
||||
<xsl:attribute name="href">
|
||||
<xsl:value-of select="@sponsorurl"/>
|
||||
</xsl:attribute>
|
||||
<xsl:value-of select="concat(@sponsor, ')')"/>
|
||||
</xsl:element>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:value-of select="concat(@sponsor, ')')"/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:if>
|
||||
</xsl:when>
|
||||
<xsl:when test="@contrib = 'vendor'">
|
||||
<xsl:if test="@vendor != ''">
|
||||
(Contributed / provided by
|
||||
<xsl:choose>
|
||||
<xsl:when test="@vendorurl != ''">
|
||||
<xsl:element name="a">
|
||||
<xsl:attribute name="href">
|
||||
<xsl:value-of select="@vendorurl"/>
|
||||
</xsl:attribute>
|
||||
<xsl:value-of select="concat(@vendor, ')')"/>
|
||||
</xsl:element>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:value-of select="concat(@vendor, ')')"/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:if>
|
||||
</xsl:when>
|
||||
</xsl:choose>
|
||||
</xsl:element>
|
||||
</xsl:if>
|
||||
</p>
|
||||
</xsl:variable>
|
||||
|
||||
<xsl:choose>
|
||||
<xsl:when test="$html.cleanup != 0">
|
||||
<xsl:call-template name="unwrap.p">
|
||||
<xsl:with-param name="p" select="$p"/>
|
||||
</xsl:call-template>
|
||||
</xsl:when>
|
||||
<xsl:otherwise>
|
||||
<xsl:copy-of select="$p"/>
|
||||
</xsl:otherwise>
|
||||
</xsl:choose>
|
||||
</xsl:template>
|
||||
</xsl:stylesheet>
|
||||
@ -1,28 +0,0 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!--
|
||||
The FreeBSD Documentation Project
|
||||
|
||||
$FreeBSD$
|
||||
-->
|
||||
<informaltable frame="none" pgwide="1">
|
||||
<tgroup cols="3">
|
||||
<colspec colwidth="40%"/>
|
||||
<colspec colwidth="30%"/>
|
||||
<colspec colwidth="30%"/>
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Advisory</entry>
|
||||
<entry>Date</entry>
|
||||
<entry>Topic</entry>
|
||||
</row>
|
||||
</thead>
|
||||
|
||||
<tbody>
|
||||
<row>
|
||||
<entry><para>No advisories.</para></entry>
|
||||
<entry><para> </para></entry>
|
||||
<entry><para> </para></entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
@ -1,56 +0,0 @@
|
||||
<!-- -*- sgml -*-
|
||||
|
||||
$FreeBSD$
|
||||
|
||||
Sponsors of various works.
|
||||
|
||||
Please keep the entity list sorted alphabetically.
|
||||
|
||||
-->
|
||||
|
||||
<!ENTITY abt "ABT Systems, Ltd.">
|
||||
<!ENTITY afrl "AFRL">
|
||||
|
||||
<!ENTITY cavium "Cavium">
|
||||
<!ENTITY chelsio "Chelsio Communications">
|
||||
|
||||
<!ENTITY citrix "Citrix Systems">
|
||||
<!ENTITY citrix.rd "Citrix Systems R&D">
|
||||
|
||||
<!ENTITY clusterhq "ClusterHQ">
|
||||
|
||||
<!ENTITY darpa "DARPA">
|
||||
<!ENTITY darpa_afrl "DARPA, AFRL">
|
||||
<!ENTITY dell "Dell, Inc.">
|
||||
|
||||
<!ENTITY emcisilon "EMC / Isilon Storage Division">
|
||||
|
||||
<!ENTITY ff "The &os; Foundation">
|
||||
<!ENTITY ff.url "https://www.FreeBSDFoundation.org/">
|
||||
|
||||
<!ENTITY gandi "Gandi.net">
|
||||
<!ENTITY google "Google">
|
||||
|
||||
<!ENTITY juniper "Juniper Networks, Inc.">
|
||||
|
||||
<!ENTITY intelcorp "Intel Corporation">
|
||||
<!ENTITY ix "iXsystems">
|
||||
|
||||
<!ENTITY limelight "Limelight Networks">
|
||||
<!ENTITY lsi "LSI">
|
||||
|
||||
<!ENTITY msostc "Microsoft Open Source Technology Center">
|
||||
<!ENTITY mitail "MIT Computer Science & Artificial Intelligence Laboratory">
|
||||
<!ENTITY multiplay "Multiplay">
|
||||
|
||||
<!ENTITY netflix "Netflix">
|
||||
<!ENTITY netgate "Netgate">
|
||||
<!ENTITY nginx "Nginx, Inc.">
|
||||
<!ENTITY norse "Norse Corporation">
|
||||
|
||||
<!ENTITY sandvine "Sandvine, Inc.">
|
||||
<!ENTITY scaleengine "ScaleEngine, Inc.">
|
||||
<!ENTITY solarflare "Solarflare Communications, Inc.">
|
||||
<!ENTITY spectralogic "Spectra Logic">
|
||||
|
||||
<!ENTITY yandex "Yandex LLC">
|
||||
@ -1,9 +0,0 @@
|
||||
<!-- -*- sgml -*-
|
||||
|
||||
$FreeBSD$
|
||||
|
||||
Vendors and contributors.
|
||||
|
||||
Please keep the entity list sorted alphabetically.
|
||||
|
||||
-->
|
||||
Loading…
Reference in New Issue
Block a user