[gentoo-pms] [PATCH] Rearrange front matter.

[gentoo-pms] [PATCH] Rearrange front matter.

[Ulrich Müller]

[-- Attachment #1: Type: text/plain, Size: 3795 bytes --]

---
 credits.tex      | 26 +++-----------------------
 introduction.tex | 23 +++++++++++++++++++++++
 pms.tex          |  4 ++--
 3 files changed, 28 insertions(+), 25 deletions(-)

diff --git a/credits.tex b/credits.tex
index 336ec51..3c98e91 100644
--- a/credits.tex
+++ b/credits.tex
@@ -1,3 +1,6 @@
+\thispagestyle{empty}
+\vspace*{\fill}
+
 \section*{Acknowledgements}
 
 Thanks to Mike Kelly (package manager provided utilities, section~\ref{sec:pkg-mgr-commands}),
@@ -15,29 +18,6 @@ inclusion.
 This document is released under the Creative Commons Attribution-Share Alike 3.0 Licence. The full
 text of this licence can be found at \url{http://creativecommons.org/licenses/by-sa/3.0/}.
 
-\section*{Reporting Issues}
-
-Issues (inaccuracies, wording problems, omissions etc.)\ in this document should be reported via
-Gentoo Bugzilla using product \e{Gentoo Hosted Projects}, component \e{PMS/EAPI} and the default
-assignee. There should be one bug per issue, and one issue per bug.
-
-Patches (in \t{git format-patch} form if possible) may be submitted either via Bugzilla or to the
-\t{gentoo-pms@lists.gentoo.org} mailing list. Patches will be reviewed by the PMS team, who will do
-one of the following:
-
-\begin{compactitem}
-\item Accept and apply the patch.
-\item Explain why the patch cannot be applied as-is. The patch may then be updated and resubmitted
-if \mbox{appropriate}.
-\item Reject the patch outright.
-\item Take special action merited by the individual circumstances.
-\end{compactitem}
-
-When reporting issues, remember that this document is not the appropriate place for pushing
-through changes to the tree or the package manager, except where those changes are bugs.
-
-If any issue cannot be resolved by the PMS team, it may be escalated to the Gentoo Council.
-
 % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
 
 %%% Local Variables:
diff --git a/introduction.tex b/introduction.tex
index 7c22fd4..282fd18 100644
--- a/introduction.tex
+++ b/introduction.tex
@@ -25,6 +25,29 @@ ebuild repository looks like, and how an ebuild is allowed to behave. Thus, both
 package managers can change aspects of their behaviour not defined here without worry of
 incompatibilities with any particular repository.
 
+\section{Reporting Issues}
+
+Issues (inaccuracies, wording problems, omissions etc.)\ in this document should be reported via
+Gentoo Bugzilla using product \e{Gentoo Hosted Projects}, component \e{PMS/EAPI} and the default
+assignee. There should be one bug per issue, and one issue per bug.
+
+Patches (in \t{git format-patch} form if possible) may be submitted either via Bugzilla or to the
+\t{gentoo-pms@lists.gentoo.org} mailing list. Patches will be reviewed by the PMS team, who will do
+one of the following:
+
+\begin{compactitem}
+\item Accept and apply the patch.
+\item Explain why the patch cannot be applied as-is. The patch may then be updated and resubmitted
+if appropriate.
+\item Reject the patch outright.
+\item Take special action merited by the individual circumstances.
+\end{compactitem}
+
+When reporting issues, remember that this document is not the appropriate place for pushing
+through changes to the tree or the package manager, except where those changes are bugs.
+
+If any issue cannot be resolved by the PMS team, it may be escalated to the Gentoo Council.
+
 \section{Conventions}
 
 Text in \t{teletype} is used for filenames or variable names. \i{Italic} text is used for terms
diff --git a/pms.tex b/pms.tex
index c96fc05..9ca363c 100644
--- a/pms.tex
+++ b/pms.tex
@@ -27,13 +27,13 @@
 \begin{document}
 \maketitle
 
+\include{credits}
+
 \tableofcontents
 \listofalgorithms
 \listoflistings
 \listoftables
 
-\include{credits}
-
 \include{introduction}
 
 \include{eapis}
-- 
2.6.3

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]

[gentoo-pms] Re: [PATCH] Rearrange front matter.

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 1013 bytes --]

