diff options
author | Ulrich Müller <ulm@gentoo.org> | 2015-11-26 07:54:44 +0100 |
---|---|---|
committer | Ulrich Müller <ulm@gentoo.org> | 2017-05-25 20:43:41 +0200 |
commit | ac633821166d2a8dc4a205b474e581e0943a5149 (patch) | |
tree | b9c22097c2b6f1db99d00ff08562862c1a7bd2b9 | |
parent | pms.tex: Make sure that the cheat sheet starts on an odd page. (diff) | |
download | pms-ac633821166d2a8dc4a205b474e581e0943a5149.tar.gz pms-ac633821166d2a8dc4a205b474e581e0943a5149.tar.bz2 pms-ac633821166d2a8dc4a205b474e581e0943a5149.zip |
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.
-rw-r--r-- | credits.tex | 52 | ||||
-rw-r--r-- | introduction.tex | 31 | ||||
-rw-r--r-- | 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{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: @@ -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} |