1 |
commit: ac633821166d2a8dc4a205b474e581e0943a5149 |
2 |
Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
3 |
AuthorDate: Thu Nov 26 06:54:44 2015 +0000 |
4 |
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> |
5 |
CommitDate: Thu May 25 18:43:41 2017 +0000 |
6 |
URL: https://gitweb.gentoo.org/proj/pms.git/commit/?id=ac633821 |
7 |
|
8 |
Rearrange front matter. |
9 |
|
10 |
Move sections Reporting Issues and Acknowledgments to the Introduction |
11 |
chapter (and number them). Copyright and licence information goes to |
12 |
the verso of the title page. |
13 |
|
14 |
For the printed version this follows common practice of books, while |
15 |
keeping the text in front of the table of contents reasonably short |
16 |
for the HTML version. |
17 |
|
18 |
credits.tex | 52 ---------------------------------------------------- |
19 |
introduction.tex | 31 +++++++++++++++++++++++++++++++ |
20 |
pms.tex | 14 ++++++++++++-- |
21 |
3 files changed, 43 insertions(+), 54 deletions(-) |
22 |
|
23 |
diff --git a/credits.tex b/credits.tex |
24 |
deleted file mode 100644 |
25 |
index 6c54e60..0000000 |
26 |
--- a/credits.tex |
27 |
+++ /dev/null |
28 |
@@ -1,52 +0,0 @@ |
29 |
-\chapter*{} |
30 |
- |
31 |
-\section*{Acknowledgements} |
32 |
- |
33 |
-Thanks to Mike Kelly (package manager provided utilities, section~\ref{sec:pkg-mgr-commands}), |
34 |
-Danny van Dyk (ebuild functions, section~\ref{sec:ebuild-functions}), David Leverton (various |
35 |
-sections), Petteri Räty (environment state, section~\ref{sec:ebuild-env-state}) and Michał Górny |
36 |
-(various sections) for contributions. Thanks also to Mike Frysinger and Brian Harring for |
37 |
-proof-reading and suggestions for fixes and/or clarification. |
38 |
- |
39 |
-\section*{Copyright and Licence} |
40 |
- |
41 |
-The bulk of this document is \textcopyright{} 2007--2017 Stephen Bennett, Christian Faulhammer, |
42 |
-Ciaran McCreesh and Ulrich Müller. Contributions are owned by their respective authors, and may |
43 |
-have been changed substantially before inclusion. |
44 |
- |
45 |
-This document is released under the Creative Commons Attribution-Share Alike 3.0 Licence. The full |
46 |
-text of this licence can be found at \url{http://creativecommons.org/licenses/by-sa/3.0/}. |
47 |
- |
48 |
-\section*{Reporting Issues} |
49 |
- |
50 |
-Issues (inaccuracies, wording problems, omissions etc.)\ in this document should be reported via |
51 |
-Gentoo Bugzilla using product \e{Gentoo Hosted Projects}, component \e{PMS/EAPI} and the default |
52 |
-assignee. There should be one bug per issue, and one issue per bug. |
53 |
- |
54 |
-Patches (in \t{git format-patch} form if possible) may be submitted either via Bugzilla or to the |
55 |
-\t{gentoo-pms@l.g.o} mailing list. Patches will be reviewed by the PMS team, who will do |
56 |
-one of the following: |
57 |
- |
58 |
-\begin{compactitem} |
59 |
-\item Accept and apply the patch. |
60 |
-\item Explain why the patch cannot be applied as-is. The patch may then be updated and resubmitted |
61 |
-if appropriate. |
62 |
-\item Reject the patch outright. |
63 |
-\item Take special action merited by the individual circumstances. |
64 |
-\end{compactitem} |
65 |
- |
66 |
-When reporting issues, remember that this document is not the appropriate place for pushing |
67 |
-through changes to the tree or the package manager, except where those changes are bugs. |
68 |
- |
69 |
-If any issue cannot be resolved by the PMS team, it may be escalated to the Gentoo Council. |
70 |
- |
71 |
-% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en : |
72 |
- |
73 |
-%%% Local Variables: |
74 |
-%%% mode: latex |
75 |
-%%% TeX-master: "pms" |
76 |
-%%% LaTeX-indent-level: 4 |
77 |
-%%% LaTeX-item-indent: 0 |
78 |
-%%% TeX-brace-indent-level: 4 |
79 |
-%%% fill-column: 100 |
80 |
-%%% End: |
81 |
|
82 |
diff --git a/introduction.tex b/introduction.tex |
83 |
index 7c22fd4..36e8b14 100644 |
84 |
--- a/introduction.tex |
85 |
+++ b/introduction.tex |
86 |
@@ -25,6 +25,29 @@ ebuild repository looks like, and how an ebuild is allowed to behave. Thus, both |
87 |
package managers can change aspects of their behaviour not defined here without worry of |
88 |
incompatibilities with any particular repository. |
89 |
|
90 |
+\section{Reporting Issues} |
91 |
+ |
92 |
+Issues (inaccuracies, wording problems, omissions etc.)\ in this document should be reported via |
93 |
+Gentoo Bugzilla using product \e{Gentoo Hosted Projects}, component \e{PMS/EAPI} and the default |
94 |
+assignee. There should be one bug per issue, and one issue per bug. |
95 |
+ |
96 |
+Patches (in \t{git format-patch} form if possible) may be submitted either via Bugzilla or to the |
97 |
+\t{gentoo-pms@l.g.o} mailing list. Patches will be reviewed by the PMS team, who will do |
98 |
+one of the following: |
99 |
+ |
100 |
+\begin{compactitem} |
101 |
+\item Accept and apply the patch. |
102 |
+\item Explain why the patch cannot be applied as-is. The patch may then be updated and resubmitted |
103 |
+if appropriate. |
104 |
+\item Reject the patch outright. |
105 |
+\item Take special action merited by the individual circumstances. |
106 |
+\end{compactitem} |
107 |
+ |
108 |
+When reporting issues, remember that this document is not the appropriate place for pushing through |
109 |
+changes to the tree or the package manager, except where those changes are bugs. |
110 |
+ |
111 |
+If any issue cannot be resolved by the PMS team, it may be escalated to the Gentoo Council. |
112 |
+ |
113 |
\section{Conventions} |
114 |
|
115 |
Text in \t{teletype} is used for filenames or variable names. \i{Italic} text is used for terms |
116 |
@@ -34,6 +57,14 @@ The term \i{package manager} is used throughout this document in a broad sense. |
117 |
of this document are only relevant to fully featured package managers, many items are equally |
118 |
applicable to tools or other applications that interact with ebuilds or ebuild repositories. |
119 |
|
120 |
+\section{Acknowledgements} |
121 |
+ |
122 |
+Thanks to Mike Kelly (package manager provided utilities, section~\ref{sec:pkg-mgr-commands}), |
123 |
+Danny van Dyk (ebuild functions, section~\ref{sec:ebuild-functions}), David Leverton (various |
124 |
+sections), Petteri Räty (environment state, section~\ref{sec:ebuild-env-state}) and Michał Górny |
125 |
+(various sections) for contributions. Thanks also to Mike Frysinger and Brian Harring for |
126 |
+proof-reading and suggestions for fixes and/or clarification. |
127 |
+ |
128 |
% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en : |
129 |
|
130 |
%%% Local Variables: |
131 |
|
132 |
diff --git a/pms.tex b/pms.tex |
133 |
index 40d4ad5..73b7dac 100644 |
134 |
--- a/pms.tex |
135 |
+++ b/pms.tex |
136 |
@@ -27,13 +27,23 @@ |
137 |
\begin{document} |
138 |
\maketitle |
139 |
|
140 |
+\thispagestyle{empty} |
141 |
+\vspace*{\fill} |
142 |
+{% |
143 |
+ \small |
144 |
+ The bulk of this document is \textcopyright{} 2007--2017 Stephen Bennett, Christian Faulhammer, |
145 |
+ Ciaran McCreesh and Ulrich Müller. Contributions are owned by their respective authors, and may |
146 |
+ have been changed substantially before inclusion. |
147 |
+ |
148 |
+ This document is released under the Creative Commons Attribution-ShareAlike 3.0 Licence. The |
149 |
+ full text of this licence can be found at \url{http://creativecommons.org/licenses/by-sa/3.0/}. |
150 |
+} |
151 |
+ |
152 |
\tableofcontents |
153 |
\listofalgorithms |
154 |
\listoflistings |
155 |
\listoftables |
156 |
|
157 |
-\include{credits} |
158 |
- |
159 |
\include{introduction} |
160 |
|
161 |
\include{eapis} |