>>>>> On Thu, 26 Nov 2015, Ulrich Müller wrote:

> ---
>  credits.tex      | 26 +++-----------------------
>  introduction.tex | 23 +++++++++++++++++++++++
>  pms.tex          |  4 ++--
>  3 files changed, 28 insertions(+), 25 deletions(-)

I have dropped this, because in the HTML version it may be preferable
to start with the table of contents.

Instead, only suppress the wrong ("list of tables") header line.

Ulrich


From 14d9ddf1268896b94780a82eb9179267e0c3f313 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ulrich=20M=C3=BCller?= <ulm@gentoo.org>
Date: Fri, 27 Nov 2015 22:15:09 +0100
Subject: [PATCH] Suppress header line on credits page.

---
 credits.tex | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/credits.tex b/credits.tex
index 336ec51..8e2a0ad 100644
--- a/credits.tex
+++ b/credits.tex
@@ -1,3 +1,5 @@
+\chapter*{}
+
 \section*{Acknowledgements}
 
 Thanks to Mike Kelly (package manager provided utilities, section~\ref{sec:pkg-mgr-commands}),
-- 
2.6.3

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]

[gentoo-pms] [PATCH v2] Rearrange front matter.

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 6920 bytes --]

>>>>> On Fri, 27 Nov 2015, Ulrich Mueller wrote:

> I have dropped this, because in the HTML version it may be
> preferable to start with the table of contents.

Coming back to this. Sections "Reporting Issues" and "Acknowledgments"
are moved to the Introduction now (and are properly referenced in the
table of contents), so the verso of the title page contains only the
copyright and licence information.

This follows the conventions used for books. IMHO the additional text
before the table of contents is now short enough to be acceptable for
the HTML version.

Ulrich

---- 8< ---- 8< ---- 8< ---- 8< ---- 8< ---- 8< ---- 8< ---- 8< ----
From: =?UTF-8?q?Ulrich=20M=C3=BCller?= <ulm@gentoo.org>
Date: Thu, 26 Nov 2015 07:54:44 +0100
Subject: [PATCH] Rearrange front matter.

---
 credits.tex      | 52 ----------------------------------------------------
 introduction.tex | 31 +++++++++++++++++++++++++++++++
 pms.tex          | 14 ++++++++++++--
 3 files changed, 43 insertions(+), 54 deletions(-)
 delete mode 100644 credits.tex

