<feed xmlns='http://www.w3.org/2005/Atom'>
<title>doc/en/handbook/introduction/chapter.sgml, branch LINUXDOC_2_DOCBOOK_2</title>
<subtitle>FreeBSD documentation tree</subtitle>
<link rel='alternate' type='text/html' href='http://cgit.freebsd.org/doc/'/>
<entry>
<title>Create tag 'LINUXDOC_2_DOCBOOK_2'.</title>
<updated>1998-12-08T22:09:05+00:00</updated>
<author>
<name>Doc Manager</name>
<email>doceng@FreeBSD.org</email>
</author>
<published>1998-12-08T22:09:05+00:00</published>
<link rel='alternate' type='text/html' href='http://cgit.freebsd.org/doc/commit/?id=9e84804a90caa6750ac2580f85ae23df3d540747'/>
<id>9e84804a90caa6750ac2580f85ae23df3d540747</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>Merged in the following changes. This was done by taking diffs between the</title>
<updated>1998-11-12T01:26:39+00:00</updated>
<author>
<name>Nik Clayton</name>
<email>nik@FreeBSD.org</email>
</author>
<published>1998-11-12T01:26:39+00:00</published>
<link rel='alternate' type='text/html' href='http://cgit.freebsd.org/doc/commit/?id=276c9344d5e936829b18cdc753dbe6cfe5ba9e00'/>
<id>276c9344d5e936829b18cdc753dbe6cfe5ba9e00</id>
<content type='text'>
tags LINUXDOC_2_DOCBOOK_START and LINUXDOC_2_DOCBOOK from doc/handbook/.

Note that the LINUXDOC_2_DOCBOOK tag is not necessarily at the HEAD of
the file. So some files won't show changes because changes were applied
after I laid down the LINUXDOC_2_DOCBOOK tag.

Not everything was merged. In some cases, URLs had been shortened;

    http://www.freebsd.org/docproj/

becomes

     ../docproj/

This is a mistake, since users browsing the Handbook on their own machine
can't be expected to have links like this work. Of course, for mirrors,
they'll end up pointing back to the main site. For the mean time, do
nothing -- this will need an entity defined to reference the base URL
of the FreeBSD site, individual mirrors can set this as necessary.

Notice how some files (on the left) are merged to the same file (on
the right). This is because the new Handbook file structure is organised
on DocBook chapter lines.

Files with no revision number in the "From" column didn't exist when I
started the conversion.

File                 From  -&gt;  To      Merged to files...
---------------------------------------------------------------
anoncvs.sgml               -&gt;  1.1     cutting-edge/chapter.sgml
authors.sgml         1.93  -&gt;  1.118   authors.ent
backups.sgml               -&gt;  1.4     backups/chapter.sgml
bibliography.sgml    1.33  -&gt;  1.37    bibliography/chapter.sgml
contrib.sgml         1.274 -&gt;  1.312   staff/chapter.sgml
ctm.sgml             1.22  -&gt;  1.23    cutting-edge/chapter.sgml
cvsup.sgml           1.36  -&gt;  1.40    cutting-edge/chapter.sgml
disks.sgml                 -&gt;  1.3     disks/chapter.sgml
eresources.sgml      1.39  -&gt;  1.50    eresources/chapter.sgml
firewalls.sgml       1.19  -&gt;  1.20    security/chapter.sgml
handbook.sgml        1.83  -&gt;  1.91    handbook.sgml
history.sgml         1.24  -&gt;  1.25    introduction/chapter.sgml
install.sgml         1.65  -&gt;  1.67    install/chapter.sgml
isdn.sgml            1.12  -&gt;  1.15    advanced-networking/chapter.sgml
kerberos.sgml        1.12  -&gt;  1.13    security/chapter.sgml
kernelconfig.sgml    1.31  -&gt;  1.32    kernelconfig/chapter.sgml
kerneldebug.sgml     1.17  -&gt;  1.19    kerneldebug/chapter.sgml
linuxemu.sgml        1.22  -&gt;  1.24    linuxemu/chapter.sgml
memoryuse.sgml       1.11  -&gt;  1.12    internals/chapter.sgml
mirrors.sgml         1.80  -&gt;  1.92    mirrors/chapter.sgml
nutshell.sgml        1.14  -&gt;  1.15    introduction/chapter.sgml
pgpkeys.sgml         1.25  -&gt;  1.28    pgpkeys/chapter.sgml
policies.sgml        1.16  -&gt;  1.18    policies/chapter.sgml
porting.sgml         1.93  -&gt;  1.112   contrib/chapter.sgml
ports.sgml           1.29  -&gt;  1.31    ports/chapter.sgml
printing.sgml        1.21  -&gt;  1.22    printing/chapter.sgml
relnotes.sgml        1.24  -&gt;  1.28    introduction/chapter.sgml  [1]
submitters.sgml      1.161 -&gt;  1.246   contrib/chapter.sgml
synching.sgml        1.12  -&gt;  1.13    cutting-edge/chapter.sgml
userppp.sgml         1.28  -&gt;  1.30    ppp-and-slip/chapter.sgml

