commit: ac633821166d2a8dc4a205b474e581e0943a5149
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Thu Nov 26 06:54:44 2015 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Thu May 25 18:43:41 2017 +0000
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=ac633821
Rearrange front matter.
Move sections Reporting Issues and Acknowledgments to the Introduction
chapter (and number them). Copyright and licence information goes to
the verso of the title page.
For the printed version this follows common practice of books, while
keeping the text in front of the table of contents reasonably short
for the HTML version.
credits.tex | 52 ----------------------------------------------------
introduction.tex | 31 +++++++++++++++++++++++++++++++
pms.tex | 14 ++++++++++++--
3 files changed, 43 insertions(+), 54 deletions(-)
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{[email protected]} 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{[email protected]} 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 40d4ad5..73b7dac 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-ShareAlike 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}