diff --git a/credits.tex b/credits.tex
deleted file mode 100644
index 6c54e60..0000000
--- a/credits.tex
+++ /dev/null
@@ -1,52 +0,0 @@
-\chapter*{}
-
-\section*{Acknowledgements}
-
-Thanks to Mike Kelly (package manager provided utilities, section~\ref{sec:pkg-mgr-commands}),
-Danny van Dyk (ebuild functions, section~\ref{sec:ebuild-functions}), David Leverton (various
-sections), Petteri Räty (environment state, section~\ref{sec:ebuild-env-state}) and Michał Górny
-(various sections) for contributions. Thanks also to Mike Frysinger and Brian Harring for
-proof-reading and suggestions for fixes and/or clarification.
-
-\section*{Copyright and Licence}
-
-The bulk of this document is \textcopyright{} 2007--2017 Stephen Bennett, Christian Faulhammer,
-Ciaran McCreesh and Ulrich Müller. Contributions are owned by their respective authors, and may
-have been changed substantially before inclusion.
-
-This document is released under the Creative Commons Attribution-Share Alike 3.0 Licence. The full
-text of this licence can be found at \url{http://creativecommons.org/licenses/by-sa/3.0/}.
-
-\section*{Reporting Issues}
-
-Issues (inaccuracies, wording problems, omissions etc.)\ in this document should be reported via
-Gentoo Bugzilla using product \e{Gentoo Hosted Projects}, component \e{PMS/EAPI} and the default
-assignee. There should be one bug per issue, and one issue per bug.
-
-Patches (in \t{git format-patch} form if possible) may be submitted either via Bugzilla or to the
-\t{gentoo-pms@lists.gentoo.org} mailing list. Patches will be reviewed by the PMS team, who will do
-one of the following:
-
-\begin{compactitem}
-\item Accept and apply the patch.
-\item Explain why the patch cannot be applied as-is. The patch may then be updated and resubmitted
-if appropriate.
-\item Reject the patch outright.
-\item Take special action merited by the individual circumstances.
-\end{compactitem}
-
-When reporting issues, remember that this document is not the appropriate place for pushing
-through changes to the tree or the package manager, except where those changes are bugs.
-
-If any issue cannot be resolved by the PMS team, it may be escalated to the Gentoo Council.
-
-% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
-
-%%% Local Variables:
-%%% mode: latex
-%%% TeX-master: "pms"
-%%% LaTeX-indent-level: 4
-%%% LaTeX-item-indent: 0
-%%% TeX-brace-indent-level: 4
-%%% fill-column: 100
-%%% End:
diff --git a/introduction.tex b/introduction.tex
index 7c22fd4..36e8b14 100644
--- a/introduction.tex
+++ b/introduction.tex
@@ -25,6 +25,29 @@ ebuild repository looks like, and how an ebuild is allowed to behave. Thus, both
 package managers can change aspects of their behaviour not defined here without worry of
 incompatibilities with any particular repository.
 
+\section{Reporting Issues}
+
+Issues (inaccuracies, wording problems, omissions etc.)\ in this document should be reported via
+Gentoo Bugzilla using product \e{Gentoo Hosted Projects}, component \e{PMS/EAPI} and the default
+assignee. There should be one bug per issue, and one issue per bug.
+
+Patches (in \t{git format-patch} form if possible) may be submitted either via Bugzilla or to the
+\t{gentoo-pms@lists.gentoo.org} mailing list. Patches will be reviewed by the PMS team, who will do
+one of the following:
+
+\begin{compactitem}
+\item Accept and apply the patch.
+\item Explain why the patch cannot be applied as-is. The patch may then be updated and resubmitted
+if appropriate.
+\item Reject the patch outright.
+\item Take special action merited by the individual circumstances.
+\end{compactitem}
+
+When reporting issues, remember that this document is not the appropriate place for pushing through
+changes to the tree or the package manager, except where those changes are bugs.
+
+If any issue cannot be resolved by the PMS team, it may be escalated to the Gentoo Council.
+
 \section{Conventions}
 
 Text in \t{teletype} is used for filenames or variable names. \i{Italic} text is used for terms
@@ -34,6 +57,14 @@ The term \i{package manager} is used throughout this document in a broad sense.
 of this document are only relevant to fully featured package managers, many items are equally
 applicable to tools or other applications that interact with ebuilds or ebuild repositories.
 
+\section{Acknowledgements}
+
+Thanks to Mike Kelly (package manager provided utilities, section~\ref{sec:pkg-mgr-commands}),
+Danny van Dyk (ebuild functions, section~\ref{sec:ebuild-functions}), David Leverton (various
+sections), Petteri Räty (environment state, section~\ref{sec:ebuild-env-state}) and Michał Górny
+(various sections) for contributions. Thanks also to Mike Frysinger and Brian Harring for
+proof-reading and suggestions for fixes and/or clarification.
+
 % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
 
 %%% Local Variables:
diff --git a/pms.tex b/pms.tex
index 01dee98..3b3edb5 100644
--- a/pms.tex
+++ b/pms.tex
@@ -27,13 +27,23 @@
 \begin{document}
 \maketitle
 
+\thispagestyle{empty}
+\vspace*{\fill}
+{%
+    \small
+    The bulk of this document is \textcopyright{} 2007--2017 Stephen Bennett, Christian Faulhammer,
+    Ciaran McCreesh and Ulrich Müller. Contributions are owned by their respective authors, and may
+    have been changed substantially before inclusion.
+
+    This document is released under the Creative Commons Attribution-Share Alike 3.0 Licence. The
+    full text of this licence can be found at \url{http://creativecommons.org/licenses/by-sa/3.0/}.
+}
+
 \tableofcontents
 \listofalgorithms
 \listoflistings
 \listoftables
 
-\include{credits}
-
 \include{introduction}
 
 \include{eapis}
-- 
2.13.0

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]

[gentoo-pms] Re: [PATCH v2] Rearrange front matter.

[Ulrich Mueller]

[-- Attachment #1: Type: text/plain, Size: 8 bytes --]

Pushed.

[-- Attachment #2: Type: application/pgp-signature, Size: 490 bytes --]