[1] A chunk of relnotes.sgml is in an IGNORED marked section. Why?

Submitted by:	A bunch (~ 50%) of merging done by Charles A. Wimmer
                (cawimm@FreeBSD.ORG), rest by Nik.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
tags LINUXDOC_2_DOCBOOK_START and LINUXDOC_2_DOCBOOK from doc/handbook/.

Note that the LINUXDOC_2_DOCBOOK tag is not necessarily at the HEAD of
the file. So some files won't show changes because changes were applied
after I laid down the LINUXDOC_2_DOCBOOK tag.

Not everything was merged. In some cases, URLs had been shortened;

    http://www.freebsd.org/docproj/

becomes

     ../docproj/

This is a mistake, since users browsing the Handbook on their own machine
can't be expected to have links like this work. Of course, for mirrors,
they'll end up pointing back to the main site. For the mean time, do
nothing -- this will need an entity defined to reference the base URL
of the FreeBSD site, individual mirrors can set this as necessary.

Notice how some files (on the left) are merged to the same file (on
the right). This is because the new Handbook file structure is organised
on DocBook chapter lines.

Files with no revision number in the "From" column didn't exist when I
started the conversion.

File                 From  -&gt;  To      Merged to files...
---------------------------------------------------------------
anoncvs.sgml               -&gt;  1.1     cutting-edge/chapter.sgml
authors.sgml         1.93  -&gt;  1.118   authors.ent
backups.sgml               -&gt;  1.4     backups/chapter.sgml
bibliography.sgml    1.33  -&gt;  1.37    bibliography/chapter.sgml
contrib.sgml         1.274 -&gt;  1.312   staff/chapter.sgml
ctm.sgml             1.22  -&gt;  1.23    cutting-edge/chapter.sgml
cvsup.sgml           1.36  -&gt;  1.40    cutting-edge/chapter.sgml
disks.sgml                 -&gt;  1.3     disks/chapter.sgml
eresources.sgml      1.39  -&gt;  1.50    eresources/chapter.sgml
firewalls.sgml       1.19  -&gt;  1.20    security/chapter.sgml
handbook.sgml        1.83  -&gt;  1.91    handbook.sgml
history.sgml         1.24  -&gt;  1.25    introduction/chapter.sgml
install.sgml         1.65  -&gt;  1.67    install/chapter.sgml
isdn.sgml            1.12  -&gt;  1.15    advanced-networking/chapter.sgml
kerberos.sgml        1.12  -&gt;  1.13    security/chapter.sgml
kernelconfig.sgml    1.31  -&gt;  1.32    kernelconfig/chapter.sgml
kerneldebug.sgml     1.17  -&gt;  1.19    kerneldebug/chapter.sgml
linuxemu.sgml        1.22  -&gt;  1.24    linuxemu/chapter.sgml
memoryuse.sgml       1.11  -&gt;  1.12    internals/chapter.sgml
mirrors.sgml         1.80  -&gt;  1.92    mirrors/chapter.sgml
nutshell.sgml        1.14  -&gt;  1.15    introduction/chapter.sgml
pgpkeys.sgml         1.25  -&gt;  1.28    pgpkeys/chapter.sgml
policies.sgml        1.16  -&gt;  1.18    policies/chapter.sgml
porting.sgml         1.93  -&gt;  1.112   contrib/chapter.sgml
ports.sgml           1.29  -&gt;  1.31    ports/chapter.sgml
printing.sgml        1.21  -&gt;  1.22    printing/chapter.sgml
relnotes.sgml        1.24  -&gt;  1.28    introduction/chapter.sgml  [1]
submitters.sgml      1.161 -&gt;  1.246   contrib/chapter.sgml
synching.sgml        1.12  -&gt;  1.13    cutting-edge/chapter.sgml
userppp.sgml         1.28  -&gt;  1.30    ppp-and-slip/chapter.sgml

