aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMatthew Burgess <matthew@linuxfromscratch.org>2004-12-04 11:07:21 +0000
committerMatthew Burgess <matthew@linuxfromscratch.org>2004-12-04 11:07:21 +0000
commita0a2d97027b5b4fa0161a135d500d9ec5ce418ef (patch)
tree181ac1ec2e586acc265513ec318e5a614a92deb2
parenta8f36125fa1c4971c61ea039e2a005dbd2c42632 (diff)
* (chapter01/*.xml) RELAX NG validation fixes
git-svn-id: http://svn.linuxfromscratch.org/LFS/branches/LFS-RNG/BOOK@4347 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
-rw-r--r--chapter01/administrativa.xml71
-rw-r--r--chapter01/askforhelp.xml47
-rw-r--r--chapter01/changelog.xml13
-rw-r--r--chapter01/chapter01.xml11
-rw-r--r--chapter01/how.xml8
-rw-r--r--index.xml6
6 files changed, 80 insertions, 76 deletions
diff --git a/chapter01/administrativa.xml b/chapter01/administrativa.xml
index 8cffb192a..6d46e3e53 100644
--- a/chapter01/administrativa.xml
+++ b/chapter01/administrativa.xml
@@ -1,26 +1,27 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 [
+<!DOCTYPE section [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
-<sect1 id="ch-scatter-administrativa">
-<title>Resources</title>
+<section xmlns="http://docbook.org/docbook-ng"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xml:id="ch-scatter-administrativa">
+<info><title>Resources</title></info>
<?dbhtml filename="resources.html"?>
-<sect2 id="ch-scatter-faq">
-<title>FAQ</title>
+<section xml:id="ch-scatter-faq">
+<info><title>FAQ</title></info>
<para>If during the building of your LFS system you encounter any errors, or
have any questions, or think you found a typo in the book, then please first
consult the FAQ (Frequently Asked Questions) at
-<ulink url="&faq-root;"/>.</para>
+<uri xlink:href="&faq-root;">&faq-root;</uri>.</para>
-</sect2>
+</section>
-
-<sect2 id="ch-scatter-irc">
-<title>IRC</title>
+<section xml:id="ch-scatter-irc">
+<info><title>IRC</title></info>
<para>Several members of the LFS community offer assistance on our community
IRC (Internet Relay Chat) network. Before you utilize this mode of support, we
@@ -30,24 +31,24 @@ network at <uri>irc.linuxfromscratch.org</uri> or
<uri>irc.linux-phreak.net</uri> port 6667. The support channel is
named #LFS-support.</para>
-</sect2>
+</section>
-<sect2 id="ch-scatter-maillists" xreflabel="Chapter 1 - Mailing lists">
-<title>Mailing lists</title>
+<section xml:id="ch-scatter-maillists" xreflabel="Chapter 1 - Mailing lists">
+<info><title>Mailing lists</title></info>
<para>The <uri>linuxfromscratch.org</uri> server is hosting a number
of mailing lists used for the development of the LFS project. These lists
include, among others, the main development and support lists.</para>
<para>For information on which lists are available, how to subscribe to them,
-their archive locations, and so on, visit <ulink url="&lfs-root;mail.html"/>.</para>
+their archive locations, and so on, visit <uri xlink:href="&lfs-root;mail.html">&lfs-root;mail.html</uri>.</para>
-</sect2>
+</section>
-<sect2 id="ch-scatter-newsserver">
-<title>News server</title>
+<section xml:id="ch-scatter-newsserver">
+<info><title>News server</title></info>
<para>All the mailing lists hosted at <uri>linuxfromscratch.org</uri>
are also accessible via the NNTP server. All messages posted to a mailing list
@@ -56,47 +57,45 @@ are copied to the corresponding newsgroup, and vice versa.</para>
<para>The news server can be reached at
<uri>news.linuxfromscratch.org</uri>.</para>
-</sect2>
+</section>
-<sect2 id="ch-scatter-wiki">
-<title>Wiki</title>
+<section xml:id="ch-scatter-wiki">
+<info><title>Wiki</title></info>
<para>For more information on a package, updated versions, tweaks, personal
-experiences, and so on, see the LFS Wiki at <ulink url="&wiki-root;"/>. You
-can add information there yourself too, to help others.</para>
+experiences, and so on, see the LFS Wiki at <uri xlink:href="&wiki-root;">&wiki-root;</uri>. You can add information there yourself too, to help others.</para>
-</sect2>
+</section>
-<sect2 id="ch-scatter-references">
-<title>References</title>
+<section xml:id="ch-scatter-references">
+<info><title>References</title></info>
<para>If you need still more detailed information on the packages,
you will find useful pointers on this page:
-<ulink url="http://www.109bean.org.uk/LFS-references.html"/>.</para>
+<uri xlink:href="http://www.109bean.org.uk/LFS-references.html">http://www.109bean.org.uk/LFS-references.html</uri>.</para>
-</sect2>
+</section>
-<sect2 id="ch-scatter-mirrors" xreflabel="Chapter 1 - Mirror sites">
-<title>Mirror sites</title>
+<section xml:id="ch-scatter-mirrors" xreflabel="Chapter 1 - Mirror sites">
+<info><title>Mirror sites</title></info>
<para>The LFS project has a number of mirrors set up world-wide to make
accessing the website and downloading the required packages more convenient.
-Please visit the website at <ulink url="&lfs-root;"/> for a list of current
-mirrors.</para>
+Please visit the website at <uri xlink:href="&lfs-root;">&lfs-root;</uri> for a list of current mirrors.</para>
-</sect2>
+</section>
-<sect2 id="ch-scatter-contactinfo">
-<title>Contact information</title>
+<section xml:id="ch-scatter-contactinfo">
+<info><title>Contact information</title></info>
<para>Please direct all your questions and comments to one of the LFS mailing
lists (see above).</para>
-</sect2>
+</section>
-</sect1>
+</section>
diff --git a/chapter01/askforhelp.xml b/chapter01/askforhelp.xml
index 0b5469652..3d4a60af3 100644
--- a/chapter01/askforhelp.xml
+++ b/chapter01/askforhelp.xml
@@ -1,25 +1,27 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 [
+<!DOCTYPE section [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
-<sect1 id="prepare-askforhelp">
-<title>How to ask for help</title>
+<section xmlns="http://docbook.org/docbook-ng"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xml:id="prepare-askforhelp">
+<info><title>How to ask for help</title></info>
<?dbhtml filename="askforhelp.html"?>
<para>If you run into a problem while working through this book, you should
-first check the FAQ at <ulink url="&faq-root;"/> -- often your question
+first check the FAQ at <uri xlink:href="&faq-root;"/> -- often your question
is already answered there. If it is not, you should try to find the source of
the problem. The following hint might give you some ideas for your
-troubleshooting: <ulink url="&hints-root;errors.txt"/>.</para>
+troubleshooting: <uri xlink:href="&hints-root;errors.txt">&hints-root;errors.txt</uri>.</para>
<para>If all that fails, you will find that most people on IRC and the mailing
lists (see <xref linkend="ch-scatter-administrativa"/>) are willing to help
you. But to assist them in diagnosing and solving your problem, please include
all relevant information in your request for help.</para>
-<sect2>
-<title>Things to mention</title>
+<section>
+<info><title>Things to mention</title></info>
<para>Apart from a brief explanation of the problem you're having, the
essential things to include in your request are:</para>
@@ -37,10 +39,10 @@ LFS,</para></listitem>
that we won't help you. After all, LFS is about choice. It'll just
help us to see other possible causes of your problem.</para></note>
-</sect2>
+</section>
-<sect2>
-<title>Configure problems</title>
+<section>
+<info><title>Configure problems</title></info>
<para>When something goes wrong during the stage where the configure script
is run, look through the <filename>config.log</filename> file. This file
@@ -48,10 +50,10 @@ may contain errors encountered during configure which weren't printed to
the screen. Include those relevant lines if you decide to ask for
help.</para>
-</sect2>
+</section>
-<sect2>
-<title>Compile problems</title>
+<section>
+<info><title>Compile problems</title></info>
<para>To help us find the cause of the problem, both screen output and
the contents of various files are useful. The screen output from both
@@ -88,24 +90,23 @@ command that was executed and the command's error message(s).</para>
<para>An excellent article on asking for help on the Internet in general
has been written by Eric S. Raymond. It is available online at
-<ulink url="http://catb.org/~esr/faqs/smart-questions.html"/>.
+<uri xlink:href="http://catb.org/~esr/faqs/smart-questions.html">http://catb.org/~esr/faqs/smart-questions.html"</uri>.
Read and follow the hints in that document and you are much more likely
to get a response to start with and also to get the help you actually
need.</para>
-</sect2>
+</section>
-<sect2>
-<title>Test suite problems</title>
+<section>
+<info><title>Test suite problems</title></info>
<para>Many packages provide a test suite which, depending on the importance
of the package, we may encourage you to run. Sometimes packages will
generate false or expected failures. If you encounter these, you can check
-the LFS Wiki page at <ulink url="&wiki-root;"/> to see whether we have
-already noted and investigated them. If we already know
-about them, then usually there is no need to be concerned.</para>
+the LFS Wiki page at <uri xlink:href="&wiki-root;">&wiki-root;</uri> to see
+whether we have already noted and investigated them. If we already know about
+them, then usually there is no need to be concerned.</para>
-</sect2>
+</section>
-
-</sect1>
+</section>
diff --git a/chapter01/changelog.xml b/chapter01/changelog.xml
index 6bb90f32a..4bac0c904 100644
--- a/chapter01/changelog.xml
+++ b/chapter01/changelog.xml
@@ -1,16 +1,19 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 [
+<!DOCTYPE section [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
-<sect1 id="ch-scatter-changelog" condition="no-print">
-<title>Changelog</title>
+<section xmlns="http://docbook.org/docbook-ng"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xml:id="ch-scatter-changelog"
+ condition="no-print">
+<info><title>Changelog</title></info>
<?dbhtml filename="changelog.html"?>
<para>This is version &version; of the Linux From Scratch book, dated
&releasedate;. If this book is more than two months old, a newer and better
version is probably already available. To find out, please check one of the
-mirrors via <ulink url="&lfs-root;"/>.</para>
+mirrors via <uri xlink:href="&lfs-root;">&lfs-root;</uri>.</para>
<para>Below is a list of changes made since the previous release of the book,
first a summary, then a detailed log.</para>
@@ -641,4 +644,4 @@ and Jason Scott for the help they gave to BE-LFS before integration.</para></lis
<para>Release of version 5.1.1 on June 6th, 2004.</para>
-</sect1>
+</section>
diff --git a/chapter01/chapter01.xml b/chapter01/chapter01.xml
index ef2622131..5a0d17465 100644
--- a/chapter01/chapter01.xml
+++ b/chapter01/chapter01.xml
@@ -3,14 +3,15 @@
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
-<chapter id="chapter-intro" xreflabel="Chapter 1">
+<chapter xmlns="http://docbook.org/docbook-ng"
+ xmlns:xi="http://www.w3.org/2003/XInclude">
<?dbhtml dir="chapter01"?>
<title>Introduction</title>
<?dbhtml filename="chapter01.html"?>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="how.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="changelog.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="administrativa.xml"/>
-<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="askforhelp.xml"/>
+<xi:include href="how.xml"/>
+<xi:include href="changelog.xml"/>
+<xi:include href="administrativa.xml"/>
+<xi:include href="askforhelp.xml"/>
</chapter>
diff --git a/chapter01/how.xml b/chapter01/how.xml
index b3d3cb444..07a2476e7 100644
--- a/chapter01/how.xml
+++ b/chapter01/how.xml
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
-<!DOCTYPE sect1 [
+<!DOCTYPE section [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
-<sect1 id="ch-scatter-how">
-<title>How things are going to be done</title>
+<section xmlns="http://docbook.org/docbook-ng" xml:id="ch-scatter-how">
+<info><title>How things are going to be done</title></info>
<?dbhtml filename="how.html"?>
<para>You are going to build your LFS system by using a previously installed
@@ -72,4 +72,4 @@ everything will fall into place soon.</para>
a few important things you should be aware of before you begin to work through
<xref linkend="chapter-temporary-tools"/> and beyond.</para>
-</sect1>
+</section>
diff --git a/index.xml b/index.xml
index 07445e4d2..063484bf6 100644
--- a/index.xml
+++ b/index.xml
@@ -11,14 +11,14 @@
<xi:include href="prologue/preface.xml"/>
-<!--<part id="part1">
+<part xml:id="part1">
<title>Introduction</title>
<?dbhtml filename="part1.html"?>
<xi:include href="chapter01/chapter01.xml"/>
-<xi:include href="chapter02/chapter02.xml"/>
+<!--<xi:include href="chapter02/chapter02.xml"/>-->
</part>
-<part id="part2">
+<!--<part id="part2">
<title>Preparing for the build</title>
<?dbhtml filename="part2.html"?>
<xi:include href="chapter03/chapter03.xml"/>