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