[1] A chunk of relnotes.sgml is in an IGNORED marked section. Why?

Submitted by:	A bunch (~ 50%) of merging done by Charles A. Wimmer
                (cawimm@FreeBSD.ORG), rest by Nik.
</pre>
</div>
</content>
</entry>
<entry>
<title>Replace</title>
<updated>1998-11-05T23:28:48+00:00</updated>
<author>
<name>Nik Clayton</name>
<email>nik@FreeBSD.org</email>
</author>
<published>1998-11-05T23:28:48+00:00</published>
<link rel='alternate' type='text/html' href='http://cgit.freebsd.org/doc/commit/?id=6ff34ef8828899e752f225c6818879a9ded29cf4'/>
<id>6ff34ef8828899e752f225c6818879a9ded29cf4</id>
<content type='text'>
    &lt;xref linkend="target" remap="foo"&gt;

with

    &lt;link linkend="target"&gt;foo&lt;/link&gt;

Internal links within the Handbook now do the right thing.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
    &lt;xref linkend="target" remap="foo"&gt;

with

    &lt;link linkend="target"&gt;foo&lt;/link&gt;

Internal links within the Handbook now do the right thing.
</pre>
</div>
</content>
</entry>
<entry>
<title>Added chapter.decl, which contains a declaration for a DocBook chapter.</title>
<updated>1998-11-03T23:28:30+00:00</updated>
<author>
<name>Nik Clayton</name>
<email>nik@FreeBSD.org</email>
</author>
<published>1998-11-03T23:28:30+00:00</published>
<link rel='alternate' type='text/html' href='http://cgit.freebsd.org/doc/commit/?id=336215d4e60654d68c9b214697cbd14f594bed85'/>
<id>336215d4e60654d68c9b214697cbd14f594bed85</id>
<content type='text'>
Added

&lt;!--
     Local Variables:
     mode: sgml
     sgml-declaration: "../chapter.decl"
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-shorttag: nil
     sgml-always-quote-attributes: t
     sgml-minimize-attributes: max
     sgml-parent-document: ("../handbook.sgml" "part" "chapter")
     End:
--&gt;

to the bottom of each chapter.sgml file so that Emacs can do the right
thing.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Added

&lt;!--
     Local Variables:
     mode: sgml
     sgml-declaration: "../chapter.decl"
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-shorttag: nil
     sgml-always-quote-attributes: t
     sgml-minimize-attributes: max
     sgml-parent-document: ("../handbook.sgml" "part" "chapter")
     End:
--&gt;

to the bottom of each chapter.sgml file so that Emacs can do the right
thing.
</pre>
</div>
</content>
</entry>
<entry>
<title>Split the handbook into individual files. Each chapter is in a file called</title>
<updated>1998-11-03T23:17:06+00:00</updated>
<author>
<name>Nik Clayton</name>
<email>nik@FreeBSD.org</email>
</author>
<published>1998-11-03T23:17:06+00:00</published>
<link rel='alternate' type='text/html' href='http://cgit.freebsd.org/doc/commit/?id=2207769022c0b726ecdd97003a494c796dfb022b'/>
<id>2207769022c0b726ecdd97003a494c796dfb022b</id>
<content type='text'>
chapter.sgml in a directory named according to the value the id
attribute on that chapter.

Added chapters.ent, which lists the entities for each chapter.

Updated handbook.sgml to use these entities.
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
chapter.sgml in a directory named according to the value the id
attribute on that chapter.

Added chapters.ent, which lists the entities for each chapter.

Updated handbook.sgml to use these entities.
</pre>
</div>
</content>
</entry>
</feed>
