commit: fb8f7e599d39a1f4f7b1250e8ae64a7feac742e7
Author: Matthew Marchese <maffblaster <AT> gentoo <DOT> org>
AuthorDate: Thu Dec 21 12:17:53 2023 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Tue May 7 17:16:52 2024 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=fb8f7e59
Sentence case devmanual
Signed-off-by: Matthew Marchese <maffblaster <AT> gentoo.org>
[Whitespace. Fix rebase artifact in ebuild-writing/functions/src_test.]
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
appendices/common-problems/text.xml | 14 +++---
appendices/contributing/text.xml | 8 ++--
appendices/devbook-guide/text.xml | 10 ++---
appendices/editor-configuration/emacs/text.xml | 2 +-
appendices/editor-configuration/text.xml | 2 +-
appendices/further-reading/text.xml | 2 +-
appendices/todo-list/text.xml | 2 +-
archs/alpha/text.xml | 12 ++---
archs/amd64/text.xml | 51 +++++++++++-----------
archs/mips/text.xml | 8 ++--
archs/ppc/text.xml | 8 ++--
archs/sparc/text.xml | 10 ++---
archs/text.xml | 2 +-
archs/x86/text.xml | 6 +--
ebuild-maintenance/git/text.xml | 4 +-
ebuild-maintenance/new-ebuild/text.xml | 6 +--
ebuild-maintenance/package-moves/text.xml | 2 +-
ebuild-maintenance/removal/text.xml | 2 +-
ebuild-maintenance/text.xml | 2 +-
ebuild-writing/common-mistakes/text.xml | 18 ++++----
ebuild-writing/eapi/text.xml | 28 ++++++------
ebuild-writing/error-handling/text.xml | 12 ++---
ebuild-writing/file-format/text.xml | 10 ++---
ebuild-writing/functions/pkg_postinst/text.xml | 2 +-
ebuild-writing/functions/pkg_postrm/text.xml | 2 +-
ebuild-writing/functions/pkg_preinst/text.xml | 2 +-
ebuild-writing/functions/pkg_prerm/text.xml | 2 +-
.../src_compile/build-environment/text.xml | 10 ++---
.../functions/src_compile/building/text.xml | 4 +-
.../functions/src_compile/no-build-system/text.xml | 2 +-
ebuild-writing/functions/src_compile/text.xml | 2 +-
.../functions/src_configure/configuring/text.xml | 4 +-
ebuild-writing/functions/src_configure/text.xml | 2 +-
.../functions/src_install/docompress/text.xml | 2 +-
ebuild-writing/functions/src_install/text.xml | 8 ++--
ebuild-writing/functions/src_prepare/text.xml | 2 +-
.../functions/src_unpack/other-formats/text.xml | 8 ++--
.../functions/src_unpack/rpm-sources/text.xml | 4 +-
ebuild-writing/functions/src_unpack/text.xml | 4 +-
.../functions/src_unpack/vcs-sources/text.xml | 6 +--
ebuild-writing/functions/text.xml | 2 +-
ebuild-writing/messages/text.xml | 8 ++--
ebuild-writing/misc-files/metadata/text.xml | 16 +++----
ebuild-writing/misc-files/patches/text.xml | 6 +--
ebuild-writing/misc-files/text.xml | 2 +-
ebuild-writing/text.xml | 2 +-
ebuild-writing/use-conditional-code/text.xml | 2 +-
ebuild-writing/user-submitted/text.xml | 2 +-
ebuild-writing/users-and-groups/text.xml | 2 +-
ebuild-writing/using-eclasses/text.xml | 4 +-
ebuild-writing/variables/text.xml | 12 ++---
eclass-writing/text.xml | 24 +++++-----
function-reference/build-functions/text.xml | 2 +-
function-reference/error-functions/text.xml | 2 +-
function-reference/install-functions/text.xml | 2 +-
function-reference/message-functions/text.xml | 2 +-
function-reference/query-functions/text.xml | 2 +-
function-reference/sandbox-functions/text.xml | 2 +-
function-reference/text.xml | 2 +-
general-concepts/autotools/text.xml | 28 ++++++------
general-concepts/config-protect/text.xml | 2 +-
general-concepts/copyright-policy/text.xml | 2 +-
general-concepts/dependencies/text.xml | 36 +++++++--------
general-concepts/ebuild-revisions/text.xml | 2 +-
general-concepts/emerge-and-ebuild/text.xml | 2 +-
general-concepts/git-to-rsync/text.xml | 2 +-
general-concepts/install-destinations/text.xml | 2 +-
general-concepts/licenses/text.xml | 2 +-
general-concepts/mailing-lists/text.xml | 2 +-
general-concepts/manifest/text.xml | 4 +-
general-concepts/mirrors/text.xml | 10 ++---
general-concepts/news/text.xml | 2 +-
general-concepts/overlay/text.xml | 2 +-
general-concepts/package-collisions/text.xml | 2 +-
general-concepts/package-maintainers/text.xml | 2 +-
general-concepts/portage-cache/text.xml | 4 +-
general-concepts/projects/text.xml | 4 +-
general-concepts/slotting/text.xml | 4 +-
general-concepts/text.xml | 2 +-
general-concepts/tree/text.xml | 4 +-
general-concepts/use-flags/text.xml | 10 ++---
general-concepts/user-environment/text.xml | 6 +--
hosted-projects/text.xml | 8 ++--
keywording/text.xml | 12 ++---
profiles/info_files/text.xml | 2 +-
profiles/make.defaults/text.xml | 2 +-
profiles/package.mask/text.xml | 2 +-
profiles/packages/text.xml | 2 +-
profiles/updates/text.xml | 2 +-
profiles/use.desc/text.xml | 2 +-
profiles/use.mask/text.xml | 2 +-
quickstart/text.xml | 16 +++----
tasks-reference/completion/text.xml | 10 ++---
tasks-reference/environment/text.xml | 2 +-
tasks-reference/init-scripts/text.xml | 2 +-
tasks-reference/pam/text.xml | 6 +--
tasks-reference/text.xml | 2 +-
text.xml | 4 +-
tools-reference/bash/text.xml | 40 ++++++++---------
tools-reference/cat/text.xml | 4 +-
tools-reference/cut/text.xml | 2 +-
tools-reference/diff-and-patch/text.xml | 2 +-
tools-reference/echo/text.xml | 4 +-
tools-reference/ekeyword/text.xml | 2 +-
tools-reference/false-and-true/text.xml | 2 +-
tools-reference/find/text.xml | 2 +-
tools-reference/grep/text.xml | 2 +-
tools-reference/head-and-tail/text.xml | 2 +-
tools-reference/sed/text.xml | 32 +++++++-------
tools-reference/sort/text.xml | 2 +-
tools-reference/text.xml | 2 +-
tools-reference/tr/text.xml | 2 +-
tools-reference/uniq/text.xml | 2 +-
113 files changed, 349 insertions(+), 348 deletions(-)
diff --git a/appendices/common-problems/text.xml
b/appendices/common-problems/text.xml
index 87c21bb..84bb610 100644
--- a/appendices/common-problems/text.xml
+++ b/appendices/common-problems/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="appendices/common-problems/">
<chapter>
-<title>Common Problems</title>
+<title>Common problems</title>
<body>
<p>
@@ -11,7 +11,7 @@ and QA notices.
</body>
<section>
-<title>Handling QA Notices</title>
+<title>Handling QA notices</title>
<body>
<p>
@@ -28,7 +28,7 @@ covered here.
</body>
<subsection>
-<title>QA Notice: USE Flag foo not in IUSE</title>
+<title>QA notice: USE flag foo not in IUSE</title>
<body>
<p>
@@ -42,7 +42,7 @@ See <uri link="::ebuild-writing/variables/#IUSE"/> and
</subsection>
<subsection>
-<title>QA Notice: foo in global scope</title>
+<title>QA notice: foo in global scope</title>
<body>
<p>
@@ -86,7 +86,7 @@ in use, there are various alternatives:
</subsection>
<subsection>
-<title>QA Notice: foo is setXid, dynamically linked and using lazy
bindings</title>
+<title>QA notice: foo is setXid, dynamically linked and using lazy
bindings</title>
<body>
<p>
@@ -110,7 +110,7 @@ for security reasons. If this message is shown, you have a
couple of options:
</subsection>
<subsection>
-<title>QA Notice: ECLASS foo inherited illegally</title>
+<title>QA notice: ECLASS foo inherited illegally</title>
<body>
<p>
@@ -150,7 +150,7 @@ you see this notice locally. If you see this notice when
working with a pure
</section>
<section>
-<title>Handling Access Violations</title>
+<title>Handling access violations</title>
<body>
<p>
diff --git a/appendices/contributing/text.xml b/appendices/contributing/text.xml
index de63f6d..2704463 100644
--- a/appendices/contributing/text.xml
+++ b/appendices/contributing/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="appendices/contributing/">
<chapter>
-<title>Contributing to This Document</title>
+<title>Contributing to this document</title>
<body>
<p>
@@ -70,7 +70,7 @@ top-level directory, which will validate all XML files using
<c>xmllint</c>.
</section>
<section>
-<title>Quick Introduction to DevBook XML</title>
+<title>Quick introduction to DevBook XML</title>
<body>
<p>
@@ -98,7 +98,7 @@ amount of depth.
definition lists. Do <e>not</e> indent text in ordinary paragraph blocks.
</dd>
<dt>
- Code Samples
+ Code samples
</dt>
<dd>
You can use the normal GuideXML tag <c><pre></c> when you need
@@ -124,7 +124,7 @@ amount of depth.
</section>
<section>
-<title>Style Guidelines</title>
+<title>Style guidelines</title>
<body>
<ul>
diff --git a/appendices/devbook-guide/text.xml
b/appendices/devbook-guide/text.xml
index 8301b0a..243017d 100644
--- a/appendices/devbook-guide/text.xml
+++ b/appendices/devbook-guide/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="appendices/devbook-guide/">
<chapter>
-<title>Gentoo DevBook XML Guide</title>
+<title>Gentoo DevBook XML guide</title>
<section>
<title>DevBook XML design goals</title>
@@ -36,7 +36,7 @@ used in a DevBook XML document:
<?xml version="1.0" encoding="UTF-8"?>
<guide self="appendices/devbook-guide/">
<chapter>
-<title>Gentoo DevBook XML Guide</title>
+<title>Gentoo DevBook XML guide</title>
</codesample>
<p>
@@ -556,7 +556,7 @@ I could have written the two examples above in more compact
form:
</section>
<section>
-<title>Coding Style</title>
+<title>Coding style</title>
<body>
<p>
@@ -574,7 +574,7 @@ Both sections are described next.
</body>
<subsection>
-<title>Internal Coding Style</title>
+<title>Internal coding style</title>
<body>
<p>
@@ -674,7 +674,7 @@ fixed-width font.
</body>
</subsection>
<subsection>
-<title>External Coding Style</title>
+<title>External coding style</title>
<body>
<p>
diff --git a/appendices/editor-configuration/emacs/text.xml
b/appendices/editor-configuration/emacs/text.xml
index 9300a69..df3b94b 100644
--- a/appendices/editor-configuration/emacs/text.xml
+++ b/appendices/editor-configuration/emacs/text.xml
@@ -80,7 +80,7 @@ for each document type.
</section>
<section>
-<title>Further Reading</title>
+<title>Further reading</title>
<body>
<ul>
diff --git a/appendices/editor-configuration/text.xml
b/appendices/editor-configuration/text.xml
index fa1547d..7b50b48 100644
--- a/appendices/editor-configuration/text.xml
+++ b/appendices/editor-configuration/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="appendices/editor-configuration/">
<chapter>
-<title>Editor Configuration</title>
+<title>Editor configuration</title>
<body>
<p>
diff --git a/appendices/further-reading/text.xml
b/appendices/further-reading/text.xml
index b727322..95eb812 100644
--- a/appendices/further-reading/text.xml
+++ b/appendices/further-reading/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="appendices/further-reading/">
<chapter>
-<title>Further Reading</title>
+<title>Further reading</title>
<body>
<p>
diff --git a/appendices/todo-list/text.xml b/appendices/todo-list/text.xml
index a1464f2..c6db2a8 100644
--- a/appendices/todo-list/text.xml
+++ b/appendices/todo-list/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="appendices/todo-list/">
<chapter>
-<title>TODO List</title>
+<title>TODO list</title>
<body>
<p>
This TODO list is automatically generated from the <c><todo></c>
directives in other documents.
diff --git a/archs/alpha/text.xml b/archs/alpha/text.xml
index 32b539b..f068317 100644
--- a/archs/alpha/text.xml
+++ b/archs/alpha/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="archs/alpha/">
<chapter>
-<title>Arch Specific Notes — Alpha</title>
+<title>Arch specific notes — Alpha</title>
<body>
<p>
@@ -12,7 +12,7 @@ The Alpha port uses the <c>alpha</c> keyword. It focuses upon
HP (formerly Compa
</body>
<section>
-<title>Alpha Kernel and Userland ABIs</title>
+<title>Alpha kernel and userland ABIs</title>
<body>
<p>
@@ -28,7 +28,7 @@ little endian.
</section>
<section>
-<title>Additional Alpha Keywording Requirements</title>
+<title>Additional Alpha keywording requirements</title>
<body>
<p>
@@ -42,7 +42,7 @@ like to know about it.
</section>
<section>
-<title>Alpha Instruction Set and Performance Notes</title>
+<title>Alpha instruction set and performance notes</title>
<body>
<p>
@@ -108,7 +108,7 @@ this results in errors during the compilation aborting
emerge.
</section>
<section>
-<title>Contacting the Alpha Team</title>
+<title>Contacting the Alpha team</title>
<body>
<p>
@@ -134,7 +134,7 @@ The Alpha team can be contacted:
</section>
<section>
-<title>Other Resources</title>
+<title>Other resources</title>
<body>
<ul>
diff --git a/archs/amd64/text.xml b/archs/amd64/text.xml
index f227005..4f3b7da 100644
--- a/archs/amd64/text.xml
+++ b/archs/amd64/text.xml
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="archs/amd64/">
<chapter>
-<title>Arch Specific Notes — AMD64/EM64T</title>
+<title>Arch specific notes — AMD64/EM64T</title>
<section>
-<title>Position Independent Code Issues</title>
+<title>Position Independent Code issues</title>
<body>
<p>
@@ -83,32 +83,33 @@ applied to shared objects.
<body>
<p>
-The current AMD64 processors are able to natively run 32bit code on a 64bit
+The current AMD64 processors are able to natively run 32-bit code on a 64-bit
kernel. Therefore, you can run programs compiled for x86 in an amd64
environment.
-However, 32bit applications need to be linked against 32bit libraries. Mixing
-them won't work. For this reason the libraries are sorted, 32bit libraries
normally
-go to <c>/lib32</c> respectively <c>/usr/lib32</c>, the 64bit ones normally to
<c>/lib64</c> or
-<c>/usr/lib64</c>. In a perfect world, you wouldn't have to read on.
Unfortunately,
-that's not the case, and so it's a bit more complicated.
+However, 32-bit applications need to be linked against 32-bit libraries. Mixing
+them won't work. For this reason the libraries are sorted, 32-bit libraries
+normally go to <c>/lib32</c> respectively <c>/usr/lib32</c>, the 64-bit ones
+normally to <c>/lib64</c> or <c>/usr/lib64</c>. In a perfect world, you
wouldn't
+have to read on. Unfortunately, that's not the case, and so it's a bit more
+complicated.
</p>
</body>
<subsection>
-<title>Multilib-Toolchain</title>
+<title>Multilib toolchain</title>
<subsubsection>
<title>GCC</title>
<body>
<p>
-To generate 32bit code, we need a multilib-capable GCC. On other architectures,
+To generate 32-bit code, we need a multilib-capable GCC. On other
architectures,
this functionality is enabled with the USE flag <c>multilib</c>. This is also
true
for amd64 with the <e>pre</e>-2005.0 profiles. From 2005.0 on, you have to
choose
whether you want multilib support or not by selecting the profile. Choose
<c>2005.0/no-multilib</c> if you don't want it, all other profiles have the
<c>multilib</c> USE flag masked, you're forced to it. With these profiles, GCC
will
produce x86-code whenever you add <c>-m32</c> to its command line. Adding
<c>-m64</c>
-or omitting any bit-width option will default to producing 64bit code.
+or omitting any bit-width option will default to producing 64-bit code.
</p>
</body>
@@ -119,8 +120,8 @@ or omitting any bit-width option will default to producing
64bit code.
<body>
<p>
-If you've chosen a multilib profile, glibc will be built twice, once 64bit and
-once 32bit. This is because nearly every application links against glibc.
+If you've chosen a multilib profile, glibc will be built twice, once 64-bit and
+once 32-bit. This is because nearly every application links against glibc.
To understand how this is done in the ebuild, read
<uri link="::archs/amd64/#The ABI Variable"/>.
</p>
@@ -130,11 +131,11 @@ To understand how this is done in the ebuild, read
</subsection>
<subsection>
-<title>32bit compatibility</title>
+<title>32-bit compatibility</title>
<body>
<p>
-As you read above, 32bit applications must be linked against 32bit libraries.
+As you read above, 32-bit applications must be linked against 32-bit libraries.
For that, we've made the most common libraries as multilib (via <c>ABI</c>
variable and <c><uri link="::eclass-reference/multilib.eclass/"/></c>).
</p>
@@ -209,14 +210,14 @@ the <c>ABI</c> variable.
</subsection>
<subsection>
-<title>The <c>multilib-strict</c> Feature</title>
+<title>The <c>multilib-strict</c> feature</title>
<body>
<p>
Many Makefiles assume that their libraries should go to <c>/usr/lib</c>, or
<c>$(prefix)/lib</c>. This assumption can cause a serious mess if
<c>/usr/lib</c>
isn't a symlink to <c>/usr/lib64</c>. To find the bad packages, we have a
Portage feature
-called <b>multilib-strict</b>. It will prevent emerge from putting 64bit
libraries
+called <b>multilib-strict</b>. It will prevent emerge from putting 64-bit
libraries
into anything other than <c>(/usr)/lib64</c>.
</p>
@@ -247,13 +248,13 @@ modifications!
</subsection>
<subsection>
-<title>Headers and Multilib</title>
+<title>Headers and multilib</title>
<body>
<p>
Most C/C++ programs need standard header files like <c>types.h</c>. Some of
them
depend on architecture specific facts, e.g. <c>types.h</c> on the length
-of machine words. To ensure that we can compile both 32bit and 64bit
+of machine words. To ensure that we can compile both 32-bit and 64-bit
applications and libraries, we treat <c>/usr/include/asm</c> a bit special.
</p>
@@ -285,16 +286,16 @@ section.
</subsection>
<subsection>
-<title>The ABI Variable</title>
+<title>The ABI variable</title>
<body>
<p>
Whenever Portage builds something on amd64, it has to decide whether it should
-be 32bit or 64bit. As stated in <uri link="::archs/amd64/#Headers and
Multilib"/>
+be 32-bit or 64-bit. As stated in <uri link="::archs/amd64/#Headers and
Multilib"/>
the <c>__i386__</c> or <c>__x86_64__</c> respectively, is needed in
<c>CDEFINE</c>.
Also, gcc has to know what code it should produce, therefore <c>-m32</c> or
<c>-m64</c>
must be appended to CFLAGS. This is done via <c>profile.bashrc</c>. All you
need to do
-if you want to build a package 32bit is to set <c>ABI=x86</c>.
+if you want to build a package 32-bit is to set <c>ABI=x86</c>.
</p>
<p>
@@ -323,10 +324,10 @@ LIBDIR_x86="lib32"
</section>
<section>
-<title>Porting Notes</title>
+<title>Porting notes</title>
<subsection>
-<title>Machine Word sizes</title>
+<title>Machine word sizes</title>
<body>
<p>
@@ -473,7 +474,7 @@ segmentation faults or strange behaviour. GCC 4.0 refuses
to compile such code.
</section>
<section>
-<title>Other Resources</title>
+<title>Other resources</title>
<body>
<ul>
diff --git a/archs/mips/text.xml b/archs/mips/text.xml
index 436e361..141664a 100644
--- a/archs/mips/text.xml
+++ b/archs/mips/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="archs/mips/">
<chapter>
-<title>Arch Specific Notes — MIPS</title>
+<title>Arch specific notes — MIPS</title>
<body>
<p>
@@ -64,7 +64,7 @@ between these, talk to the MIPS team.
</section>
<section>
-<title>Not Dropping <c>CFLAGS</c> on MIPS</title>
+<title>Not dropping <c>CFLAGS</c> on MIPS</title>
<body>
<p>
@@ -77,7 +77,7 @@ vital that packages honour this setting. See
</section>
<section>
-<title>Additional MIPS Keywording Requirements</title>
+<title>Additional MIPS keywording requirements</title>
<body>
<note>
@@ -110,7 +110,7 @@ MIPS doesn't currently use stable keywords so don't file
stable requests to them
</section>
<section>
-<title>Contacting the MIPS Team</title>
+<title>Contacting the MIPS team</title>
<body>
<p>
diff --git a/archs/ppc/text.xml b/archs/ppc/text.xml
index e6a4966..3afb633 100644
--- a/archs/ppc/text.xml
+++ b/archs/ppc/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="archs/ppc/">
<chapter>
-<title>Arch Specific Notes — PPC</title>
+<title>Arch specific notes — PPC</title>
<body>
<p>
@@ -62,7 +62,7 @@ code below to define vectors is the preferred way of fixing
this:
</section>
<section>
-<title>Contacting the PowerPC Team</title>
+<title>Contacting the PowerPC team</title>
<body>
<p>
@@ -88,7 +88,7 @@ The PowerPC team can be reached by:
</section>
<section>
-<title>Other Resources</title>
+<title>Other resources</title>
<body>
<ul>
@@ -96,7 +96,7 @@ The PowerPC team can be reached by:
<uri link="https://wiki.gentoo.org/wiki/PPC/FAQ";>Gentoo PPC FAQ</uri>
</li>
<li>
- <uri link="https://forums.gentoo.org/viewforum-f-24.html";>Gentoo PPC
Forums</uri>
+ <uri link="https://forums.gentoo.org/viewforum-f-24.html";>Gentoo PPC
forums</uri>
</li>
</ul>
diff --git a/archs/sparc/text.xml b/archs/sparc/text.xml
index 5cfbdf2..fccf53c 100644
--- a/archs/sparc/text.xml
+++ b/archs/sparc/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="archs/sparc/">
<chapter>
-<title>Arch Specific Notes — SPARC</title>
+<title>Arch specific notes — SPARC</title>
<body>
<p>
@@ -27,7 +27,7 @@ by the code authors.
</body>
<section>
-<title>SPARC Kernel and Userland ABIs</title>
+<title>SPARC kernel and userland ABIs</title>
<body>
<p>
@@ -50,7 +50,7 @@ buses.
</section>
<section>
-<title>Additional SPARC Keywording Requirements</title>
+<title>Additional SPARC keywording requirements</title>
<body>
<note>
@@ -80,7 +80,7 @@ the <c>sparc@</c> alias.
</section>
<section>
-<title>SPARC Instruction Set and Performance Notes</title>
+<title>SPARC instruction set and performance notes</title>
<body>
<p>
@@ -124,7 +124,7 @@ are especially important on SPARC.
</section>
<section>
-<title>Contacting the SPARC Team</title>
+<title>Contacting the SPARC team</title>
<body>
<p>
diff --git a/archs/text.xml b/archs/text.xml
index 137920b..5df6b24 100644
--- a/archs/text.xml
+++ b/archs/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="archs/">
<chapter>
-<title>Arch Specific Notes</title>
+<title>Arch specific notes</title>
<body>
<p>
diff --git a/archs/x86/text.xml b/archs/x86/text.xml
index 76f57c2..59a3f68 100644
--- a/archs/x86/text.xml
+++ b/archs/x86/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="archs/x86/">
<chapter>
-<title>Arch Specific Notes — x86</title>
+<title>Arch specific notes — x86</title>
<body>
<p>
@@ -20,7 +20,7 @@ unless someone on the team can test it.
</body>
<section>
-<title>x86 Team Guidelines</title>
+<title>x86 team guidelines</title>
<body>
<p>
@@ -47,7 +47,7 @@ The following is a list of rules and expectations for members
of the x86 team:
</section>
<section>
-<title>Contacting the x86 Team</title>
+<title>Contacting the x86 team</title>
<body>
<p>
diff --git a/ebuild-maintenance/git/text.xml b/ebuild-maintenance/git/text.xml
index 2f3fcb3..82967cc 100644
--- a/ebuild-maintenance/git/text.xml
+++ b/ebuild-maintenance/git/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-maintenance/git/">
<chapter>
-<title>Git for Gentoo Developers</title>
+<title>Git for Gentoo developers</title>
<body>
<p>
@@ -193,7 +193,7 @@ in the first commit in the series introduced by a single
push.
</subsection>
<subsection>
-<title>Git Commit Message Format</title>
+<title>Git commit message format</title>
<body>
<p>
diff --git a/ebuild-maintenance/new-ebuild/text.xml
b/ebuild-maintenance/new-ebuild/text.xml
index 10793e0..e79d30c 100644
--- a/ebuild-maintenance/new-ebuild/text.xml
+++ b/ebuild-maintenance/new-ebuild/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-maintenance/new-ebuild/">
<chapter>
-<title>Adding a New Ebuild</title>
+<title>Adding a new ebuild</title>
<section>
<title>What (not) to put in the Gentoo repository</title>
@@ -65,7 +65,7 @@ didn't forget something.
</section>
<section>
-<title>Initial Architecture Keywords</title>
+<title>Initial architecture keywords</title>
<body>
<p>
@@ -91,7 +91,7 @@ work on those architectures.
</section>
<section>
-<title>The files Directory</title>
+<title>The files directory</title>
<body>
<p>
diff --git a/ebuild-maintenance/package-moves/text.xml
b/ebuild-maintenance/package-moves/text.xml
index 9c07db5..801dada 100644
--- a/ebuild-maintenance/package-moves/text.xml
+++ b/ebuild-maintenance/package-moves/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-maintenance/package-moves/">
<chapter>
-<title>Package and Slot Moves</title>
+<title>Package and slot moves</title>
<body>
<p>
diff --git a/ebuild-maintenance/removal/text.xml
b/ebuild-maintenance/removal/text.xml
index bdeae71..ebab645 100644
--- a/ebuild-maintenance/removal/text.xml
+++ b/ebuild-maintenance/removal/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-maintenance/removal/">
<chapter>
-<title>Removing Ebuilds and Packages</title>
+<title>Removing ebuilds and packages</title>
<section>
<title>Removing ebuilds</title>
diff --git a/ebuild-maintenance/text.xml b/ebuild-maintenance/text.xml
index 2a7ecff..0796227 100644
--- a/ebuild-maintenance/text.xml
+++ b/ebuild-maintenance/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-maintenance/">
<chapter>
-<title>Ebuild Maintenance</title>
+<title>Ebuild maintenance</title>
<body>
<p>
diff --git a/ebuild-writing/common-mistakes/text.xml
b/ebuild-writing/common-mistakes/text.xml
index 41f6d35..5db3973 100644
--- a/ebuild-writing/common-mistakes/text.xml
+++ b/ebuild-writing/common-mistakes/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/common-mistakes/">
<chapter>
-<title>Common Mistakes</title>
+<title>Common mistakes</title>
<body>
<p>
@@ -11,7 +11,7 @@ writing ebuilds.
</body>
<section>
-<title>Common Ebuild Writing Mistakes</title>
+<title>Common ebuild writing mistakes</title>
<subsection>
<title>Unguarded external calls</title>
@@ -27,7 +27,7 @@ See <uri link="::ebuild-writing/error-handling/"/>.
</subsection>
<subsection>
-<title>Invalid use of <c>static</c> use-flag</title>
+<title>Invalid use of <c>static</c> USE flag</title>
<body>
<p>
The <c>static</c> use-flag should only be used to make a binary use static
@@ -217,7 +217,7 @@ the resulting Makefile.
</subsection>
<subsection>
-<title>Missing/Invalid/Broken Header</title>
+<title>Missing/invalid/broken header</title>
<body>
<p>
@@ -239,7 +239,7 @@ The first two lines <e>must</e> look like this:
</body>
</subsection>
<subsection>
-<title>Redefined P, PV, PN, PF</title>
+<title>Redefined P, PV, PN, PF variables</title>
<body>
<p>
@@ -359,7 +359,7 @@ some tips on how to find the correct dependencies.
</body>
</subsection>
<subsection>
-<title>LICENSE Invalid</title>
+<title>LICENSE invalid</title>
<body>
<p>
@@ -547,7 +547,7 @@ Don't then forget to add <c>virtual/pkgconfig</c> to
BDEPEND!
</section>
<section>
-<title>Common Ebuild Submission Mistakes</title>
+<title>Common ebuild submission mistakes</title>
<subsection>
<title>Introduction</title>
<body>
@@ -560,7 +560,7 @@ Please submit ebuilds properly by following the
</body>
</subsection>
<subsection>
-<title>Tarball'ing an ebuild</title>
+<title>Tarballing an ebuild</title>
<body>
<p>
@@ -571,7 +571,7 @@ operations when reviewing.
</body>
</subsection>
<subsection>
-<title>Inlining Ebuilds</title>
+<title>Inlining ebuilds</title>
<body>
<p>
diff --git a/ebuild-writing/eapi/text.xml b/ebuild-writing/eapi/text.xml
index b6463c0..f470676 100644
--- a/ebuild-writing/eapi/text.xml
+++ b/ebuild-writing/eapi/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/eapi/">
<chapter>
-<title>EAPI Usage and Description</title>
+<title>EAPI usage and description</title>
<body>
<p>
@@ -112,7 +112,7 @@ Manager Specification for details about them.
<title>EAPI 5</title>
<subsection>
-<title>EAPI 5 Metadata</title>
+<title>EAPI 5 metadata</title>
<body>
<dl>
@@ -205,7 +205,7 @@ RDEPEND="dev-libs/foo:2=
</subsection>
<subsection>
-<title>EAPI 5 Profiles</title>
+<title>EAPI 5 profiles</title>
<body>
<dl>
@@ -223,7 +223,7 @@ RDEPEND="dev-libs/foo:2=
</subsection>
<subsection>
-<title>EAPI 5 Helpers</title>
+<title>EAPI 5 helpers</title>
<body>
<dl>
@@ -262,7 +262,7 @@ If USE flag is set, echo [true output][true suffix]
(defaults to "yes"),
</subsection>
<subsection>
-<title>EAPI 5 Phases</title>
+<title>EAPI 5 phases</title>
<body>
<dl>
@@ -277,7 +277,7 @@ If USE flag is set, echo [true output][true suffix]
(defaults to "yes"),
</subsection>
<subsection>
-<title>EAPI 5 Variables</title>
+<title>EAPI 5 variables</title>
<body>
<dl>
@@ -311,7 +311,7 @@ If USE flag is set, echo [true output][true suffix]
(defaults to "yes"),
</subsection>
<subsection>
-<title>EAPI 6 Ebuild Environment</title>
+<title>EAPI 6 ebuild environment</title>
<body>
<dl>
@@ -333,7 +333,7 @@ If USE flag is set, echo [true output][true suffix]
(defaults to "yes"),
</subsection>
<subsection>
-<title>EAPI 6 Phases</title>
+<title>EAPI 6 phases</title>
<body>
<dl>
@@ -376,7 +376,7 @@ src_install() {
</subsection>
<subsection>
-<title>EAPI 6 Helpers</title>
+<title>EAPI 6 helpers</title>
<body>
<dl>
@@ -456,7 +456,7 @@ src_install() {
<title>EAPI 7</title>
<subsection>
-<title>EAPI 7 Terminology</title>
+<title>EAPI 7 terminology</title>
<body>
<p>
@@ -484,7 +484,7 @@ installation targets.
</subsection>
<subsection>
-<title>EAPI 7 Variables</title>
+<title>EAPI 7 variables</title>
<body>
<dl>
@@ -534,7 +534,7 @@ installation targets.
</subsection>
<subsection>
-<title>EAPI 7 Metadata</title>
+<title>EAPI 7 metadata</title>
<body>
<dl>
@@ -552,7 +552,7 @@ installation targets.
</subsection>
<subsection>
-<title>EAPI 7 Profiles</title>
+<title>EAPI 7 profiles</title>
<body>
<dl>
@@ -567,7 +567,7 @@ installation targets.
</subsection>
<subsection>
-<title>EAPI 7 Helpers</title>
+<title>EAPI 7 helpers</title>
<body>
<dl>
diff --git a/ebuild-writing/error-handling/text.xml
b/ebuild-writing/error-handling/text.xml
index f8171f5..28dca4e 100644
--- a/ebuild-writing/error-handling/text.xml
+++ b/ebuild-writing/error-handling/text.xml
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/error-handling/">
<chapter>
-<title>Error Handling</title>
+<title>Error handling</title>
<section>
-<title>Importance of Error Handling</title>
+<title>Importance of error handling</title>
<body>
<p>
@@ -32,7 +32,7 @@ Decent error handling is important because:
</section>
<section>
-<title>The <c>die</c> Function</title>
+<title>The <c>die</c> function</title>
<body>
<p>
@@ -65,7 +65,7 @@ You should use <c>die</c> on almost all external commands in
ebuilds.
</section>
<section>
-<title><c>die</c> and Subshells</title>
+<title><c>die</c> and subshells</title>
<body>
<warning>
@@ -112,7 +112,7 @@ while read file ; do eapply ${file} ; done < list
</section>
<section>
-<title>The <c>assert</c> Function and <c>$PIPESTATUS</c></title>
+<title>The <c>assert</c> function and <c>$PIPESTATUS</c></title>
<body>
<p>
@@ -136,7 +136,7 @@ time, <c>assert</c> is enough.
</section>
<section>
-<title>The <c>nonfatal</c> Command</title>
+<title>The <c>nonfatal</c> command</title>
<body>
<p>
diff --git a/ebuild-writing/file-format/text.xml
b/ebuild-writing/file-format/text.xml
index 3772554..aa7bb72 100644
--- a/ebuild-writing/file-format/text.xml
+++ b/ebuild-writing/file-format/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/file-format/">
<chapter>
-<title>Ebuild File Format</title>
+<title>Ebuild file format</title>
<body>
<p>
@@ -11,7 +11,7 @@ Files should be simple text files with a <c>.ebuild</c>
extension.
</body>
<section>
-<title>File Naming Rules</title>
+<title>File naming rules</title>
<body>
<p>
@@ -178,7 +178,7 @@ like CPU time or memory when being built from source.
</section>
<section>
-<title>Ebuild Header</title>
+<title>Ebuild header</title>
<body>
<p>
@@ -205,7 +205,7 @@ Council on 28 February 2017</uri> and <e>must not</e> be
added any more.
</section>
<section>
-<title>Indenting and Whitespace</title>
+<title>Indenting and whitespace</title>
<body>
<p>
@@ -230,7 +230,7 @@ positions wide, and multibyte characters are just one
position wide.
</section>
<section>
-<title>Character Set</title>
+<title>Character set</title>
<body>
<p>
All ebuilds (and eclasses, metadata files, etc.) must use the
diff --git a/ebuild-writing/functions/pkg_postinst/text.xml
b/ebuild-writing/functions/pkg_postinst/text.xml
index 06b3330..7a160a5 100644
--- a/ebuild-writing/functions/pkg_postinst/text.xml
+++ b/ebuild-writing/functions/pkg_postinst/text.xml
@@ -58,7 +58,7 @@ pkg_postinst() {
</section>
<section>
-<title>Common <c>pkg_postinst</c> Tasks</title>
+<title>Common <c>pkg_postinst</c> tasks</title>
<body>
<p>
The most common use for <c>pkg_postinst</c> is to display post-install
diff --git a/ebuild-writing/functions/pkg_postrm/text.xml
b/ebuild-writing/functions/pkg_postrm/text.xml
index 7e9b475..6607b37 100644
--- a/ebuild-writing/functions/pkg_postrm/text.xml
+++ b/ebuild-writing/functions/pkg_postrm/text.xml
@@ -54,7 +54,7 @@ pkg_postrm() {
</section>
<section>
-<title>Common <c>pkg_postrm</c> Tasks</title>
+<title>Common <c>pkg_postrm</c> tasks</title>
<body>
<p>
<c>pkg_postrm</c> is is used to update symlinks, cache files and other
diff --git a/ebuild-writing/functions/pkg_preinst/text.xml
b/ebuild-writing/functions/pkg_preinst/text.xml
index ee78f6c..cb3a9ab 100644
--- a/ebuild-writing/functions/pkg_preinst/text.xml
+++ b/ebuild-writing/functions/pkg_preinst/text.xml
@@ -52,7 +52,7 @@ pkg_preinst() {
</section>
<section>
-<title>Common <c>pkg_preinst</c> Tasks</title>
+<title>Common <c>pkg_preinst</c> tasks</title>
<body>
<p>
There are a few things that are often done in <c>pkg_preinst</c>:
diff --git a/ebuild-writing/functions/pkg_prerm/text.xml
b/ebuild-writing/functions/pkg_prerm/text.xml
index 7522624..9ce88f4 100644
--- a/ebuild-writing/functions/pkg_prerm/text.xml
+++ b/ebuild-writing/functions/pkg_prerm/text.xml
@@ -52,7 +52,7 @@ pkg_prerm() {
</section>
<section>
-<title>Common <c>pkg_prerm</c> Tasks</title>
+<title>Common <c>pkg_prerm</c> tasks</title>
<body>
<p>
<c>pkg_prerm</c> is used to clean up any files that would otherwise prevent
diff --git a/ebuild-writing/functions/src_compile/build-environment/text.xml
b/ebuild-writing/functions/src_compile/build-environment/text.xml
index 1aa826e..a9fc035 100644
--- a/ebuild-writing/functions/src_compile/build-environment/text.xml
+++ b/ebuild-writing/functions/src_compile/build-environment/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/functions/src_compile/build-environment/">
<chapter>
-<title>Configuring Build Environment</title>
+<title>Configuring build environment</title>
<body>
<p>
@@ -23,7 +23,7 @@ Ebuilds must not simply ignore user CFLAGS, CXXFLAGS or
LDFLAGS <d/> see
</body>
<section>
-<title>Guidelines for Flag Filtering</title>
+<title>Guidelines for flag filtering</title>
<body>
<p>
@@ -59,7 +59,7 @@ line in the correct place.
</section>
<section>
-<title>Simple Flag Stripping</title>
+<title>Simple flag stripping</title>
<body>
<p>
@@ -94,7 +94,7 @@ conservative set of flags.
</section>
<section>
-<title>Flag Replacement</title>
+<title>Flag replacement</title>
<body>
<p>
@@ -124,7 +124,7 @@ the flags to be replaced.
</section>
<section>
-<title>Adding Additional Flags</title>
+<title>Adding additional flags</title>
<body>
<p>
Sometimes it is necessary to add in additional <c>CFLAGS</c>
diff --git a/ebuild-writing/functions/src_compile/building/text.xml
b/ebuild-writing/functions/src_compile/building/text.xml
index 9ac9c13..96aeef8 100644
--- a/ebuild-writing/functions/src_compile/building/text.xml
+++ b/ebuild-writing/functions/src_compile/building/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/functions/src_compile/building/">
<chapter>
-<title>Building a Package</title>
+<title>Building a package</title>
<body>
<p>
@@ -28,7 +28,7 @@ some MIPS and SPARC systems.
</body>
<section>
-<title>Fixing Compiler Usage</title>
+<title>Fixing compiler usage</title>
<body>
<p>
diff --git a/ebuild-writing/functions/src_compile/no-build-system/text.xml
b/ebuild-writing/functions/src_compile/no-build-system/text.xml
index e4e878a..b5d6191 100644
--- a/ebuild-writing/functions/src_compile/no-build-system/text.xml
+++ b/ebuild-writing/functions/src_compile/no-build-system/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/functions/src_compile/no-build-system/">
<chapter>
-<title>No Build System</title>
+<title>No build system</title>
<body>
<p>
diff --git a/ebuild-writing/functions/src_compile/text.xml
b/ebuild-writing/functions/src_compile/text.xml
index abe67d9..a74bbc2 100644
--- a/ebuild-writing/functions/src_compile/text.xml
+++ b/ebuild-writing/functions/src_compile/text.xml
@@ -72,7 +72,7 @@ src_compile() {
</section>
<section>
-<title><c>src_compile</c> Processes</title>
+<title><c>src_compile</c> processes</title>
<body>
<p>
The following subsections cover different topics which often occur when writing
diff --git a/ebuild-writing/functions/src_configure/configuring/text.xml
b/ebuild-writing/functions/src_configure/configuring/text.xml
index 14672c4..f7b3076 100644
--- a/ebuild-writing/functions/src_configure/configuring/text.xml
+++ b/ebuild-writing/functions/src_configure/configuring/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/functions/src_configure/configuring/">
<chapter>
-<title>Configuring a Package</title>
+<title>Configuring a package</title>
<body>
<p>
@@ -75,7 +75,7 @@ form can be used.
</body>
<section>
-<title><c>econf</c> Options</title>
+<title><c>econf</c> options</title>
<body>
<p>
diff --git a/ebuild-writing/functions/src_configure/text.xml
b/ebuild-writing/functions/src_configure/text.xml
index 03f9583..50ccc42 100644
--- a/ebuild-writing/functions/src_configure/text.xml
+++ b/ebuild-writing/functions/src_configure/text.xml
@@ -71,7 +71,7 @@ eclass in order to use the <c>append-ldflags</c> function.
</section>
<section>
-<title><c>src_configure</c> Processes</title>
+<title><c>src_configure</c> processes</title>
<body>
<p>
The following subsections cover different topics which often occur when writing
diff --git a/ebuild-writing/functions/src_install/docompress/text.xml
b/ebuild-writing/functions/src_install/docompress/text.xml
index ed1634b..adaef2b 100644
--- a/ebuild-writing/functions/src_install/docompress/text.xml
+++ b/ebuild-writing/functions/src_install/docompress/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/functions/src_install/docompress/">
<chapter>
-<title>Controllable Compression</title>
+<title>Controllable compression</title>
<body>
<p>
diff --git a/ebuild-writing/functions/src_install/text.xml
b/ebuild-writing/functions/src_install/text.xml
index d6589e9..85cfa6e 100644
--- a/ebuild-writing/functions/src_install/text.xml
+++ b/ebuild-writing/functions/src_install/text.xml
@@ -84,7 +84,7 @@ src_install() {
</section>
<section>
-<title>Easy Installs</title>
+<title>Easy installs</title>
<body>
<p>
Often, especially with autotools-powered packages, there is a <c>Makefile</c>
@@ -129,7 +129,7 @@ applied to different parts of the application, for example.
</section>
<section>
-<title>Trivial Installs</title>
+<title>Trivial installs</title>
<body>
<p>
@@ -209,7 +209,7 @@ simple <c>Makefile</c> driven install.
</section>
<section>
-<title>Other Installs</title>
+<title>Other installs</title>
<body>
<p>
Sometimes, there will be a <c>Makefile</c> that does not
@@ -221,7 +221,7 @@ upstream explaining the situation to them.
</section>
<section>
-<title><c>src_install</c> Processes</title>
+<title><c>src_install</c> processes</title>
<body>
<p>
diff --git a/ebuild-writing/functions/src_prepare/text.xml
b/ebuild-writing/functions/src_prepare/text.xml
index 7f515bb..342a112 100644
--- a/ebuild-writing/functions/src_prepare/text.xml
+++ b/ebuild-writing/functions/src_prepare/text.xml
@@ -83,7 +83,7 @@ src_prepare() {
</section>
<section>
-<title><c>src_prepare</c> Processes</title>
+<title><c>src_prepare</c> processes</title>
<body>
<p>
The following subsections cover different topics which often occur
diff --git a/ebuild-writing/functions/src_unpack/other-formats/text.xml
b/ebuild-writing/functions/src_unpack/other-formats/text.xml
index 809802b..891b322 100644
--- a/ebuild-writing/functions/src_unpack/other-formats/text.xml
+++ b/ebuild-writing/functions/src_unpack/other-formats/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/functions/src_unpack/other-formats/">
<chapter>
-<title>Other Archive Formats</title>
+<title>Other archive formats</title>
<body>
<p>
@@ -11,7 +11,7 @@ Instructions for some of them are detailed below:
</body>
<section>
-<title>Zip Files</title>
+<title>Zip files</title>
<body>
<p>
@@ -27,7 +27,7 @@ If a package is supplied as a .zip file, you should:
</section>
<section>
-<title>Shar Files</title>
+<title>Shar files</title>
<body>
<p>
If a package is supplied as a <c>.shar</c> file, you should repackage it
locally
@@ -39,7 +39,7 @@ done a release in at least ten years.
</section>
<section>
-<title>RAR Files</title>
+<title>RAR files</title>
<body>
<p>
diff --git a/ebuild-writing/functions/src_unpack/rpm-sources/text.xml
b/ebuild-writing/functions/src_unpack/rpm-sources/text.xml
index 5d3a6be..0029c53 100644
--- a/ebuild-writing/functions/src_unpack/rpm-sources/text.xml
+++ b/ebuild-writing/functions/src_unpack/rpm-sources/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/functions/src_unpack/rpm-sources/">
<chapter>
-<title>RPM Sources</title>
+<title>RPM sources</title>
<body>
<p>
@@ -40,7 +40,7 @@ format.
</body>
<section>
-<title>Example RPM Handling</title>
+<title>Example RPM handling</title>
<body>
<p>
diff --git a/ebuild-writing/functions/src_unpack/text.xml
b/ebuild-writing/functions/src_unpack/text.xml
index 045e1c9..250d947 100644
--- a/ebuild-writing/functions/src_unpack/text.xml
+++ b/ebuild-writing/functions/src_unpack/text.xml
@@ -56,7 +56,7 @@ src_unpack() {
</section>
<section>
-<title>Unpacking Tarballs</title>
+<title>Unpacking tarballs</title>
<body>
<p>
The <c>unpack</c> function should be used to unpack tarballs, compressed
@@ -109,7 +109,7 @@ specify the necessary build time dependency
(<c>BDEPEND</c>) for it.
</section>
<section>
-<title><c>src_unpack</c> Actions</title>
+<title><c>src_unpack</c> actions</title>
<body>
<p>
The following subsections cover different topics which often occur when writing
diff --git a/ebuild-writing/functions/src_unpack/vcs-sources/text.xml
b/ebuild-writing/functions/src_unpack/vcs-sources/text.xml
index 0596fef..68fbe91 100644
--- a/ebuild-writing/functions/src_unpack/vcs-sources/text.xml
+++ b/ebuild-writing/functions/src_unpack/vcs-sources/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/functions/src_unpack/vcs-sources/">
<chapter>
-<title>Version Control System (VCS) Sources</title>
+<title>Version Control System (VCS) sources</title>
<body>
<p>
@@ -31,7 +31,7 @@ system for fetching.
</body>
<section>
-<title>Disadvantages of VCS Sources</title>
+<title>Disadvantages of VCS sources</title>
<body>
<p>
@@ -71,7 +71,7 @@ $ git archive --prefix=emacs/ HEAD | xz >
emacs-${PV}.tar.xz
</section>
<section>
-<title>Disadvantages of VCS Live Sources</title>
+<title>Disadvantages of VCS live sources</title>
<body>
<p>
diff --git a/ebuild-writing/functions/text.xml
b/ebuild-writing/functions/text.xml
index 47babef..0c1fbd6 100644
--- a/ebuild-writing/functions/text.xml
+++ b/ebuild-writing/functions/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/functions/">
<chapter>
-<title>Ebuild Phase Functions</title>
+<title>Ebuild phase functions</title>
<body>
<p>
diff --git a/ebuild-writing/messages/text.xml b/ebuild-writing/messages/text.xml
index bfe666c..fe05e6b 100644
--- a/ebuild-writing/messages/text.xml
+++ b/ebuild-writing/messages/text.xml
@@ -28,7 +28,7 @@ occupy 4 columns with their fancy leading markers.
</body>
<section>
-<title>Information Messages</title>
+<title>Information messages</title>
<body>
<p>
@@ -70,7 +70,7 @@ src_compile() {
</section>
<section>
-<title>Warning Messages</title>
+<title>Warning messages</title>
<body>
<p>
@@ -82,7 +82,7 @@ used for warning messages rather than information.
</section>
<section>
-<title>Error Messages</title>
+<title>Error messages</title>
<body>
<p>
@@ -119,7 +119,7 @@ See <uri link="::function-reference/message-functions/"/>
for a full list of fun
</section>
<section>
-<title>Good and Bad Messages</title>
+<title>Good and bad messages</title>
<body>
<p>
diff --git a/ebuild-writing/misc-files/metadata/text.xml
b/ebuild-writing/misc-files/metadata/text.xml
index fb0dab1..cde4364 100644
--- a/ebuild-writing/misc-files/metadata/text.xml
+++ b/ebuild-writing/misc-files/metadata/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/misc-files/metadata/">
<chapter>
-<title>Package and Category <c>metadata.xml</c></title>
+<title>Package and category <c>metadata.xml</c></title>
<body>
<p>
@@ -351,7 +351,7 @@ There are also some attributes that can be used with these
tags:
</body>
</section>
<section>
-<title>Package Metadata</title>
+<title>Package metadata</title>
<body>
<p>
All packages <b>must</b> include a <c>metadata.xml</c> file which
@@ -381,7 +381,7 @@ GLEP 67</uri>.
</body>
<subsection>
-<title>Package Metadata Examples</title>
+<title>Package metadata examples</title>
<body>
<p>
@@ -393,7 +393,7 @@ these files verbatim and should be taken as hypothetical
examples.
</body>
<subsubsection>
-<title>Projects as Maintainers</title>
+<title>Projects as maintainers</title>
<body>
<p>
@@ -458,7 +458,7 @@ projects listing</uri> available on the Gentoo Wiki:
</body>
</subsubsection>
<subsubsection>
-<title>Local USE Flag Descriptions</title>
+<title>Local USE flag descriptions</title>
<body>
<p>
@@ -505,7 +505,7 @@ as opposed to a URL. Conversely, email addresses specified
in the
</body>
</subsubsection>
<subsubsection>
-<title>Split Maintainership</title>
+<title>Split maintainership</title>
<body>
<p>
@@ -574,7 +574,7 @@ is demonstrated.
</body>
</subsubsection>
<subsubsection>
-<title>Slots and Subslots</title>
+<title>Slots and subslots</title>
<body>
<p>
@@ -679,7 +679,7 @@ part of the QA reports.
</section>
<section>
-<title>Category Metadata</title>
+<title>Category metadata</title>
<body>
<p>
For categories, <c>metadata.xml</c> specifies a long description (in
diff --git a/ebuild-writing/misc-files/patches/text.xml
b/ebuild-writing/misc-files/patches/text.xml
index 56ba94c..c71551b 100644
--- a/ebuild-writing/misc-files/patches/text.xml
+++ b/ebuild-writing/misc-files/patches/text.xml
@@ -54,7 +54,7 @@ up the tree too much.
</body>
<section>
-<title>Patch Descriptions</title>
+<title>Patch descriptions</title>
<body>
<p>
It is possible to include a description with a patch. This is often
@@ -172,7 +172,7 @@ allows them to be applied unconditionally.
</section>
<section>
-<title>Clean Patch Howto</title>
+<title>Clean patch guide</title>
<body>
<p>
@@ -199,7 +199,7 @@ assess a patch without searching through many other files.
</subsection>
<subsection>
-<title>File Naming</title>
+<title>File naming</title>
<body>
<p>
diff --git a/ebuild-writing/misc-files/text.xml
b/ebuild-writing/misc-files/text.xml
index 3ea435c..3fe6026 100644
--- a/ebuild-writing/misc-files/text.xml
+++ b/ebuild-writing/misc-files/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/misc-files/">
<chapter>
-<title>Miscellaneous Files</title>
+<title>Miscellaneous files</title>
<body>
<p>
diff --git a/ebuild-writing/text.xml b/ebuild-writing/text.xml
index 0be139b..0817a04 100644
--- a/ebuild-writing/text.xml
+++ b/ebuild-writing/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/">
<chapter>
-<title>Ebuild Writing</title>
+<title>Ebuild writing</title>
<body>
<p>
diff --git a/ebuild-writing/use-conditional-code/text.xml
b/ebuild-writing/use-conditional-code/text.xml
index 655bbaa..57ea99a 100644
--- a/ebuild-writing/use-conditional-code/text.xml
+++ b/ebuild-writing/use-conditional-code/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/use-conditional-code/">
<chapter>
-<title>USE Flag Conditional Code</title>
+<title>USE flag conditional code</title>
<body>
<p>
diff --git a/ebuild-writing/user-submitted/text.xml
b/ebuild-writing/user-submitted/text.xml
index 58a372d..15576fb 100644
--- a/ebuild-writing/user-submitted/text.xml
+++ b/ebuild-writing/user-submitted/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/user-submitted/">
<chapter>
-<title>User-submitted Ebuilds</title>
+<title>User-submitted ebuilds</title>
<body>
diff --git a/ebuild-writing/users-and-groups/text.xml
b/ebuild-writing/users-and-groups/text.xml
index 80f9b5b..679d028 100644
--- a/ebuild-writing/users-and-groups/text.xml
+++ b/ebuild-writing/users-and-groups/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/users-and-groups/">
<chapter>
-<title>Users and Groups</title>
+<title>Users and groups</title>
<body>
<p>
diff --git a/ebuild-writing/using-eclasses/text.xml
b/ebuild-writing/using-eclasses/text.xml
index db41d25..7fa2c7b 100644
--- a/ebuild-writing/using-eclasses/text.xml
+++ b/ebuild-writing/using-eclasses/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="ebuild-writing/using-eclasses/">
<chapter>
-<title>Using Eclasses</title>
+<title>Using eclasses</title>
<body>
<p>
@@ -14,7 +14,7 @@ how to use an eclass which has already been written.
</body>
<section>
-<title>The <c>inherit</c> Function</title>
+<title>The <c>inherit</c> function</title>
<body>
<p>
diff --git a/ebuild-writing/variables/text.xml
b/ebuild-writing/variables/text.xml
index 67c9887..6b8565b 100644
--- a/ebuild-writing/variables/text.xml
+++ b/ebuild-writing/variables/text.xml
@@ -12,7 +12,7 @@ which are of use throughout the ebuild.
</body>
<section>
-<title>Predefined Read-Only Variables</title>
+<title>Predefined read-only variables</title>
<body>
<p>
@@ -238,7 +238,7 @@ pkg_postinst() {
</section>
<section>
-<title>Ebuild-defined Variables</title>
+<title>Ebuild-defined variables</title>
<body>
<p>
@@ -403,7 +403,7 @@ The following variables may or must be defined by every
ebuild.
<title>SRC_URI</title>
<subsubsection>
-<title>Conditional Sources</title>
+<title>Conditional sources</title>
<body>
<p>
@@ -424,7 +424,7 @@ SRC_URI="https://example.com/files/${P}-core.tar.bz2
</subsubsection>
<subsubsection>
-<title>Renaming Sources</title>
+<title>Renaming sources</title>
<body>
<p>
@@ -756,7 +756,7 @@ strings (ignoring case):
</section>
<section>
-<title>Version and Name Formatting Issues</title>
+<title>Version and name formatting issues</title>
<body>
<p>
@@ -857,7 +857,7 @@ here</uri>, courtesy of Gentoo developer mgorny.
</section>
<section>
-<title>Trailing Slashes in Variables</title>
+<title>Trailing slashes in variables</title>
<body>
<p>
diff --git a/eclass-writing/text.xml b/eclass-writing/text.xml
index a8d373a..d93e2b0 100644
--- a/eclass-writing/text.xml
+++ b/eclass-writing/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="eclass-writing/">
<chapter>
-<title>Eclass Writing Guide</title>
+<title>Eclass writing guide</title>
<body>
<p>
@@ -16,7 +16,7 @@ and <uri link="::general-concepts/portage-cache/"/> sections
before continuing.
</body>
<section>
-<title>Purpose of Eclasses</title>
+<title>Purpose of eclasses</title>
<body>
<p>
@@ -45,7 +45,7 @@ Roughly speaking, there are three kinds of eclass:
</section>
<section>
-<title>Adding and Updating Eclasses</title>
+<title>Adding and updating eclasses</title>
<body>
<p>
@@ -110,7 +110,7 @@ batch push them at once where possible.
</section>
<section>
-<title>Removing Eclasses</title>
+<title>Removing eclasses</title>
<body>
<p>
@@ -147,7 +147,7 @@ least 30 days before removing the eclass.
</section>
<section>
-<title>Documenting Eclasses</title>
+<title>Documenting eclasses</title>
<body>
<p>
@@ -182,7 +182,7 @@ to properly break lines when generating eclass manpages.
</section>
<section>
-<title>Basic Eclass Format</title>
+<title>Basic eclass format</title>
<body>
<p>
@@ -303,7 +303,7 @@ summarizes the available documentation tags:
</section>
<section>
-<title>Eclass Variables</title>
+<title>Eclass variables</title>
<body>
<p>
@@ -404,7 +404,7 @@ variables are as follows:
</section>
<section>
-<title>Eclass Functions</title>
+<title>Eclass functions</title>
<body>
<p>
@@ -491,7 +491,7 @@ documentation are:
</body>
</section>
<section>
-<title>Eclass Function Variables</title>
+<title>Eclass function variables</title>
<body>
<p>
@@ -568,7 +568,7 @@ using the following tags:
</section>
<section>
-<title>Simple Common Functions Eclass Example</title>
+<title>Simple common functions eclass example</title>
<body>
<p>
@@ -605,7 +605,7 @@ domacosapp() {
</section>
<section>
-<title>Export Functions</title>
+<title>Export functions</title>
<body>
<p>
@@ -764,7 +764,7 @@ esac
</section>
<section>
-<title>Simple Build System Eclass Example</title>
+<title>Simple build system eclass example</title>
<body>
<p>
diff --git a/function-reference/build-functions/text.xml
b/function-reference/build-functions/text.xml
index 5d5b6ab..09e6053 100644
--- a/function-reference/build-functions/text.xml
+++ b/function-reference/build-functions/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="function-reference/build-functions/">
<chapter>
-<title>Build Functions Reference</title>
+<title>Build functions reference</title>
<body>
diff --git a/function-reference/error-functions/text.xml
b/function-reference/error-functions/text.xml
index 272784e..f3a542b 100644
--- a/function-reference/error-functions/text.xml
+++ b/function-reference/error-functions/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="function-reference/error-functions/">
<chapter>
-<title>Error Functions Reference</title>
+<title>Error functions reference</title>
<body>
<p>
diff --git a/function-reference/install-functions/text.xml
b/function-reference/install-functions/text.xml
index 0d37980..a221527 100644
--- a/function-reference/install-functions/text.xml
+++ b/function-reference/install-functions/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="function-reference/install-functions/">
<chapter>
-<title>Install Functions Reference</title>
+<title>Install functions reference</title>
<body>
<p>
diff --git a/function-reference/message-functions/text.xml
b/function-reference/message-functions/text.xml
index e5ea04f..cde7eb6 100644
--- a/function-reference/message-functions/text.xml
+++ b/function-reference/message-functions/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="function-reference/message-functions/">
<chapter>
-<title>Message Functions Reference</title>
+<title>Message functions reference</title>
<body>
<p>
diff --git a/function-reference/query-functions/text.xml
b/function-reference/query-functions/text.xml
index 077e2cd..ec7e069 100644
--- a/function-reference/query-functions/text.xml
+++ b/function-reference/query-functions/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="function-reference/query-functions/">
<chapter>
-<title>Query Functions Reference</title>
+<title>Query functions reference</title>
<body>
<p>
diff --git a/function-reference/sandbox-functions/text.xml
b/function-reference/sandbox-functions/text.xml
index ca5df54..86cf05c 100644
--- a/function-reference/sandbox-functions/text.xml
+++ b/function-reference/sandbox-functions/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="function-reference/sandbox-functions/">
<chapter>
-<title>Sandbox Functions Reference</title>
+<title>Sandbox functions reference</title>
<body>
<p>
diff --git a/function-reference/text.xml b/function-reference/text.xml
index a6ee821..d8e844f 100644
--- a/function-reference/text.xml
+++ b/function-reference/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="function-reference/">
<chapter>
-<title>Function Reference</title>
+<title>Function reference</title>
<body>
<p>
diff --git a/general-concepts/autotools/text.xml
b/general-concepts/autotools/text.xml
index 09162ff..02a3554 100644
--- a/general-concepts/autotools/text.xml
+++ b/general-concepts/autotools/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/autotools/">
<chapter>
-<title>The Basics of Autotools</title>
+<title>The basics of Autotools</title>
<body>
<todo>
@@ -33,7 +33,7 @@ when working with ebuilds:
</body>
<section>
-<title>Major Autotools Components</title>
+<title>Major Autotools components</title>
<body>
<p>
@@ -108,7 +108,7 @@ instead.
</section>
<section>
-<title>Simple Autotools Patching Example</title>
+<title>Simple Autotools patching example</title>
<body>
<p>
@@ -146,7 +146,7 @@ src_configure() {
</section>
<section>
-<title>The <c>configure.ac</c> File</title>
+<title>The <c>configure.ac</c> file</title>
<body>
<p>
@@ -159,7 +159,7 @@ These macros can check for packages and libraries, handle
<c>--enable</c> and
</body>
<subsection>
-<title>Basic Format of <c>configure.ac</c></title>
+<title>Basic format of <c>configure.ac</c></title>
<body>
<p>
@@ -289,7 +289,7 @@ These are used to make the <c>./configure</c> script
generate the relevant files
</subsection>
<subsection>
-<title>Enable and Disable Checks</title>
+<title>Enable and disable checks</title>
<body>
<p>
@@ -346,7 +346,7 @@ misunderstanding of the <c>AC_ARG_ENABLE</c> arguments is
to blame.
</subsection>
<subsection>
-<title>With and Without Checks</title>
+<title>With and without checks</title>
<body>
<p>
@@ -371,7 +371,7 @@ and there are standard macros which include <c>with</c>
options.
</subsection>
<subsection>
-<title>Automatic Checks</title>
+<title>Automatic checks</title>
<body>
<p>
@@ -390,7 +390,7 @@ whether or not to enable a feature. If you find a package
which does this, you
</subsection>
<subsection>
-<title>Quoting Rules for <c>configure.ac</c></title>
+<title>Quoting rules for <c>configure.ac</c></title>
<body>
<p>
@@ -439,7 +439,7 @@ rather than leaving things unquoted.
</section>
<section>
-<title>The <c>Makefile.am</c> Files</title>
+<title>The <c>Makefile.am</c> files</title>
<body>
<p>
@@ -490,7 +490,7 @@ This is handled via the macro <c>AC_SUBST(VARNAME)</c> in
<c>configure.ac</c>.
</body>
<subsection>
-<title>Makefile Variables</title>
+<title>Makefile variables</title>
<body>
<p>
@@ -527,7 +527,7 @@ Remember to manually run <c>autoconf</c> then
<c>automake</c> if you do this.
</section>
<section>
-<title>The <c>config.h.in</c> File</title>
+<title>The <c>config.h.in</c> file</title>
<body>
<p>
@@ -541,7 +541,7 @@ version.
</section>
<section>
-<title><c>aclocal</c> and <c>m4</c> Files</title>
+<title><c>aclocal</c> and <c>m4</c> files</title>
<body>
<p>
@@ -646,7 +646,7 @@ know almost nothing about... Yay!
</section>
<section>
-<title>Further Autotools Reading</title>
+<title>Further autotools reading</title>
<body>
<p>
diff --git a/general-concepts/config-protect/text.xml
b/general-concepts/config-protect/text.xml
index acbb89d..1d598a3 100644
--- a/general-concepts/config-protect/text.xml
+++ b/general-concepts/config-protect/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/config-protect/">
<chapter>
-<title>Configuration File Protection</title>
+<title>Configuration file protection</title>
<body>
<p>
diff --git a/general-concepts/copyright-policy/text.xml
b/general-concepts/copyright-policy/text.xml
index c8d6865..5fb9d19 100644
--- a/general-concepts/copyright-policy/text.xml
+++ b/general-concepts/copyright-policy/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/copyright-policy/">
<chapter>
-<title>Copyright Policy</title>
+<title>Copyright policy</title>
<body>
<p>
diff --git a/general-concepts/dependencies/text.xml
b/general-concepts/dependencies/text.xml
index 98a84d1..29998cd 100644
--- a/general-concepts/dependencies/text.xml
+++ b/general-concepts/dependencies/text.xml
@@ -68,7 +68,7 @@ distinctions still apply even if it isn't, strictly speaking,
cross-compiling.
</subsection>
<subsection>
-<title>Build Dependencies</title>
+<title>Build dependencies</title>
<body>
<p>
@@ -94,7 +94,7 @@ In earlier EAPIs, all build dependencies are placed in
<c>DEPEND</c>.
</subsection>
<subsection>
-<title>Runtime Dependencies</title>
+<title>Runtime dependencies</title>
<body>
<p>
@@ -118,7 +118,7 @@ Items which are in <c>RDEPEND</c> but not <c>DEPEND</c>
could <e>in theory</e> b
</subsection>
<subsection>
-<title>Post Dependencies</title>
+<title>Post dependencies</title>
<body>
<p>
@@ -133,10 +133,10 @@ while in general case <c>RDEPEND</c> should be used
instead.
</section>
<section>
-<title>Dependency Syntax</title>
+<title>Dependency syntax</title>
<subsection>
-<title>Basic Dependency Syntax</title>
+<title>Basic dependency syntax</title>
<body>
<p>
@@ -160,7 +160,7 @@ When specifying names, the category part should be treated
as mandatory.
</subsection>
<subsection>
-<title>Version Dependencies</title>
+<title>Version dependencies</title>
<body>
<p>
@@ -178,7 +178,7 @@ This states that at least version 0.9.7d of <c>openssl</c>
is required.
</body>
<subsubsection>
-<title>Version Specifiers</title>
+<title>Version specifiers</title>
<body>
<p>
@@ -223,7 +223,7 @@ Available version specifiers are:
</subsubsection>
<subsubsection>
-<title>Ranged Dependencies</title>
+<title>Ranged dependencies</title>
<body>
<p>
@@ -351,7 +351,7 @@ newer package that caused the issues.
</subsection>
<subsection>
-<title>SLOT Dependencies</title>
+<title>SLOT dependencies</title>
<body>
<p>
@@ -375,7 +375,7 @@ DEPEND="qt5? ( ~dev-qt/qtcore-5.15.2:5 )
</body>
<subsubsection>
-<title>Slot Operators</title>
+<title>Slot operators</title>
<body>
<p>
@@ -458,7 +458,7 @@ sub-slot changes of <c>wombat:0</c> should be ignored.
</subsection>
<subsection>
-<title>USE-Conditional Dependencies</title>
+<title>USE-conditional dependencies</title>
<body>
<p>
@@ -514,7 +514,7 @@ DEPEND="!build? (
</subsection>
<subsection>
-<title>Any of Many Dependencies</title>
+<title>Any of many dependencies</title>
<body>
<note>
@@ -541,7 +541,7 @@ DEPEND="baz? ( || ( app-misc/foo app-misc/bar ) )"
</body>
<subsubsection>
-<title>Any of Many Versus USE</title>
+<title>Any of many versus USE</title>
<body>
<p>
@@ -566,7 +566,7 @@ flag is not necessary if and only if all of the following
hold:
</subsection>
<subsection>
-<title>Built with USE Dependencies</title>
+<title>Built with USE dependencies</title>
<body>
<p>
@@ -650,7 +650,7 @@ DEPEND="
</section>
<section>
-<title>Tips for Checking Dependencies</title>
+<title>Tips for checking dependencies</title>
<body>
<p>
@@ -710,7 +710,7 @@ package:
</section>
<section>
-<title>Implicit System Dependency</title>
+<title>Implicit system dependency</title>
<body>
<p>
@@ -738,7 +738,7 @@ tarball.
</section>
<section>
-<title>Test Dependencies</title>
+<title>Test dependencies</title>
<body>
<p>
@@ -776,7 +776,7 @@ DEPEND="test? ( dev-util/foo )"
</section>
<section>
-<title>Circular Dependencies</title>
+<title>Circular dependencies</title>
<body>
<p>
diff --git a/general-concepts/ebuild-revisions/text.xml
b/general-concepts/ebuild-revisions/text.xml
index 8248a6e..d363516 100644
--- a/general-concepts/ebuild-revisions/text.xml
+++ b/general-concepts/ebuild-revisions/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/ebuild-revisions/">
<chapter>
-<title>Ebuild Revisions</title>
+<title>Ebuild revisions</title>
<body>
<p>
diff --git a/general-concepts/emerge-and-ebuild/text.xml
b/general-concepts/emerge-and-ebuild/text.xml
index 19e1a84..87605a2 100644
--- a/general-concepts/emerge-and-ebuild/text.xml
+++ b/general-concepts/emerge-and-ebuild/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/emerge-and-ebuild/">
<chapter>
-<title>Emerge and Ebuild Relationships</title>
+<title>Emerge and ebuild relationships</title>
<body>
diff --git a/general-concepts/git-to-rsync/text.xml
b/general-concepts/git-to-rsync/text.xml
index b8f7dce..455cf13 100644
--- a/general-concepts/git-to-rsync/text.xml
+++ b/general-concepts/git-to-rsync/text.xml
@@ -30,7 +30,7 @@
</ul>
<figure short="Git to RSYNC Propagation" link="diagram.png"
- caption="Diagram showing Git to RSYNC Propagation" />
+ caption="Diagram showing Git to RSYNC propagation" />
<p>
The <c>emerge-websync</c> snapshot is made daily from the staging box.
diff --git a/general-concepts/install-destinations/text.xml
b/general-concepts/install-destinations/text.xml
index 5413ebc..57db917 100644
--- a/general-concepts/install-destinations/text.xml
+++ b/general-concepts/install-destinations/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/install-destinations/">
<chapter>
-<title>Install Destinations</title>
+<title>Install destinations</title>
<body>
diff --git a/general-concepts/licenses/text.xml
b/general-concepts/licenses/text.xml
index 939b429..655175a 100644
--- a/general-concepts/licenses/text.xml
+++ b/general-concepts/licenses/text.xml
@@ -226,7 +226,7 @@ indicates <c>GPL-2+</c> license:
</section>
<section>
-<title>Adding New Licenses</title>
+<title>Adding new licenses</title>
<body>
<p>
diff --git a/general-concepts/mailing-lists/text.xml
b/general-concepts/mailing-lists/text.xml
index 8787b13..f91d1cf 100644
--- a/general-concepts/mailing-lists/text.xml
+++ b/general-concepts/mailing-lists/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/mailing-lists/">
<chapter>
-<title>Mailing Lists</title>
+<title>Mailing lists</title>
<body>
<p>
diff --git a/general-concepts/manifest/text.xml
b/general-concepts/manifest/text.xml
index bee1651..11ed7cb 100644
--- a/general-concepts/manifest/text.xml
+++ b/general-concepts/manifest/text.xml
@@ -4,7 +4,7 @@
<title>Manifest</title>
<section>
-<title>Generating the Manifest</title>
+<title>Generating the Manifest file</title>
<body>
<p>
In the tree, every package has a <c>Manifest</c> file. This file lives
@@ -41,7 +41,7 @@ action from developers.
</subsection>
<subsection>
-<title>Updating <c>Manifest</c> files</title>
+<title>Updating Manifest files</title>
<body>
<p>
diff --git a/general-concepts/mirrors/text.xml
b/general-concepts/mirrors/text.xml
index f380d45..927a3a6 100644
--- a/general-concepts/mirrors/text.xml
+++ b/general-concepts/mirrors/text.xml
@@ -4,7 +4,7 @@
<title>Mirrors</title>
<section>
-<title>Automatic Mirroring</title>
+<title>Automatic mirroring</title>
<body>
<p>
@@ -22,7 +22,7 @@ rearranged, tidied out or having files modified.
</body>
<subsection>
-<title>Restricting Automatic Mirroring</title>
+<title>Restricting automatic mirroring</title>
<body>
<p>
Three <c>RESTRICT</c> keywords can be used to control the mirroring process.
@@ -50,7 +50,7 @@ This should only be used if a license requires it.
</subsection>
<subsection>
-<title>Replacing Automatically Mirrored Files</title>
+<title>Replacing automatically mirrored files</title>
<body>
<p>
On rare occasions you may need to replace a file that is already mirrored.
@@ -83,7 +83,7 @@ Infrastructure project's Distfile Mirroring System page</uri>.
<subsection>
-<title>Suitable Download Hosts</title>
+<title>Suitable download hosts</title>
<body>
<p>
If you have to host a source file (patch or tarball) yourself, as long as it
@@ -127,7 +127,7 @@ Not doing so can cause all kinds of problems with strict
firewalls.
</section>
<section>
-<title>Mirroring Process</title>
+<title>Mirroring process</title>
<body>
<figure short="Mirroring Process" link="diagram.png"
diff --git a/general-concepts/news/text.xml b/general-concepts/news/text.xml
index 3ff5c32..88fb12b 100644
--- a/general-concepts/news/text.xml
+++ b/general-concepts/news/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/news/">
<chapter>
-<title>News Items</title>
+<title>News items</title>
<body>
<p>
diff --git a/general-concepts/overlay/text.xml
b/general-concepts/overlay/text.xml
index 43d1607..77e7190 100644
--- a/general-concepts/overlay/text.xml
+++ b/general-concepts/overlay/text.xml
@@ -34,7 +34,7 @@ override existing entries.
</body>
<section>
-<title>Overlay and Eclasses</title>
+<title>Overlay and eclasses</title>
<body>
<p>
diff --git a/general-concepts/package-collisions/text.xml
b/general-concepts/package-collisions/text.xml
index 66536ee..0b168b5 100644
--- a/general-concepts/package-collisions/text.xml
+++ b/general-concepts/package-collisions/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/package-collisions/">
<chapter>
-<title>Package Collisions</title>
+<title>Package collisions</title>
<body>
<p>
diff --git a/general-concepts/package-maintainers/text.xml
b/general-concepts/package-maintainers/text.xml
index 6d37795..0773859 100644
--- a/general-concepts/package-maintainers/text.xml
+++ b/general-concepts/package-maintainers/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/package-maintainers/">
<chapter>
-<title>Package Maintainers</title>
+<title>Package maintainers</title>
<body>
<p>
diff --git a/general-concepts/portage-cache/text.xml
b/general-concepts/portage-cache/text.xml
index 96fea32..2b40d26 100644
--- a/general-concepts/portage-cache/text.xml
+++ b/general-concepts/portage-cache/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/portage-cache/">
<chapter>
-<title>The Portage Cache</title>
+<title>The Portage cache</title>
<body>
<p>
@@ -54,7 +54,7 @@ fi
</body>
<section>
-<title>Conditional Inherits</title>
+<title>Conditional inherits</title>
<body>
<p>
Because eclasses modify various cached variables, conditional inheritance is
not
diff --git a/general-concepts/projects/text.xml
b/general-concepts/projects/text.xml
index 19188d4..203c364 100644
--- a/general-concepts/projects/text.xml
+++ b/general-concepts/projects/text.xml
@@ -30,7 +30,7 @@ api.gentoo.org</uri> or on the
</body>
<section>
-<title>Starting New Projects</title>
+<title>Starting new projects</title>
<body>
<p>
@@ -62,7 +62,7 @@ project with the same goals.
</section>
<section>
-<title>Joining and Leaving a Project</title>
+<title>Joining and leaving a project</title>
<body>
<p>
diff --git a/general-concepts/slotting/text.xml
b/general-concepts/slotting/text.xml
index 9eabf08..a0fb1e1 100644
--- a/general-concepts/slotting/text.xml
+++ b/general-concepts/slotting/text.xml
@@ -46,7 +46,7 @@ To <c>DEPEND</c> upon a package in a specific slot, refer to
</body>
<section>
-<title>Sub-Slots</title>
+<title>Sub-slots</title>
<body>
<p>
@@ -217,7 +217,7 @@ to represent in some way ABI compatibility.
</section>
<section>
-<title>Slot Names</title>
+<title>Slot names</title>
<body>
<p>
diff --git a/general-concepts/text.xml b/general-concepts/text.xml
index c10d1fd..5f7f094 100644
--- a/general-concepts/text.xml
+++ b/general-concepts/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/">
<chapter>
-<title>General Concepts</title>
+<title>General concepts</title>
<body>
<p>
diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml
index 9fb9cb9..e686b54 100644
--- a/general-concepts/tree/text.xml
+++ b/general-concepts/tree/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/tree/">
<chapter>
-<title>The Gentoo Repository</title>
+<title>The Gentoo repository</title>
<body>
<p>
@@ -80,7 +80,7 @@ The basic layout of the Gentoo repository is as follows:
</body>
<section>
-<title>What Belongs in the Tree?</title>
+<title>What belongs in the tree?</title>
<body>
<p>
diff --git a/general-concepts/use-flags/text.xml
b/general-concepts/use-flags/text.xml
index 5caa430..6a32e61 100644
--- a/general-concepts/use-flags/text.xml
+++ b/general-concepts/use-flags/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/use-flags/">
<chapter>
-<title>USE Flags</title>
+<title>USE flags</title>
<body>
<p>
@@ -121,7 +121,7 @@ features at compile time (via pre-processor macros).
</section>
<section>
-<title><c>noblah</c> USE Flags</title>
+<title><c>noblah</c> USE flags</title>
<body>
<p>
Avoid <c>noblah</c> style <c>USE</c> flags. These break <c>use.mask</c> and
@@ -269,7 +269,7 @@ gentoo-dev mailing list.
</section>
<section>
-<title>USE Flag Descriptions</title>
+<title>USE flag descriptions</title>
<body>
<p>
All USE flags must be described in either <c>use.desc</c> in the
@@ -294,7 +294,7 @@ for the format, and remember to keep them sorted.
</section>
<section>
-<title>Conflicting USE Flags</title>
+<title>Conflicting USE flags</title>
<body>
<p>
Occasionally, ebuilds will have conflicting USE flags for functionality.
@@ -351,7 +351,7 @@ needs.
</section>
<section>
-<title>USE_EXPAND and ARCH USE Flags</title>
+<title>USE_EXPAND and ARCH USE flags</title>
<body>
<p>
diff --git a/general-concepts/user-environment/text.xml
b/general-concepts/user-environment/text.xml
index b472ea5..5635a3f 100644
--- a/general-concepts/user-environment/text.xml
+++ b/general-concepts/user-environment/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="general-concepts/user-environment/">
<chapter>
-<title>User Environment</title>
+<title>User environment</title>
<body>
<p>
@@ -16,7 +16,7 @@ performed upon the environment.
</body>
<section>
-<title>Filtering Variables</title>
+<title>Filtering variables</title>
<body>
<p>
Certain variables will really really upset certain build systems. A good
example
@@ -42,7 +42,7 @@ pkg_setup() {
</section>
<section>
-<title>Not Filtering Variables</title>
+<title>Not filtering variables</title>
<body>
<p>
On the other hand, it is extremely important that certain user preferences are
diff --git a/hosted-projects/text.xml b/hosted-projects/text.xml
index d7e5ec9..8ce75b3 100644
--- a/hosted-projects/text.xml
+++ b/hosted-projects/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="hosted-projects/">
<chapter>
-<title>Hosted Projects</title>
+<title>Hosted projects</title>
<body>
<p>
@@ -11,7 +11,7 @@ prevent a repeat of the <c>genkernel</c> disaster.
</body>
<section>
-<title>Documentation Requirement</title>
+<title>Documentation requirement</title>
<body>
<p>
@@ -21,7 +21,7 @@ and not left as "something we'll do later (honest)".
</p>
<p>
-Our documentation team are happy to help out with GuideXMLification,
translation
+Our documentation team is happy to help out with GuideXMLification, translation
etc. for the user documentation, but they <e>need</e> various things to do
this:
</p>
@@ -108,7 +108,7 @@ In practice, this means the following:
</section>
<section>
-<title>Open / Free</title>
+<title>Open / free</title>
<body>
<p>
diff --git a/keywording/text.xml b/keywording/text.xml
index 4d87934..4174249 100644
--- a/keywording/text.xml
+++ b/keywording/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="keywording/">
<chapter>
-<title>Keywording and Stabilization</title>
+<title>Keywording and stabilization</title>
<body>
<note>
@@ -100,7 +100,7 @@ do not specify a <c>KEYWORDS</c> variable.
</body>
<section>
-<title>Equal Visibility Requirement</title>
+<title>Equal visibility requirement</title>
<body>
<p>
@@ -127,7 +127,7 @@ better visibility than the package in question.
</section>
<section>
-<title>Hard Masks</title>
+<title>Hard masks</title>
<body>
<p>
@@ -156,7 +156,7 @@ appear on a user system</b>.
</section>
<section>
-<title>Keywording New Packages</title>
+<title>Keywording new packages</title>
<body>
<important>
@@ -202,7 +202,7 @@ Do <b>not</b> commit straight to <c>arch</c> ("stable").
</section>
<section>
-<title>Keywording on Upgrades</title>
+<title>Keywording on upgrades</title>
<body>
<p>
@@ -497,7 +497,7 @@ bugs, but instead let <c>NATTkA</c> set it automatically
based on metadata.xml.
</section>
<section>
-<title>Removing Package Versions</title>
+<title>Removing package versions</title>
<body>
<p>
diff --git a/profiles/info_files/text.xml b/profiles/info_files/text.xml
index 29258be..22f9cd2 100644
--- a/profiles/info_files/text.xml
+++ b/profiles/info_files/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="profiles/info_files/">
<chapter>
-<title>Profiles <c>info_</c> Files</title>
+<title>Profiles <c>info_</c> files</title>
<body>
<p>
diff --git a/profiles/make.defaults/text.xml b/profiles/make.defaults/text.xml
index 1be4bde..18221d4 100644
--- a/profiles/make.defaults/text.xml
+++ b/profiles/make.defaults/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="profiles/make.defaults/">
<chapter>
-<title>Profiles <c>make.defaults</c> File</title>
+<title>Profiles <c>make.defaults</c> file</title>
<body>
<p>
diff --git a/profiles/package.mask/text.xml b/profiles/package.mask/text.xml
index 7f8c84a..9b6bc1d 100644
--- a/profiles/package.mask/text.xml
+++ b/profiles/package.mask/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="profiles/package.mask/">
<chapter>
-<title>Profiles <c>package.mask</c> File</title>
+<title>Profiles <c>package.mask</c> file</title>
<body>
<p>
diff --git a/profiles/packages/text.xml b/profiles/packages/text.xml
index 990a70b..3ae80e4 100644
--- a/profiles/packages/text.xml
+++ b/profiles/packages/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="profiles/packages/">
<chapter>
-<title>Profiles <c>packages</c> File</title>
+<title>Profiles <c>packages</c> file</title>
<body>
<p>
diff --git a/profiles/updates/text.xml b/profiles/updates/text.xml
index ae102d3..6e44507 100644
--- a/profiles/updates/text.xml
+++ b/profiles/updates/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="profiles/updates/">
<chapter>
-<title>Profiles <c>updates/</c> Directory</title>
+<title>Profiles <c>updates/</c> directory</title>
<body>
<p>
diff --git a/profiles/use.desc/text.xml b/profiles/use.desc/text.xml
index 301c53e..3ea5f65 100644
--- a/profiles/use.desc/text.xml
+++ b/profiles/use.desc/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="profiles/use.desc/">
<chapter>
-<title>Profiles <c>use.desc</c> and <c>use.local.desc</c> Files</title>
+<title>Profiles <c>use.desc</c> and <c>use.local.desc</c> files</title>
<body>
<p>
diff --git a/profiles/use.mask/text.xml b/profiles/use.mask/text.xml
index f3c080c..4de9686 100644
--- a/profiles/use.mask/text.xml
+++ b/profiles/use.mask/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="profiles/use.mask/">
<chapter>
-<title>Profiles <c>use.mask</c> File</title>
+<title>Profiles <c>use.mask</c> file</title>
<body>
<p>
diff --git a/quickstart/text.xml b/quickstart/text.xml
index f493f44..f311ad9 100644
--- a/quickstart/text.xml
+++ b/quickstart/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="quickstart/">
<chapter>
-<title>Quickstart Ebuild Guide</title>
+<title>Quickstart ebuild guide</title>
<body>
<p>
@@ -25,7 +25,7 @@ have had several parts chopped out, changed and simplified.
</body>
<section>
-<title>First Ebuild</title>
+<title>First ebuild</title>
<body>
<p>
@@ -61,7 +61,7 @@ src_install() {
</body>
<subsection>
-<title>Basic Format</title>
+<title>Basic format</title>
<body>
<p>
@@ -81,7 +81,7 @@ See <uri link="::ebuild-writing/file-format/"/>.
</subsection>
<subsection>
-<title>Information Variables</title>
+<title>Information variables</title>
<body>
<p>
@@ -132,7 +132,7 @@ See <uri link="::keywording/"/> for details.
</subsection>
<subsection>
-<title>Build Functions</title>
+<title>Build functions</title>
<body>
<p>
@@ -189,7 +189,7 @@ failed.
</section>
<section>
-<title>Ebuild with Dependencies</title>
+<title>Ebuild with dependencies</title>
<body>
<p>
@@ -255,7 +255,7 @@ for some more complex examples.
</section>
<section>
-<title>Ebuild with Patches</title>
+<title>Ebuild with patches</title>
<body>
<p>
@@ -313,7 +313,7 @@ that <c>eapply_user</c> is called.
</section>
<section>
-<title>Ebuild with USE Flags</title>
+<title>Ebuild with USE flags</title>
<body>
<p>
diff --git a/tasks-reference/completion/text.xml
b/tasks-reference/completion/text.xml
index ded0ff9..d4e6daf 100644
--- a/tasks-reference/completion/text.xml
+++ b/tasks-reference/completion/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tasks-reference/completion/">
<chapter>
-<title>Completion Files</title>
+<title>Completion files</title>
<body>
<p>
@@ -14,7 +14,7 @@ for how to install completion files.
</body>
<section>
-<title>Completion-Related Internal Bash Variables</title>
+<title>Completion-related internal Bash variables</title>
<body>
<p>
@@ -92,7 +92,7 @@ are subsequently reset.
</section>
<section>
-<title>Completion-Related Bash Builtins</title>
+<title>Completion-related Bash builtins</title>
<body>
<p>
@@ -154,7 +154,7 @@ complete -o nospace -d cd
</section>
<section>
-<title>Anatomy of a Completion Function</title>
+<title>Anatomy of a completion function</title>
<body>
<p>
@@ -296,7 +296,7 @@ esac
</section>
<section>
-<title>Real-World Example</title>
+<title>Real-world example</title>
<body>
<p>
diff --git a/tasks-reference/environment/text.xml
b/tasks-reference/environment/text.xml
index dca5565..b37b991 100644
--- a/tasks-reference/environment/text.xml
+++ b/tasks-reference/environment/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tasks-reference/environment/">
<chapter>
-<title>Environment Files</title>
+<title>Environment files</title>
<body>
diff --git a/tasks-reference/init-scripts/text.xml
b/tasks-reference/init-scripts/text.xml
index 883c3f8..a46758e 100644
--- a/tasks-reference/init-scripts/text.xml
+++ b/tasks-reference/init-scripts/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tasks-reference/init-scripts/">
<chapter>
-<title>Init Scripts</title>
+<title>Init scripts</title>
<body>
diff --git a/tasks-reference/pam/text.xml b/tasks-reference/pam/text.xml
index 9a5bf5c..3094b20 100644
--- a/tasks-reference/pam/text.xml
+++ b/tasks-reference/pam/text.xml
@@ -19,7 +19,7 @@ modules which will provide authentication.
</body>
<section>
-<title>Structure of a <c>pamd</c> File</title>
+<title>Structure of a <c>pamd</c> file</title>
<body>
<p>
@@ -160,7 +160,7 @@ and takes care of executing it.
</section>
<section>
-<title>Installing <c>pamd</c> Files</title>
+<title>Installing <c>pamd</c> files</title>
<body>
<p>
@@ -215,7 +215,7 @@ which just uses <c>system-auth</c> login class.
</section>
<section>
-<title>Installing PAM Modules</title>
+<title>Installing PAM modules</title>
<body>
<p>
diff --git a/tasks-reference/text.xml b/tasks-reference/text.xml
index 30e6017..47ffb76 100644
--- a/tasks-reference/text.xml
+++ b/tasks-reference/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tasks-reference/">
<chapter>
-<title>Tasks Reference</title>
+<title>Tasks reference</title>
<body>
<p>
diff --git a/text.xml b/text.xml
index 12e4614..aa7dcae 100644
--- a/text.xml
+++ b/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide root="true">
<chapter>
-<title>Master Index</title>
+<title>Master index</title>
<body>
<p>
@@ -30,7 +30,7 @@ section lists specific contributions to this manual.
</section>
<section>
-<title>Full Contents</title>
+<title>Full contents</title>
<body>
<contentsTree/>
</body>
diff --git a/tools-reference/bash/text.xml b/tools-reference/bash/text.xml
index 76a7da0..1c2148e 100644
--- a/tools-reference/bash/text.xml
+++ b/tools-reference/bash/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/bash/">
<chapter>
-<title><c>bash</c> — Standard Shell</title>
+<title><c>bash</c> — standard shell</title>
<body>
<p>
@@ -11,10 +11,10 @@ ebuilds.
</body>
<section>
-<title>Bash Conditionals</title>
+<title>Bash conditionals</title>
<subsection>
-<title>Basic Selection</title>
+<title>Basic selection</title>
<body>
<p>
@@ -31,7 +31,7 @@ fi
</subsection>
<subsection>
-<title>Multiple Selection</title>
+<title>Multiple selection</title>
<body>
<p>
@@ -82,7 +82,7 @@ fi
</subsection>
<subsection>
-<title>Selection Tests</title>
+<title>Selection tests</title>
<body>
<p>
@@ -111,7 +111,7 @@ fi
</subsection>
<subsection>
-<title>Single versus Double Brackets in <c>bash</c></title>
+<title>Single versus double brackets in <c>bash</c></title>
<body>
<important>
@@ -144,7 +144,7 @@ bash$
</subsection>
<subsection>
-<title>String Comparison in <c>bash</c></title>
+<title>String comparison in <c>bash</c></title>
<body>
<p>
@@ -183,7 +183,7 @@ following are available:
</subsection>
<subsection>
-<title>String Tests in <c>bash</c></title>
+<title>String tests in <c>bash</c></title>
<body>
<p>
@@ -210,7 +210,7 @@ available:
</subsection>
<subsection>
-<title>Integer Comparison in <c>bash</c></title>
+<title>Integer comparison in <c>bash</c></title>
<body>
<p>
@@ -253,7 +253,7 @@ following are available:
</subsection>
<subsection>
-<title>File Tests in <c>bash</c></title>
+<title>File tests in <c>bash</c></title>
<body>
<p>
@@ -356,7 +356,7 @@ available (lifted from <c>man bash</c>):
</subsection>
<subsection>
-<title>File Comparison in <c>bash</c></title>
+<title>File comparison in <c>bash</c></title>
<body>
<p>
@@ -390,7 +390,7 @@ The following are available:
</subsection>
<subsection>
-<title>Boolean Algebra in <c>bash</c></title>
+<title>Boolean algebra in <c>bash</c></title>
<body>
<p>
@@ -438,7 +438,7 @@ These should be avoided in favour of <c>[[ ]]</c> and the
above operators.
</section>
<section>
-<title>Bash Iterative Structures</title>
+<title>Bash iterative structures</title>
<body>
<p>
@@ -495,7 +495,7 @@ be used over <c>cat file | while read</c>.
</section>
<section>
-<title>Bash Variable Manipulation</title>
+<title>Bash variable manipulation</title>
<body>
<p>
@@ -507,7 +507,7 @@ and friends.
</body>
<subsection>
-<title><c>bash</c> String Length</title>
+<title><c>bash</c> string length</title>
<body>
<p>
@@ -524,7 +524,7 @@ echo "${somevar} is ${#somevar} characters long"
</subsection>
<subsection>
-<title><c>bash</c> Variable Default Values</title>
+<title><c>bash</c> variable default values</title>
<body>
<p>
@@ -554,7 +554,7 @@ or a blank string otherwise. There is a <c>${var+value}</c>
form.
</subsection>
<subsection>
-<title><c>bash</c> Substring Extraction</title>
+<title><c>bash</c> substring extraction</title>
<body>
<p>
@@ -587,7 +587,7 @@ than zero. Again, negative <c>offset</c> values must be
given as an expression.
</subsection>
<subsection>
-<title><c>bash</c> Command Substitution</title>
+<title><c>bash</c> command substitution</title>
<body>
<p>
@@ -608,7 +608,7 @@ myconf="$(use_enable acl) $(use_enable nls)
--with-tlib=ncurses"
</subsection>
<subsection>
-<title><c>bash</c> String Replacements</title>
+<title><c>bash</c> string replacements</title>
<body>
<p>
@@ -731,7 +731,7 @@ table, a <c>pattern-list</c> is a list of one or more
patterns separated by
</subsection>
<subsection>
-<title><c>bash</c> Arithmetic Expansion</title>
+<title><c>bash</c> arithmetic expansion</title>
<body>
<p>
diff --git a/tools-reference/cat/text.xml b/tools-reference/cat/text.xml
index c265fcc..630a995 100644
--- a/tools-reference/cat/text.xml
+++ b/tools-reference/cat/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/cat/">
<chapter>
-<title><c>cat</c> — File Concatenation</title>
+<title><c>cat</c> — file concatenation</title>
<body>
<p>
@@ -41,7 +41,7 @@ be replaced by <c>cp -f foo bar</c>.
</section>
<section>
-<title>Here Documents</title>
+<title>Here documents</title>
<body>
<p>
On the other hand, <c>cat</c> is exceptionally useful for so-called
diff --git a/tools-reference/cut/text.xml b/tools-reference/cut/text.xml
index 749f6fe..ce6130b 100644
--- a/tools-reference/cut/text.xml
+++ b/tools-reference/cut/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/cut/">
<chapter>
-<title><c>cut</c> — Column Concatenation</title>
+<title><c>cut</c> — column concatenation</title>
<body>
<p>
diff --git a/tools-reference/diff-and-patch/text.xml
b/tools-reference/diff-and-patch/text.xml
index d271445..7a5e932 100644
--- a/tools-reference/diff-and-patch/text.xml
+++ b/tools-reference/diff-and-patch/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/diff-and-patch/">
<chapter>
-<title><c>diff</c> and <c>patch</c> — File Differences</title>
+<title><c>diff</c> and <c>patch</c> — file differences</title>
<body>
<p>
diff --git a/tools-reference/echo/text.xml b/tools-reference/echo/text.xml
index fb36543..9a84ab9 100644
--- a/tools-reference/echo/text.xml
+++ b/tools-reference/echo/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/echo/">
<chapter>
-<title><c>echo</c> — Print Strings</title>
+<title><c>echo</c> — print strings</title>
<body>
<p>
@@ -40,7 +40,7 @@ describes the preferred way of dealing with such cases.
</section>
<section>
-<title>Here Strings</title>
+<title>Here strings</title>
<body>
<p>
As of >=bash-2.05b, the so-called "here strings" have been
diff --git a/tools-reference/ekeyword/text.xml
b/tools-reference/ekeyword/text.xml
index eeb2d7b..3a294d2 100644
--- a/tools-reference/ekeyword/text.xml
+++ b/tools-reference/ekeyword/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/ekeyword/">
<chapter>
-<title><c>ekeyword</c> — Keywording</title>
+<title><c>ekeyword</c> — keywording</title>
<body>
<p>
diff --git a/tools-reference/false-and-true/text.xml
b/tools-reference/false-and-true/text.xml
index e06aefa..9a28640 100644
--- a/tools-reference/false-and-true/text.xml
+++ b/tools-reference/false-and-true/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/false-and-true/">
<chapter>
-<title><c>false</c> and <c>true</c> — Generating Return Codes</title>
+<title><c>false</c> and <c>true</c> — generating return codes</title>
<body>
<p>
diff --git a/tools-reference/find/text.xml b/tools-reference/find/text.xml
index 22fe6a2..5825a39 100644
--- a/tools-reference/find/text.xml
+++ b/tools-reference/find/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/find/">
<chapter>
-<title><c>find</c> — Finding Files</title>
+<title><c>find</c> — finding files</title>
<body>
<p>
diff --git a/tools-reference/grep/text.xml b/tools-reference/grep/text.xml
index 2bf0075..b0651bd 100644
--- a/tools-reference/grep/text.xml
+++ b/tools-reference/grep/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/grep/">
<chapter>
-<title><c>grep</c> — Text Filtering</title>
+<title><c>grep</c> — text filtering</title>
<body>
<p>
diff --git a/tools-reference/head-and-tail/text.xml
b/tools-reference/head-and-tail/text.xml
index bed5dc3..436fdc1 100644
--- a/tools-reference/head-and-tail/text.xml
+++ b/tools-reference/head-and-tail/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/head-and-tail/">
<chapter>
-<title><c>head</c> and <c>tail</c> — Line Extraction</title>
+<title><c>head</c> and <c>tail</c> — line extraction</title>
<body>
<p>
diff --git a/tools-reference/sed/text.xml b/tools-reference/sed/text.xml
index 918a30e..da43c8f 100644
--- a/tools-reference/sed/text.xml
+++ b/tools-reference/sed/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/sed/">
<chapter>
-<title>sed — Stream Editor</title>
+<title>sed — stream editor</title>
<body>
<p>
@@ -70,7 +70,7 @@ a <c>DEPEND</c> upon <c>>=sys-apps/sed-4</c>.
</body>
<section>
-<title>Basic <c>sed</c> Invocation</title>
+<title>Basic <c>sed</c> invocation</title>
<body>
<p>
@@ -104,7 +104,7 @@ The term <e>pattern</e> refers to the description of text
being matched.
</section>
<section>
-<title>Simple Text Substitution using <c>sed</c></title>
+<title>Simple text substitution using <c>sed</c></title>
<body>
<p>
@@ -191,7 +191,7 @@ are used.
</section>
<section>
-<title>Regular Expression Substitution using <c>sed</c></title>
+<title>Regular expression substitution using <c>sed</c></title>
<body>
<p>
@@ -349,7 +349,7 @@ not discussed in this document.
</section>
<section>
-<title>Content Deletion using <c>sed</c></title>
+<title>Content deletion using <c>sed</c></title>
<body>
<p>
@@ -368,7 +368,7 @@ lines' contents but not the newline.
</section>
<section>
-<title>Content Extraction using <c>sed</c></title>
+<title>Content extraction using <c>sed</c></title>
<body>
<p>
@@ -383,7 +383,7 @@ sometimes useful.
</section>
<section>
-<title>Inserting Content using <c>sed</c></title>
+<title>Inserting content using <c>sed</c></title>
<body>
<p>
@@ -421,10 +421,10 @@ the file, for example, causing your sed script to break.
</section>
<section>
-<title>Regular Expression Atoms in <c>sed</c></title>
+<title>Regular expression atoms in <c>sed</c></title>
<subsection>
-<title>Basic Atoms</title>
+<title>Basic atoms</title>
<body>
<table>
@@ -546,7 +546,7 @@ the file, for example, causing your sed script to break.
</subsection>
<subsection>
-<title>Character Class Shortcuts</title>
+<title>Character class shortcuts</title>
<body>
<table>
@@ -604,7 +604,7 @@ the file, for example, causing your sed script to break.
</subsection>
<subsection>
-<title>POSIX Character Classes</title>
+<title>POSIX character classes</title>
<body>
<p>
@@ -714,7 +714,7 @@ Read the source, it's the only place these're documented
properly...
</subsection>
<subsection>
-<title>Count Specifiers</title>
+<title>Count specifiers</title>
<body>
<table>
@@ -781,7 +781,7 @@ Read the source, it's the only place these're documented
properly...
</section>
<section>
-<title>Replacement Atoms in <c>sed</c></title>
+<title>Replacement atoms in <c>sed</c></title>
<body>
<table>
@@ -855,7 +855,7 @@ Read the source, it's the only place these're documented
properly...
</section>
<section>
-<title>Details of <c>sed</c> Match Mechanics</title>
+<title>Details of <c>sed</c> match mechanics</title>
<body>
<p>
@@ -878,7 +878,7 @@ the pattern.
</section>
<section>
-<title>Notes on Performance with <c>sed</c></title>
+<title>Notes on performance with <c>sed</c></title>
<body>
<todo>
@@ -889,7 +889,7 @@ write this
</section>
<section>
-<title>Recommended Further Reading for Regular Expressions</title>
+<title>Recommended further reading for regular expressions</title>
<body>
<p>
diff --git a/tools-reference/sort/text.xml b/tools-reference/sort/text.xml
index 9f27c5b..6f140d6 100644
--- a/tools-reference/sort/text.xml
+++ b/tools-reference/sort/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/sort/">
<chapter>
-<title>sort — Sorting Text</title>
+<title>sort — sorting text</title>
<body>
<p>
diff --git a/tools-reference/text.xml b/tools-reference/text.xml
index b47e097..781d4af 100644
--- a/tools-reference/text.xml
+++ b/tools-reference/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/">
<chapter>
-<title>Tools Reference</title>
+<title>Tools reference</title>
<body>
<p>
diff --git a/tools-reference/tr/text.xml b/tools-reference/tr/text.xml
index ca5001f..e688d89 100644
--- a/tools-reference/tr/text.xml
+++ b/tools-reference/tr/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/tr/">
<chapter>
-<title>tr — Character Translation</title>
+<title>tr — character translation</title>
<body>
<p>
diff --git a/tools-reference/uniq/text.xml b/tools-reference/uniq/text.xml
index 39ecdfe..2114703 100644
--- a/tools-reference/uniq/text.xml
+++ b/tools-reference/uniq/text.xml
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<guide self="tools-reference/uniq/">
<chapter>
-<title>uniq — Filtering Duplicates</title>
+<title>uniq — filtering duplicates</title>
<body>
<p>
