[release-notes] Rearrange top level
John J. McDonough
jjmcd at fedoraproject.org
Sun Oct 20 17:53:05 UTC 2013
commit d139dc60751446538899d140f4183d4b433df241
Author: John J. McDonough <jjmcd at fedoraproject.org>
Date: Sun Oct 20 13:48:50 2013 -0400
Rearrange top level
As some beats are empty, and later get filled out, individual includes
in the top level xml must be commented and uncommented. Since the
previous Release_Notes.xml had multiple sections at various levels it
got to be confusing to keep track of which section tags needed to be
commented and uncommented.
This change breaks out each major section into it's own XML. The top
level has no section tags, and each of the major section files has
only a single section. Lower level files may or may not have
additional section tags, but these will not normally be commented and
uncommented.
There should be no need to comment includes in Release_Note.xml, only
in the individual major section files:
Section-Desktop.xml
Section-Developers.xml
Section-Specific.xml
Section-Sysadmin.xml
Section-Welcome.xml
en-US/Development_GCC_Tools.xml | 9 ++
en-US/Release_Notes.xml | 178 ++++-----------------------------------
en-US/Section-Desktop.xml | 35 ++++++++
en-US/Section-Developers.xml | 37 ++++++++
en-US/Section-Specific.xml | 25 ++++++
en-US/Section-Sysadmin.xml | 71 ++++++++++++++++
en-US/Section-Welcome.xml | 27 ++++++
7 files changed, 219 insertions(+), 163 deletions(-)
---
diff --git a/en-US/Development_GCC_Tools.xml b/en-US/Development_GCC_Tools.xml
index 7e74526..53fa2b4 100644
--- a/en-US/Development_GCC_Tools.xml
+++ b/en-US/Development_GCC_Tools.xml
@@ -7,6 +7,12 @@
<title>GCC Tools</title>
<section>
<title>Boost 1.54.0 Uplift</title>
+ <indexterm>
+ <primary>gcc</primary>
+ </indexterm>
+ <indexterm>
+ <primary>boost</primary>
+ </indexterm>
<para>
<package>boost</package> has been upgraded to version
1.54.0. Apart from a number of bugfixes, this brings in three
@@ -23,6 +29,9 @@
</section>
<section id="development-gcc-glibc">
<title>GLIBC 2.18</title>
+ <indexterm>
+ <primary>glibc</primary>
+ </indexterm>
<para>
Fedora 20 ships version 2.18 of the GNU C Library. For information on this release, see the upstream release anouncement at <ulink url="https://sourceware.org/ml/libc-alpha/2013-08/msg00160.html" /> </para>
</section>
diff --git a/en-US/Release_Notes.xml b/en-US/Release_Notes.xml
index 6486f9b..8fcce84 100644
--- a/en-US/Release_Notes.xml
+++ b/en-US/Release_Notes.xml
@@ -8,181 +8,33 @@
<xi:include href="Article_Info.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
- <section id="sect-Release_Notes-Welcome_to_Fedora_&PRODVER;">
- <title>Welcome to Fedora &PRODVER;</title>
-
- <xi:include href="Welcome.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-
- <xi:include href="Overview.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Hardware_Overview.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
+<!-- Individual sections -->
- <xi:include href="Architecture_Specific_Content.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-
- <xi:include href="Feedback.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-
- </section>
-
-
- <section id="sect-Release_Notes-Changes_for_Sysadmin">
- <title>Changes in Fedora for System Administrators</title>
-
-<!--
- <xi:include href="Kernel.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Installation.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Boot.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>\
--->
- <xi:include href="Security.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-<!--
- <xi:include href="Accounts.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
--->
- <xi:include href="File_Systems.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-
- <xi:include href="Virtualization.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-<!--
- <xi:include href="Web_Servers.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Cloud.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
--->
- <xi:include href="Database_Servers.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-<!--
- <xi:include href="File_Servers.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
--->
- <xi:include href="Mail_Servers.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-
- <xi:include href="Samba.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-<!--
- <xi:include href="System_Daemons.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Server_Configuration_Tools.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Xorg.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-
- <xi:include href="Monitoring.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
--->
- </section>
-
- <section id="sect-Release_Notes-Changes_for_Desktop">
- <title>Changes in Fedora for Desktop Users</title>
-
- <xi:include href="Desktop.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-
- <xi:include href="Productivity.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Networking.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-<!--
- <xi:include href="I18n.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Multimedia.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Entertainment.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
--->
- <xi:include href="Printing.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- </section>
-
- <section id="sect-Release_Notes-Changes_for_Developers">
- <title>Changes in Fedora for Developers</title>
+ <xi:include href="Section-Welcome.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Development.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-<!--
- <xi:include href="Development_Tools.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
--->
- <xi:include href="Development_GCC_Tools.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-<!--
- <xi:include href="Development_D.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
--->
- <xi:include href="Development_Haskell.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
-<!--
- <xi:include href="Development_Java.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
--->
- <xi:include href="Development_Web.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- </section>
+ <xi:include href="Section-Sysadmin.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
-<!--
- <section id="sect-Release_Notes-Changes_for_Specific_Audiences">
- <title>Changes in Fedora for Specific Audiences</title>
+ <xi:include href="Section-Desktop.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Scientific_and_Technical.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Circuit_Design.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
- <xi:include href="Embedded_Development.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
+ <xi:include href="Section-Developers.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
- </xi:include>
+ <xi:include href="Section-Specific.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
- <xi:include href="Amateur_Radio.xml"
- xmlns:xi="http://www.w3.org/2001/XInclude">
- </xi:include>
+<!-- Standard closing -->
- </section>
--->
<xi:include href="Contributors.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+
<xi:include href="Revision_History.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
+
<index id="appe-Release_Notes-index" />
+
</article>
diff --git a/en-US/Section-Desktop.xml b/en-US/Section-Desktop.xml
new file mode 100644
index 0000000..1a2e7a3
--- /dev/null
+++ b/en-US/Section-Desktop.xml
@@ -0,0 +1,35 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+
+
+
+<section id="sect-Release_Notes-Changes_for_Desktop">
+ <title>Changes in Fedora for Desktop Users</title>
+
+ <xi:include href="Desktop.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Productivity.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Networking.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <!--
+ <xi:include href="I18n.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Multimedia.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Entertainment.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ -->
+ <xi:include href="Printing.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+</section>
diff --git a/en-US/Section-Developers.xml b/en-US/Section-Developers.xml
new file mode 100644
index 0000000..257bd43
--- /dev/null
+++ b/en-US/Section-Developers.xml
@@ -0,0 +1,37 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+
+
+<section id="sect-Release_Notes-Changes_for_Developers">
+ <title>Changes in Fedora for Developers</title>
+
+ <xi:include href="Development.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+<!--
+ <xi:include href="Development_Tools.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude"/>
+
+-->
+ <xi:include href="Development_GCC_Tools.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+<!--
+ <xi:include href="Development_D.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+-->
+ <xi:include href="Development_Haskell.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+<!--
+ <xi:include href="Development_Java.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+-->
+ <xi:include href="Development_Web.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+</section>
diff --git a/en-US/Section-Specific.xml b/en-US/Section-Specific.xml
new file mode 100644
index 0000000..cf7157f
--- /dev/null
+++ b/en-US/Section-Specific.xml
@@ -0,0 +1,25 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+
+
+
+<section id="sect-Release_Notes-Changes_for_Specific_Audiences">
+ <title>Changes in Fedora for Specific Audiences</title>
+<!--
+ <xi:include href="Scientific_and_Technical.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+-->
+ <xi:include href="Circuit_Design.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+<!--
+ <xi:include href="Embedded_Development.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Amateur_Radio.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+-->
+</section>
+
diff --git a/en-US/Section-Sysadmin.xml b/en-US/Section-Sysadmin.xml
new file mode 100644
index 0000000..1f83940
--- /dev/null
+++ b/en-US/Section-Sysadmin.xml
@@ -0,0 +1,71 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+
+ <section id="sect-Release_Notes-Changes_for_Sysadmin">
+ <title>Changes in Fedora for System Administrators</title>
+
+<!--
+ <xi:include href="Kernel.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Installation.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Boot.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+-->
+ <xi:include href="Security.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+<!--
+ <xi:include href="Accounts.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+-->
+ <xi:include href="File_Systems.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Virtualization.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+<!--
+ <xi:include href="Web_Servers.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Cloud.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+-->
+ <xi:include href="Database_Servers.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+<!--
+ <xi:include href="File_Servers.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+-->
+ <xi:include href="Mail_Servers.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Samba.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+<!--
+ <xi:include href="System_Daemons.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Server_Configuration_Tools.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Xorg.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+
+ <xi:include href="Monitoring.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+-->
+ </section>
+
diff --git a/en-US/Section-Welcome.xml b/en-US/Section-Welcome.xml
new file mode 100644
index 0000000..dc63fd5
--- /dev/null
+++ b/en-US/Section-Welcome.xml
@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Release_Notes.ent">
+%BOOK_ENTITIES;
+]>
+
+<section id="sect-Release_Notes-Welcome_to_Fedora_&PRODVER;">
+ <title>Welcome to Fedora &PRODVER;</title>
+
+ <xi:include href="Welcome.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+
+ <xi:include href="Overview.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Hardware_Overview.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+
+ <xi:include href="Architecture_Specific_Content.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+ <xi:include href="Feedback.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+
+</section>
More information about the docs-commits
mailing list