Re: [gentoo-pms] Patches for your reviewing pleasure: Various improvements, including cheat sheet

[Christian Faulhammer <fauli@gentoo.org>]

[-- Attachment #1.1: Type: text/plain, Size: 6021 bytes --]

Hi,

Ciaran McCreesh <ciaran.mccreesh@googlemail.com>:
[chapters subdir]
> Well, it's really an all or nothing thing. And all's going to be a
> pain until we're sure we aren't going to have to go back and edit the
> history.

 We can wait with it.


> > 0001: Desk reference, updated and all issues you raised handled.
> 
> You're indenting with two spaces rather than four, and don't have our
> precious vim modelines. Lack of consistency makes me cry!

 Then go change the other files, and if Vim is too dumb to recognise a
LaTeX file, I can't help it.

> > +  from the same checkout as this overview.  
> 
> has trailing whitespace. Git moans about this.

 Fixed.
 
> > +  Please report mistakes or enhancements to this document via the
> 
> should read "mistakes in or enhancements to"
> 
> > +Currently there is no full specification what EAPI 0 includes.
> > +Portage, official ebuild documentation and existing ebuilds set the
> > +standard here, although obvious errors are still errors.
> 
> I'm wondering whether we can tone this (and the similar wording in
> PMS) down a bit. The Council approved PMS as "correct, except where
> people file bugs" a while back.
> 
> > +  disabled explicitely by user configuration) with a \code{+} sign
> > in
> 
> Spelling of 'explicitly'.
> 
> > +\item[Named slot dependencies] Dependencies can explicitely
> > request a
> 
> Ditto.
> 
> > +\item[\code{SRC\_URI} arrows] Allows redirection of upstream file
> > +  naming scheme by using an "arrow" (\code{->}) to a new file name
> > in
> > +  DISTDIR.  See \featureref{src-uri-arrows}.
> 
> Not sure on this wording. How about something like:
> 
>     SRC_URI="http://some/url -> foo" can be used to use foo as the
>     filename for downloads.
> 
> > +\item[USE dependencies] Dependencies can be specified to be built
> > with
> > +  or without a specific USE flag, thus getting rid of countless
> > +  \code{built\_with\_use} checks.  A more sophisticated syntax is
> > +  available in EAPI 3.
> 
>     Dependencies can specify use flag requirements on their target,
>     removing the need for built_with_use checks. A more powerful
> syntax that does not require the flag to be in IUSE is in EAPI 3.
> 
> > +  Patching and other preparing tasks must no longer take place in
> > +  \code{src\_unpack} but in \code{src\_prepare}.
> 
>     Patching and similar preparation must now be done in src_prepare,
>     not src_unpack.
> 
> > +  be called via \code{default\_\emph{phasename}}, so small
> > additions
> > +  you need will not be accompanied by a complete reimplementation
> > of
> > +  the phase.  Additionally as a shorthand for the current phase's
> > +  default definition \code{default} can be invoked.
> 
>     so duplicating the standard implementation is no longer necessary.
>     The default function calls the current phase's default_ function
>     automatically.
> 
> > +  Duplicating checks from the \code{pkg\_setup} phase may be
> > +  necessary.
> 
>     Most checks should usually be repeated in pkg_setup.
> 
> > +  phase can be called even for non-installed packages.  Do not
> > depend
> > +  on any outside programs in that case!  See \featureref{pkg-info}.
> 
>     Be warned that dependencies might not have been installed.
> 
> > +\item[Slot operators] There are two ways to define a wanted slot
> > in a
> > +  dependency string:
> 
>     Dependencies that are both DEPEND and RDEPEND and that can match
>     multiple slots should specify one of:
> 
> > +\item[USE dependency defaults] Additionally to the features
> > offered in
> 
>     In addition to the ...
> 
> > +  after a USE flag (mind the braces).
> 
> Braces are {}. You want brackets or parentheses.
> 
> > The former leads to the
> > +  assumption that the USE flag is available when not found in the
> > +  dependency, the latter leads to the reverse behaviour.  This
> > mimicks
> > +  parts of the behaviour of \code{-{}-missing} in
> 
>     The former specifies that flags not in IUSE should be treated as
>     enabled; the latter, disabled. Cannot be used with USE_EXPAND
> flags.
> 
> > +  \code{/usr/share\{doc,info,man\}} are compressed on-disk after
> 
> s/are/may be
> 
> > +  With \code{docompress} all arguments are passed to the inclusion
> > +  list, while the behaviour can be inverted with the \code{-x}
> > +  switch.  See \featureref{controllable-compress}.
> 
>     docompress path ... adds paths to the inclusion list for
>     compression. docompress -x path ... adds paths to the exclusion
>     list.
> 
> > +  files respectively in the known manner.
> 
> "in the known manner" sounds weird.
> 
> > +  command given as argument will not abort the build process in
> > case
> > +  of a failure but preserve the exit status nonetheless.  See
> 
> I'd mention that commands die on error before this. And then:
> 
>     will return non-zero on failure rather than aborting the build.
> 
> > +\item[USE flags in any-of] Inside of \code{||} constructs USE flag
> > +  conditionals are forbidden (with exceptions).
> 
>     use? ( ) blocks are forbidden as direct children of || ( ) blocks.
> 
> > +  anymore.
> 
> 'anymore' as a single word is generally considered horrible.

 Adressed I hope.  Last iteration, what you don't find now, will go in
later.

And more patches:
0001: Corrected desk reference.
0002: Tell Emacs to use retarded indenting in all LaTeX files, so the
Vim weenies don't whine.
0003: Fix intendation to 4 spaces where needed.
0004: Comment class file
0005: Kick out appendix.sty and a little appendix tweak
0006: Some minor Makefile tweaking
0007: Make email addresses clickable

And for inital review:
0008: Add Gentoo logo to PMS and desk reference.

V-Li

-- 
Christian Faulhammer, Gentoo Lisp project
<URL:http://www.gentoo.org/proj/en/lisp/>, #gentoo-lisp on FreeNode

<URL:http://gentoo.faulhammer.org/>

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.2: 0001-Desk-reference-for-quick-look-up.patch --]
[-- Type: text/x-patch, Size: 13761 bytes --]

From 39d589249a093170434df2a6185dbace3fd1221c Mon Sep 17 00:00:00 2001
From: Christian Faulhammer <fauli@gentoo.org>
Date: Mon, 13 Apr 2009 12:11:54 +0200
Subject: [PATCH] Desk reference for quick look-up

This contains a short summary of all EAPI features so far, similar
to appendix E of PMS, but with more information.
---
 Makefile                       |    8 +-
 cheatsheet/eapi_cheatsheet.tex |  231 ++++++++++++++++++++++++++++++++++++++++
 credits.tex                    |    5 +-
 pms.cls                        |    1 +
 pms.tex                        |    2 +
 5 files changed, 243 insertions(+), 4 deletions(-)
 create mode 100644 cheatsheet/eapi_cheatsheet.tex

diff --git a/Makefile b/Makefile
index e9c3dd4..b585411 100644
--- a/Makefile
+++ b/Makefile
@@ -5,13 +5,14 @@ clean :
 	rm -f *~ *.pdf *.dvi *.log *.aux *.bbl *.blg *.toc *.lol *.loa *.lox \
 	    *.lot *.out *.html *.css *.png *.4ct *.4tc *.idv *.lg *.tmp *.xref vc.tex || true
 
-LATEXFILES = $(shell ls *.tex) pms.cls
+LATEXFILES = $(shell find -name '*.tex') pms.cls
 LISTINGFILES = $(shell ls *.listing)
 SOURCEFILES = $(LATEXFILES) $(LISTINGFILES)
 
-pms.pdf: $(SOURCEFILES) pms.bbl vc.tex
+pms.pdf: $(SOURCEFILES) pms.bbl vc.tex eapi_cheatsheet.pdf
 	pdflatex pms
 	pdflatex pms
+	pdflatex cheatsheet/eapi_cheatsheet
 	pdflatex pms
 
 pms.html: $(SOURCEFILES) pms.bbl
@@ -31,6 +32,9 @@ pms.bbl: pms.bib pms.tex vc.tex
 	latex pms
 	bibtex pms
 
+eapi_cheatsheet.pdf: vc.tex
+	pdflatex cheatsheet/eapi_cheatsheet
+
 vc.tex: pms.tex
 	/bin/sh ./vc
 
diff --git a/cheatsheet/eapi_cheatsheet.tex b/cheatsheet/eapi_cheatsheet.tex
new file mode 100644
index 0000000..278061e
--- /dev/null
+++ b/cheatsheet/eapi_cheatsheet.tex
@@ -0,0 +1,231 @@
+\documentclass[a4paper,notumble]{leaflet}
+\input{vc}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{
+    url,
+    xr-hyper,
+    hyperref,
+    listings,
+    ifthen,
+    mathptmx,
+    courier
+}
+\usepackage[orig,english]{isodate}
+\usepackage[scaled=.90]{helvet}
+\newcommand{\code}[1]{\texttt{#1}}
+\newcommand{\version}{0.2}
+\newcommand{\featureref}[1]{\textsc{#1} on page~\pageref{feat:#1}}
+\renewcommand{\familydefault}{\sfdefault}
+\urlstyle{sf}
+\externaldocument{pms}
+
+\title{EAPI Cheat Sheet}
+\author{Christian
+    Faulhammer\thanks{\href{mailto:fauli@gentoo.org}{fauli@gentoo.org}}}
+\ifthenelse{\equal{\VCDateISO}{}}
+{
+    \date{Version \version{}, generated on: \\\today}
+}{
+    \date{Version \version\\\printdate{\VCDateISO}}
+}
+\CutLine*{1}
+\CutLine*{3}
+\CutLine*{4}
+\CutLine*{6}
+\hypersetup{%
+    urlcolor=black,
+    colorlinks=true,
+    citecolor=black,
+    linkcolor=black,
+    pdftitle={EAPI Desk Reference},
+    pdfauthor={Christian Faulhammer},
+    pdfsubject={Making look-up faster for EAPI features},
+    pdflang={en},
+    pdfkeywords={Gentoo, package manager, reference},
+    pdfproducer={pdfLaTeX and hyperref},
+}
+\begin{document}
+\maketitle
+\thispagestyle{empty}
+\begin{abstract}
+    An overview of the main EAPI changes in Gentoo, for ebuild
+    authors.  For full details, consult the Package Manager
+    Specification\footnote{\url{http://www.gentoo.org/proj/en/qa/pms/}};
+    this is an incomplete summary only.
+
+    Official Gentoo EAPIs are consecutively numbered integers (0, 1,
+    2, \dots).  Except where otherwise noted, an EAPI is the same as
+    the previous EAPI.  All label refer to the PMS document itself,
+    built from the same checkout as this overview.
+
+    Please report mistakes in or enhancements to this document via the
+    Gentoo bug tracking system\footnote{\url{http://bugs.gentoo.org/}}
+    to the original author or the PMS team.
+
+    This document is released under the Creative Commons
+    Attribution-Share Alike 3.0
+    Licence\footnote{\url{http://creativecommons.org/licenses/by-sa/3.0/}}.
+\end{abstract}
+\section{EAPI 0}
+\label{sec:cs:eapi0}
+If there is no EAPI explicitly specified, EAPI 0 is assumed.
+Currently there is no full specification what EAPI 0 includes.
+Portage, official ebuild documentation and existing ebuilds set the
+standard.  If you think you found a bug, you should file a bug report
+nonetheless.
+\newpage
+\section{EAPI 1}
+\label{sec:cs:eapi1}
+\subsection{Additions/Changes}
+\label{sec:cs:eapi1-additions}
+\begin{description}
+    \item[IUSE defaults] An USE flag can be marked as mandatory (if
+    not disabled explicitly by user configuration) with a \code{+}
+    sign in front.  See \featureref{iuse-defaults}.
+    \item[Named slot dependencies] Dependencies can explicitly request
+    a specific slot by using the \code{dev-libs/foo:SLOT} syntax.  See
+    \featureref{slot-deps}.
+\end{description}
+\section{EAPI 2 (2008-09-25)}
+\label{sec:cs:eapi2}
+\subsection{Additions/Changes}
+\label{sec:cs:eapi2-additions}
+\begin{description}
+    \item[\code{SRC\_URI} arrows] Allows redirection of upstream file
+    naming scheme.  By using \code{SRC\_URI="http://some/url -> foo"}
+    the file is saved as \code{foo} in DISTDIR.  See
+    \featureref{src-uri-arrows}.
+    \item[USE dependencies] Dependencies can specify USE flag
+    requirements on their target, removing the need for
+    \code{built\_with\_use} checks. A more powerful syntax that does
+    not require the flag to be in IUSE is in EAPI 3.
+    \begin{description}
+        \item[{[opt]}] The flag must be enabled.
+        \item[{[opt=]}] The flag must be enabled if the flag is
+        enabled for the package with the dependency, or disabled
+        otherwise.
+        \item[{[!opt=]}] The flag must be disabled if the flag is
+        enabled for the package with the dependency, or enabled
+        otherwise.
+        \item[{[opt?]}] The flag must be enabled if the flag is
+        enabled for the package with the dependency.
+        \item[{[!opt?]}] The flag must be disabled if the use flag is
+        disabled for the package with the dependency.
+        \item[{[-opt]}] The flag must be disabled.
+    \end{description}
+    See \featureref{use-deps}.
+    \item[Blocker syntax] A single exclamation mark as a blocker may
+    be ignored by the package manager as long as the stated package is
+    uninstalled later on.  Two exclamation marks are a strong blocker
+    and will always be respected.  See \featureref{bang-strength}.
+    \item[\code{src\_configure, src\_prepare}] Both new phases provide
+    finer granularity in the ebuild's structure.  Configure calls
+    should be moved from \code{src\_compile} to \code{src\_configure}.
+    Patching and similar preparation must now be done in
+    \code{src\_prepare}, not \code{src\_unpack}.  See
+    \featureref{src-prepare} and \featureref{src-configure}.
+    \item[Default phase functions] The default functions for the
+    phases \code{pkg\_nofetch}, \code{src\_unpack},
+    \code{src\_prepare}, \code{src\_configure}, \code{src\_compile}
+    and \code{src\_test} can be called via
+    \code{default\_\emph{phasename}}, so duplicating the standard
+    implementation is no longer necessary for small additions.  The
+    \code{default} function calls the current phase's \code{default\_}
+    function automatically.  so small additions you need will not be
+    accompanied by a complete reimplementation of the phase.
+    Additionally as a shorthand for the current phase's default
+    definition \code{default} can be invoked.  See
+    \featureref{default-phase-funcs} and \featureref{default-func}.
+    \item[\code{doman} language support] The \code{doman} installation
+    function recognizes lanugage specific man page extensions and
+    behaves accordingly.  See \featureref{doman-langs}
+\end{description}
+\newpage
+\section{EAPI 3 (not yet approved)}
+\label{sec:cs:eapi3}
+\subsection{Additions/Changes}
+\label{sec:cs:eapi3-additions}
+\begin{description}
+    \item[\code{pkg\_pretend}] Some useful checks (kernel options for
+    example) can be placed in this new phase to inform the user early.
+    Most checks should usually be repeated in \code{pkg\_setup}.  See
+    \featureref{pkg-pretend}.
+    \item[\code{src\_install}] The \code{src\_install} phase is no
+    longer empty but has a default now.  This comes along with an
+    accompanying \code{default} function.  See
+    \featureref{src-install-3}.
+    \item[\code{pkg\_info} on non-installed packages] The
+    \code{pkg\_info} phase can be called even for non-installed
+    packages.  Be warned that dependencies might not have been
+    installed at execution time.  See \featureref{pkg-info}.
+    \item[No RDEPEND fall-back] The package manager will not fall back
+    to \code{RDEPEND=DEPEND} if RDEPEND is undefined.  See
+    \featureref{rdepend-depend}
+    \item[Support for \code{.xz}] Unpack of \code{.xz} and
+    \code{.tar.xz} files is possible.  See
+    \featureref{unpack-extensions}.
+    \item[Slot operators] Dependencies that are both DEPEND and
+    RDEPEND and that can match multiple slots should specify one of:
+    \begin{description}
+        \item[\code{:*}] Indicates that any slot value is
+        acceptable. In addition, for runtime dependencies, indicates
+        that the package will not break if the matched package is
+        uninstalled and replaced by a different matching package in a
+        different slot.
+        \item[\code{:=}] Indicates that any slot value is
+        acceptable. In addition, for runtime dependencies, indicates
+        that the package will break unless a matching package with
+        slot equal to the slot of the best installed version at the
+        time the package was installed is available.
+    \end{description}
+    See \featureref{slot-operator-deps}.
+    \item[USE dependency defaults] In addition to the features offered
+    in EAPI 2 for USE dependencies, a \code{(+)} or \code{(-)} can be
+    added after a USE flag (mind the parentheses).  The former
+    specifies that flags not in IUSE should be treated as enabled; the
+    latter, disabled. Cannot be used with USE\_EXPAND flags.  This
+    mimicks parts of the behaviour of \code{-{}-missing} in
+    \code{built\_with\_use}.  See \featureref{use-dep-defaults}.
+    \item[Controllable compression] All items in
+    \code{/usr/share\{doc,info,man\}} may be compressed on-disk after
+    \code{src\_install}, except for
+    \code{/usr/share/doc/\$\{PF\}/html}.  \code{docompress path \dots}
+    adds paths to the inclusion list for compression.
+    \code{docompress -x path \dots} adds paths to the exclusion list.
+    \featureref{controllable-compress}.
+    \item[\code{dodoc} recursion] If the \code{-r} switch is given as
+    first argument and followed by directories, files from there are
+    installed recursively.  See \featureref{dodoc}.
+    \item[\code{doins} symlink support] Symbolic links are now
+    properly installed when using recursion (\code{-r} switch).  See
+    \featureref{doins}.
+    \item[New installation functions] \code{doexample},
+    \code{newexample}, \code{doinclude} and \code{newinclude} install
+    example and include files respectively.  See
+    \featureref{doexample} and \featureref{doinclude}.
+    \item[\code{nonfatal} for commands] If you call \code{nonfatal}
+    the command given as argument will not abort the build process in
+    case of a failure (as is the default) but will return non-zero on
+    failure rather than aborting the build..  See
+    \featureref{nonfatal}.
+\end{description}
+\subsection{Removals/Bans}
+\label{sec:cs:eapi3-removalsbans}
+\begin{description}
+    \item[USE flags in any-of] \code{use? ( )} blocks are forbidden as
+    direct children of \code{|| ( )} blocks.  See \featureref{any-use}
+    \item[\code{dohard}, \code{dosed}] Both functions are not allowed
+    anymore.  See \featureref{banned-commands}.
+\end{description}
+\end{document}
+
+% vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
+
+%%% Local Variables:
+%%% mode: latex
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
+%%% End:
+
diff --git a/credits.tex b/credits.tex
index 8494516..ceec6cf 100644
--- a/credits.tex
+++ b/credits.tex
@@ -3,8 +3,9 @@
 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) and
 Petteri Räty (environment state, section~\ref{sec:ebuild-env-state}) for contributions. Thanks to
-Christian Faulhammer for fixing some of the more horrible formatting screwups. Thanks also to Mike
-Frysinger and Brian Harring for proof-reading and suggestions for fixes and/or clarification.
+Christian Faulhammer for fixing some of the more horrible formatting screwups and providing the EAPI
+cheat sheet. Thanks also to Mike Frysinger and Brian Harring for proof-reading and suggestions for
+fixes and/or clarification.
 
 \section*{Copyright and Licence}
 
diff --git a/pms.cls b/pms.cls
index 90e8584..c5ac869 100644
--- a/pms.cls
+++ b/pms.cls
@@ -32,6 +32,7 @@
   marginnote,
   paralist,
   parskip,
+  pdfpages,
   verbatim,
   algorithm,
   algorithmic
diff --git a/pms.tex b/pms.tex
index 8426706..745882b 100644
--- a/pms.tex
+++ b/pms.tex
@@ -46,6 +46,8 @@
 
 \bibliography{pms}
 
+\includepdf[pages=-,landscape]{eapi_cheatsheet}
+
 \end{document}
 
 % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
-- 
1.6.0.6


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.3: 0002-Expand-Emacs-local-variables.patch --]
[-- Type: text/x-patch, Size: 11599 bytes --]

From 603f19e4fbdc913d6ec191ab9629dd1610adc7f5 Mon Sep 17 00:00:00 2001
From: Christian Faulhammer <fauli@gentoo.org>
Date: Wed, 15 Apr 2009 12:34:09 +0200
Subject: [PATCH] Expand Emacs local variables

Set indentation level to 4
Fix some cosmetic spacing issues
Add missing local variables list
---
 appendices.tex            |    3 +++
 credits.tex               |    3 +++
 dependencies.tex          |    4 +++-
 eapi-differences.tex      |    3 +++
 eapis.tex                 |    3 +++
 ebuild-env-commands.tex   |    3 +++
 ebuild-env-invariancy.tex |    4 +++-
 ebuild-env-state.tex      |    3 +++
 ebuild-env-vars.tex       |    3 +++
 ebuild-environment.tex    |    3 +++
 ebuild-format.tex         |    3 +++
 ebuild-functions.tex      |    3 +++
 ebuild-vars.tex           |    3 +++
 eclasses.tex              |    3 +++
 glossary.tex              |    4 +++-
 introduction.tex          |    3 +++
 merge.tex                 |    3 +++
 metadata-cache.tex        |    3 +++
 names.tex                 |    3 +++
 pkg-mgr-commands.tex      |    3 +++
 pms.cls                   |    8 ++++++++
 pms.tex                   |    4 +++-
 profile-variables.tex     |    3 +++
 profiles.tex              |    3 +++
 tree-layout.tex           |    4 ++++
 virtuals.tex              |    3 +++
 26 files changed, 84 insertions(+), 4 deletions(-)

diff --git a/appendices.tex b/appendices.tex
index fef856b..be4e94f 100644
--- a/appendices.tex
+++ b/appendices.tex
@@ -63,4 +63,7 @@ it must not be used.
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/credits.tex b/credits.tex
index ceec6cf..95b66c1 100644
--- a/credits.tex
+++ b/credits.tex
@@ -44,4 +44,7 @@ If any issue cannot be resolved by the PMS team, it may be escalated to the Gent
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/dependencies.tex b/dependencies.tex
index beda6f3..1aacbbb 100644
--- a/dependencies.tex
+++ b/dependencies.tex
@@ -607,8 +607,10 @@ filename to the right of the arrow shall be requested instead of the filename in
 
 % 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
 %%% End:
diff --git a/eapi-differences.tex b/eapi-differences.tex
index a7d8d4c..b2b92f2 100644
--- a/eapi-differences.tex
+++ b/eapi-differences.tex
@@ -363,4 +363,7 @@ EAPI 3 is EAPI 2 with the following changes:
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/eapis.tex b/eapis.tex
index f749f1e..b9cdf62 100644
--- a/eapis.tex
+++ b/eapis.tex
@@ -68,4 +68,7 @@ Except where explicitly noted, everything in this specification applies to all o
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/ebuild-env-commands.tex b/ebuild-env-commands.tex
index 065560d..5f4c4b3 100644
--- a/ebuild-env-commands.tex
+++ b/ebuild-env-commands.tex
@@ -51,4 +51,7 @@ in the following cases:
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/ebuild-env-invariancy.tex b/ebuild-env-invariancy.tex
index f0f5a2d..9476a8b 100644
--- a/ebuild-env-invariancy.tex
+++ b/ebuild-env-invariancy.tex
@@ -30,8 +30,10 @@ The following exclusivity and invariancy requirements are mandated:
 
 % 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
 %%% End:
diff --git a/ebuild-env-state.tex b/ebuild-env-state.tex
index 7505e4b..82bf6dc 100644
--- a/ebuild-env-state.tex
+++ b/ebuild-env-state.tex
@@ -29,4 +29,7 @@ This is demonstrated by code listing~\ref{lst:env-saving}.
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/ebuild-env-vars.tex b/ebuild-env-vars.tex
index b14f6e1..6ea8b59 100644
--- a/ebuild-env-vars.tex
+++ b/ebuild-env-vars.tex
@@ -311,4 +311,7 @@ shall be defined in \t{pkg\_prerm} and \t{pkg\_postrm}. It shall contain at most
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/ebuild-environment.tex b/ebuild-environment.tex
index b1649a6..cf26e81 100644
--- a/ebuild-environment.tex
+++ b/ebuild-environment.tex
@@ -13,4 +13,7 @@
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/ebuild-format.tex b/ebuild-format.tex
index 5b63822..d6c8270 100644
--- a/ebuild-format.tex
+++ b/ebuild-format.tex
@@ -13,4 +13,7 @@ anything to standard output or standard error, or modify the state of the system
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/ebuild-functions.tex b/ebuild-functions.tex
index 2adcaf2..96105e4 100644
--- a/ebuild-functions.tex
+++ b/ebuild-functions.tex
@@ -684,4 +684,7 @@ and \t{pkg\_postinst} functions are not called.
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/ebuild-vars.tex b/ebuild-vars.tex
index 419c96c..b2c1bd9 100644
--- a/ebuild-vars.tex
+++ b/ebuild-vars.tex
@@ -297,4 +297,7 @@ based upon any variant condition.
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/eclasses.tex b/eclasses.tex
index 3888a0e..e55190b 100644
--- a/eclasses.tex
+++ b/eclasses.tex
@@ -86,4 +86,7 @@ must be named \t{eclassname\_phasefunctionname}, where \t{eclassname} is the nam
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/glossary.tex b/glossary.tex
index 1ef41a9..729ee39 100644
--- a/glossary.tex
+++ b/glossary.tex
@@ -22,10 +22,12 @@ be immediately obvious.
 
 \end{description}
 
-
 % 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
 %%% End:
diff --git a/introduction.tex b/introduction.tex
index 95b5ecc..3986f57 100644
--- a/introduction.tex
+++ b/introduction.tex
@@ -39,4 +39,7 @@ applicable to tools or other applications that interact with ebuilds or ebuild r
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/merge.tex b/merge.tex
index aef0250..91db3fb 100644
--- a/merge.tex
+++ b/merge.tex
@@ -117,4 +117,7 @@ Ebuilds must not attempt to install any other type of file (FIFOs, device nodes
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/metadata-cache.tex b/metadata-cache.tex
index 60186c0..70afe2f 100644
--- a/metadata-cache.tex
+++ b/metadata-cache.tex
@@ -48,4 +48,7 @@ not a supported EAPI on line 15 if it does not.
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/names.tex b/names.tex
index 53ff520..42bbc99 100644
--- a/names.tex
+++ b/names.tex
@@ -161,4 +161,7 @@ For example, a repository may not contain more than one of \t{foo-bar/baz-1.0.2}
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/pkg-mgr-commands.tex b/pkg-mgr-commands.tex
index 0e88ed0..cb9a6cf 100644
--- a/pkg-mgr-commands.tex
+++ b/pkg-mgr-commands.tex
@@ -988,4 +988,7 @@ ebuilds:
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/pms.cls b/pms.cls
index c5ac869..483b30c 100644
--- a/pms.cls
+++ b/pms.cls
@@ -143,3 +143,11 @@
 \areaset[-30mm]{400pt}{700pt}
 
 % 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
+%%% End:
diff --git a/pms.tex b/pms.tex
index 745882b..a1bab85 100644
--- a/pms.tex
+++ b/pms.tex
@@ -52,8 +52,10 @@
 
 % vim: set filetype=tex fileencoding=utf8 et tw=100 spell spelllang=en :
 
-
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: t
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/profile-variables.tex b/profile-variables.tex
index eb453e1..b514cac 100644
--- a/profile-variables.tex
+++ b/profile-variables.tex
@@ -101,4 +101,7 @@ and are not required to be interpreted by the package manager.
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/profiles.tex b/profiles.tex
index 4af3304..fb0577b 100644
--- a/profiles.tex
+++ b/profiles.tex
@@ -169,4 +169,7 @@ A package manager may treat \t{ARCH} values that are not the current architectur
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
diff --git a/tree-layout.tex b/tree-layout.tex
index e49a931..e15d047 100644
--- a/tree-layout.tex
+++ b/tree-layout.tex
@@ -246,9 +246,13 @@ various XML files used in the repository, and repository timestamps.
 
 The \t{metadata/cache} directory may contain a cached form of all important ebuild metadata
 variables. The contents of this directory are described in section~\ref{metadata-cache}.
+
 % 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
 %%% End:
diff --git a/virtuals.tex b/virtuals.tex
index b75c488..8ac05aa 100644
--- a/virtuals.tex
+++ b/virtuals.tex
@@ -39,4 +39,7 @@ Blocks on provided virtuals have special behaviour documented in section~\ref{pr
 %%% Local Variables:
 %%% mode: latex
 %%% TeX-master: "pms"
+%%% LaTeX-indent-level: 4
+%%% LaTeX-item-indent: 0
+%%% TeX-brace-indent-level: 4
 %%% End:
-- 
1.6.0.6


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.4: 0003-Change-intendation-to-4-spaces.patch --]
[-- Type: text/x-patch, Size: 3286 bytes --]

From e584fa958309219424175231c13ed75e63a80df5 Mon Sep 17 00:00:00 2001
From: Christian Faulhammer <fauli@gentoo.org>
Date: Wed, 15 Apr 2009 13:38:32 +0200
Subject: [PATCH] Change intendation to 4 spaces

---
 pms.cls |   82 +++++++++++++++++++++++++++++++-------------------------------
 1 files changed, 41 insertions(+), 41 deletions(-)

diff --git a/pms.cls b/pms.cls
index 483b30c..16eaf9d 100644
--- a/pms.cls
+++ b/pms.cls
@@ -13,32 +13,32 @@
 \PassOptionsToPackage{utf8}{inputenc}
 % algorithmic and algorithm to be loaded last to avoid failures
 \RequirePackage{%
-  fontenc,
-  isodate,
-  typearea,
-  caption,
-  inputenc,
-  appendix,
-  booktabs,
-  color,
-  enumitem,
-  float,
-  fullpage,
-  graphicx,
-  hyperref,
-  ifthen,
-  longtable,
-  lscape,
-  marginnote,
-  paralist,
-  parskip,
-  pdfpages,
-  verbatim,
-  algorithm,
-  algorithmic
+    fontenc,
+    isodate,
+    typearea,
+    caption,
+    inputenc,
+    appendix,
+    booktabs,
+    color,
+    enumitem,
+    float,
+    fullpage,
+    graphicx,
+    hyperref,
+    ifthen,
+    longtable,
+    lscape,
+    marginnote,
+    paralist,
+    parskip,
+    pdfpages,
+    verbatim,
+    algorithm,
+    algorithmic
 }
 \ClassInfo{pms}{Capsulation of LaTeX stuff for the Package Manager
-  Specification, loaded baseclass: \ClassToLoad\MessageBreak}
+    Specification, loaded baseclass: \ClassToLoad\MessageBreak}
 \input{vc}
 
 \newboolean{TEX4HT-HACKS}
@@ -110,33 +110,33 @@
 }
 
 \hypersetup{%
-  urlcolor=black,
-  colorlinks=true,
-  citecolor=black,
-  linkcolor=black,
-  pdftitle={Package Manager Specification},
-  pdfauthor={Stephen P. Bennett, Ciaran McCreesh},
-  pdfcreator={pdfLaTeX and hyperref},
-  pdfsubject={Defining a feature set for package managers in the
-    Gentoo world},
-  pdflang={en},
-  pdfkeywords={Gentoo, package manager, specification},
-  pdfproducer={pdfLaTeX and hyperref},
+    urlcolor=black,
+    colorlinks=true,
+    citecolor=black,
+    linkcolor=black,
+    pdftitle={Package Manager Specification},
+    pdfauthor={Stephen P. Bennett, Ciaran McCreesh},
+    pdfcreator={pdfLaTeX and hyperref},
+    pdfsubject={Defining a feature set for package managers in the
+        Gentoo world},
+    pdflang={en},
+    pdfkeywords={Gentoo, package manager, specification},
+    pdfproducer={pdfLaTeX and hyperref},
 }
 \title{Package Manager Specification}
-\author{Stephen P. Bennett\\\url{spb@exherbo.org}
-\and Ciaran McCreesh\\\url{ciaran.mccreesh@googlemail.com}}
+\author{Stephen P. Bennett\\\url{spb@exherbo.org} \and Ciaran
+    McCreesh\\\url{ciaran.mccreesh@googlemail.com}}
 % Make the build succeed even when no Git repository is available
 \ifthenelse{\equal{\VCDateISO}{}}
 {
-  \date{Generated on: \today}
+    \date{Generated on: \today}
 }{
-  \date{\printdate{\VCDateISO}}
+    \date{\printdate{\VCDateISO}}
 }
 
 \pagestyle{myheadings}
 \markboth{\scshape Package Manager Specification}{\scshape Package
-  Manager Specification}
+    Manager Specification}
 % This is some kind of hack.  We set the proportions of the text area
 % and then move it 30mm to the left to increase the right (outer)
 % margin.
-- 
1.6.0.6


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.5: 0004-Comment-class-file-a-bit-more-for-beginner.patch --]
[-- Type: text/x-patch, Size: 5591 bytes --]

From 79d6b8f71f6b205576a37144aabb703338d70cd1 Mon Sep 17 00:00:00 2001
From: Christian Faulhammer <fauli@gentoo.org>
Date: Wed, 15 Apr 2009 13:49:22 +0200
Subject: [PATCH] Comment class file a bit more for beginner

---
 pms.cls |   75 +++++++++++++++++++++++++++++++++++++++-----------------------
 1 files changed, 47 insertions(+), 28 deletions(-)

diff --git a/pms.cls b/pms.cls
index 16eaf9d..8fc943f 100644
--- a/pms.cls
+++ b/pms.cls
@@ -1,46 +1,54 @@
 \NeedsTeXFormat{LaTeX2e}%
 \newcommand{\ClassToLoad}{report}
-\ProvidesClass{pms}[2009/04/04]
+\ProvidesClass{pms}
+% Accept all options given through the loading tex file
 \DeclareOption*{%
     \PassOptionsToClass{\CurrentOption}{\ClassToLoad}
 }
 \PassOptionsToClass{a4paper}{\ClassToLoad}
+% Let the base class process all give options, either from this class
+% or user defined from an outside tex file.
 \ProcessOptions\relax
 \LoadClass{\ClassToLoad}
 \PassOptionsToPackage{T1}{fontenc}
 \PassOptionsToPackage{orig,english}{isodate}
+% Position caption of float environments at the top
 \PassOptionsToPackage{position=top}{caption}
+% Enable UTF-8 input encoding
 \PassOptionsToPackage{utf8}{inputenc}
 % algorithmic and algorithm to be loaded last to avoid failures
 \RequirePackage{%
-    fontenc,
-    isodate,
-    typearea,
-    caption,
-    inputenc,
-    appendix,
-    booktabs,
-    color,
+    fontenc,	% Load extended font sets
+    isodate,	% Date formatting and conversions
+    typearea,	% Set page layout
+    caption,	% Extended float environment formatting
+    inputenc,	% Allow input methods apart from ASCII
+    appendix,	
+    booktabs,	% Nicer formatting of tables
+    color,	% Support more than black&white
     enumitem,
-    float,
+    float,	% More control over float environments
     fullpage,
-    graphicx,
-    hyperref,
-    ifthen,
-    longtable,
-    lscape,
-    marginnote,
-    paralist,
-    parskip,
-    pdfpages,
-    verbatim,
-    algorithm,
-    algorithmic
+    graphicx,	% Image support
+    hyperref,	% Support for hyperlinks
+    ifthen,	% Comfortable conditional routines
+    longtable,	% Extend tables over more than one page
+    lscape,	% Rotating pages
+    marginnote, % Typeset a paragraph in the page margin
+    paralist,	% Additional list environments
+    parskip,	% Space between paragraps instead of intendation
+    pdfpages,	% Include PDF files wholly
+    verbatim,	% Extend the print-as-is functionality
+    algorithm,	%
+    algorithmic % Set algorithms
 }
 \ClassInfo{pms}{Capsulation of LaTeX stuff for the Package Manager
     Specification, loaded baseclass: \ClassToLoad\MessageBreak}
+% Contains information over the source control system, generated
+% through Makefile
 \input{vc}
 
+% Make processing with TeX4HT possible
 \newboolean{TEX4HT-HACKS}
 \ifx\HCode\undefined
     \RequirePackage{mathptmx,
@@ -56,11 +64,16 @@
 \newfloat{listing}{tbp}{lol}[chapter]
 \floatname{listing}{Listing}
 \newcommand{\listoflistings}{\listof{listing}{Listings}}
+% Define own label and reference commands, that display the label in
+% the page margin.
 \newcommand{\featureref}[1]{\textsc{#1} on page~\pageref{feat:#1}}
 \newcommand{\compactfeatureref}[1]{#1~p\pageref{feat:#1}}
-\newcommand{\featurelabel}[1]{\marginnote{\framebox{\textsc{#1}}}\label{feat:#1}}
+\newcommand{\featurelabel}[1]{\marginnote{%
+        \framebox{\textsc{#1}}}\label{feat:#1}
+}
 \bibliographystyle{plainurl}
 
+% Some shorthands for the lazy ones.
 \renewcommand{\t}[1]{\texttt{#1}}
 \renewcommand{\i}[1]{\textit{#1}}
 \newcommand{\e}[1]{\emph{#1}}
@@ -73,12 +86,12 @@
 \newboolean{ENABLE-ALL-OPTIONS}
 \newboolean{ENABLE-KDEBUILD}
 
-%%% Enable the below option if you'd like to see both sides of KDEBUILD conditionals shown in
-%%% different colours. Disable it to either fully enable or fully disable KDEBUILD.
-%%% Not compatible with HTML output.
+% Enable the below option if you'd like to see both sides of KDEBUILD
+% conditionals shown in different colours. Disable it to either fully
+% enable or fully disable KDEBUILD.  Not compatible with HTML output.
 \setboolean{ENABLE-ALL-OPTIONS}{false}
 
-%%% Enable the below if you'd like to see KDEBUILD things.
+% Enable the below if you'd like to see KDEBUILD things.
 \setboolean{ENABLE-KDEBUILD}{true}
 
 \ifthenelse{\boolean{ENABLE-ALL-OPTIONS}\and\not\boolean{TEX4HT-HACKS}}
@@ -99,6 +112,8 @@
     }
 }
 
+% Because we are lazy, we define a table environment to fullfil our
+% needs
 \newenvironment{centertable}[1]%
 {
   \begin{table}
@@ -109,6 +124,7 @@
   \end{table}
 }
 
+% Define some PDF meta-data.
 \hypersetup{%
     urlcolor=black,
     colorlinks=true,
@@ -123,10 +139,12 @@
     pdfkeywords={Gentoo, package manager, specification},
     pdfproducer={pdfLaTeX and hyperref},
 }
+% Some metadata needed for the title page generation
 \title{Package Manager Specification}
 \author{Stephen P. Bennett\\\url{spb@exherbo.org} \and Ciaran
     McCreesh\\\url{ciaran.mccreesh@googlemail.com}}
-% Make the build succeed even when no Git repository is available
+% Reads the last commit date from the Git repository and even succeeds
+% when none is available
 \ifthenelse{\equal{\VCDateISO}{}}
 {
     \date{Generated on: \today}
@@ -134,6 +152,7 @@
     \date{\printdate{\VCDateISO}}
 }
 
+% Set page title
 \pagestyle{myheadings}
 \markboth{\scshape Package Manager Specification}{\scshape Package
     Manager Specification}
-- 
1.6.0.6


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.6: 0005-Remove-appendix.sty.patch --]
[-- Type: text/x-patch, Size: 1235 bytes --]

From e1ca8aeccac2b0844d3acf591d0bfd83c57d3757 Mon Sep 17 00:00:00 2001
From: Christian Faulhammer <fauli@gentoo.org>
Date: Wed, 15 Apr 2009 13:57:34 +0200
Subject: [PATCH] Remove appendix.sty

Seems not to be in use.  Move \appendix switch from appendices.tex to
pms.tex main file.
---
 appendices.tex |    2 --
 pms.cls        |    1 -
 pms.tex        |    1 +
 3 files changed, 1 insertions(+), 3 deletions(-)

diff --git a/appendices.tex b/appendices.tex
index be4e94f..82c1109 100644
--- a/appendices.tex
+++ b/appendices.tex
@@ -1,5 +1,3 @@
-\appendix
-
 \chapter{metadata.xml}
 \label{sec:metadata-xml}
 
diff --git a/pms.cls b/pms.cls
index 8fc943f..b046973 100644
--- a/pms.cls
+++ b/pms.cls
@@ -23,7 +23,6 @@
     typearea,	% Set page layout
     caption,	% Extended float environment formatting
     inputenc,	% Allow input methods apart from ASCII
-    appendix,	
     booktabs,	% Nicer formatting of tables
     color,	% Support more than black&white
     enumitem,
diff --git a/pms.tex b/pms.tex
index a1bab85..b7e5c9d 100644
--- a/pms.tex
+++ b/pms.tex
@@ -40,6 +40,7 @@
 
 \include{glossary}
 
+\appendix
 \include{appendices}
 
 \include{eapi-differences}
-- 
1.6.0.6


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.7: 0006-Tweak-Makefile-with-additional-dependency-on-targets.patch --]
[-- Type: text/x-patch, Size: 925 bytes --]

From 9048120e6d4f7da329c790441642b1b8f3c615d1 Mon Sep 17 00:00:00 2001
From: Christian Faulhammer <fauli@gentoo.org>
Date: Wed, 15 Apr 2009 15:08:03 +0200
Subject: [PATCH] Tweak Makefile with additional dependency on targets

---
 Makefile |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Makefile b/Makefile
index b585411..dd23de5 100644
--- a/Makefile
+++ b/Makefile
@@ -28,14 +28,14 @@ pms.html: $(SOURCEFILES) pms.bbl
 	@# align algorithm line numbers properly
 	sed -i -e '/<span class="ALCitem">/{N;s/\n\(class="[^"]\+">\)\([0-9]:\)<\/span>/\1\&#x2007;\2/}' pms.html
 
-pms.bbl: pms.bib pms.tex vc.tex
+pms.bbl: pms.bib pms.tex vc.tex eapi_cheatsheet.pdf
 	latex pms
 	bibtex pms
 
 eapi_cheatsheet.pdf: vc.tex
 	pdflatex cheatsheet/eapi_cheatsheet
 
-vc.tex: pms.tex
+vc.tex: pms.tex vc-git.awk
 	/bin/sh ./vc
 
 pms.dvi: $(SOURCEFILES) pms.bbl
-- 
1.6.0.6


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.8: 0007-Make-email-addresses-clickable.patch --]
[-- Type: text/x-patch, Size: 974 bytes --]

From d9dc7964a91ad377e430d5884a4cf6a6ae90bc78 Mon Sep 17 00:00:00 2001
From: Christian Faulhammer <fauli@gentoo.org>
Date: Wed, 15 Apr 2009 15:16:37 +0200
Subject: [PATCH] Make email addresses clickable

---
 pms.cls |    6 ++++--
 1 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/pms.cls b/pms.cls
index b046973..8a0c0f0 100644
--- a/pms.cls
+++ b/pms.cls
@@ -140,8 +140,10 @@
 }
 % Some metadata needed for the title page generation
 \title{Package Manager Specification}
-\author{Stephen P. Bennett\\\url{spb@exherbo.org} \and Ciaran
-    McCreesh\\\url{ciaran.mccreesh@googlemail.com}}
+\author{Stephen P. Bennett \\
+    \href{mailto:spb@exherbo.org}{spb@exherbo.org} \and Ciaran
+    McCreesh \\
+    \href{mailto:ciaran.mccreesh@googlemail.com}{ciaran.mccreesh@googlemail.com}}
 % Reads the last commit date from the Git repository and even succeeds
 % when none is available
 \ifthenelse{\equal{\VCDateISO}{}}
-- 
1.6.0.6


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.9: 0008-Add-Gentoo-logo-to-desk-reference-and-titlepage-of-P.patch --]
[-- Type: text/x-patch, Size: 17760 bytes --]

From a963ed74f76e04a2ca89ecccd2fe1721cf4bf001 Mon Sep 17 00:00:00 2001
From: Christian Faulhammer <fauli@gentoo.org>
Date: Wed, 15 Apr 2009 17:04:49 +0200
Subject: [PATCH] Add Gentoo logo to desk reference and titlepage of PMS

pms.dvi target thus invalid as it won't process png files
---
 Makefile                       |   16 +-
 cheatsheet/eapi_cheatsheet.tex |    5 +-
 gentoo-logo.svg                |  328 ++++++++++++++++++++++++++++++++++++++++
 pms.cls                        |    3 +-
 4 files changed, 341 insertions(+), 11 deletions(-)
 create mode 100644 gentoo-logo.svg

diff --git a/Makefile b/Makefile
index dd23de5..55e9834 100644
--- a/Makefile
+++ b/Makefile
@@ -9,13 +9,13 @@ LATEXFILES = $(shell find -name '*.tex') pms.cls
 LISTINGFILES = $(shell ls *.listing)
 SOURCEFILES = $(LATEXFILES) $(LISTINGFILES)
 
-pms.pdf: $(SOURCEFILES) pms.bbl vc.tex eapi_cheatsheet.pdf
+pms.pdf: $(SOURCEFILES) pms.bbl vc.tex eapi_cheatsheet.pdf gentoo-logo.png
 	pdflatex pms
 	pdflatex pms
 	pdflatex cheatsheet/eapi_cheatsheet
 	pdflatex pms
 
-pms.html: $(SOURCEFILES) pms.bbl
+pms.html: $(SOURCEFILES) pms.bbl gentoo-logo.png
 	@# need to do it twice to make the big env var table work
 	xhlatex pms
 	xhlatex pms
@@ -28,20 +28,18 @@ pms.html: $(SOURCEFILES) pms.bbl
 	@# align algorithm line numbers properly
 	sed -i -e '/<span class="ALCitem">/{N;s/\n\(class="[^"]\+">\)\([0-9]:\)<\/span>/\1\&#x2007;\2/}' pms.html
 
-pms.bbl: pms.bib pms.tex vc.tex eapi_cheatsheet.pdf
-	latex pms
+pms.bbl: pms.bib pms.tex vc.tex eapi_cheatsheet.pdf gentoo-logo.png
+	pdflatex pms
 	bibtex pms
 
-eapi_cheatsheet.pdf: vc.tex
+eapi_cheatsheet.pdf: vc.tex gentoo-logo.png
 	pdflatex cheatsheet/eapi_cheatsheet
 
 vc.tex: pms.tex vc-git.awk
 	/bin/sh ./vc
 
-pms.dvi: $(SOURCEFILES) pms.bbl
-	latex pms
-	latex pms
-	latex pms
+gentoo-logo.png: gentoo-logo.svg
+	convert gentoo-logo.svg gentoo-logo.png
 
 upload: pms.pdf
 	scp pms.pdf dev.gentoo.org:public_html
diff --git a/cheatsheet/eapi_cheatsheet.tex b/cheatsheet/eapi_cheatsheet.tex
index 278061e..1bbcbab 100644
--- a/cheatsheet/eapi_cheatsheet.tex
+++ b/cheatsheet/eapi_cheatsheet.tex
@@ -9,7 +9,8 @@
     listings,
     ifthen,
     mathptmx,
-    courier
+    courier,
+    graphicx
 }
 \usepackage[orig,english]{isodate}
 \usepackage[scaled=.90]{helvet}
@@ -45,6 +46,8 @@
     pdfkeywords={Gentoo, package manager, reference},
     pdfproducer={pdfLaTeX and hyperref},
 }
+\AddToBackground*{2}{\hspace*{5cm}\includegraphics{gentoo-logo}}
+\AddToBackground*{1}{\hspace*{5cm}\includegraphics{gentoo-logo}}
 \begin{document}
 \maketitle
 \thispagestyle{empty}
diff --git a/gentoo-logo.svg b/gentoo-logo.svg
new file mode 100644
index 0000000..cf7c270
--- /dev/null
+++ b/gentoo-logo.svg
@@ -0,0 +1,328 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://web.resource.org/cc/"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="594.6626"
+   height="622.50458"
+   id="svg2"
+   sodipodi:version="0.32"
+   inkscape:version="0.44"
+   sodipodi:docbase="/home/mike/gentoo-cvs/gentoo/xml/images"
+   sodipodi:docname="gentoo-logo.svg"
+   version="1.0">
+  <defs
+     id="defs4">
+    <linearGradient
+       id="linearGradient2096">
+      <stop
+         style="stop-color:#7e3615;stop-opacity:1.0000000;"
+         offset="0.0000000"
+         id="stop2098" />
+      <stop
+         id="stop2100"
+         offset="0.50000000"
+         style="stop-color:#7e3615;stop-opacity:1.0000000;" />
+      <stop
+         style="stop-color:#ed5b1a;stop-opacity:1.0000000;"
+         offset="1.0000000"
+         id="stop2102" />
+    </linearGradient>
+    <linearGradient
+       id="linearGradient2085">
+      <stop
+         style="stop-color:#7f3615;stop-opacity:1.0000000;"
+         offset="0.0000000"
+         id="stop2087" />
+      <stop
+         id="stop2089"
+         offset="0.50000000"
+         style="stop-color:#ef743d;stop-opacity:1.0000000;" />
+      <stop
+         style="stop-color:#ef743d;stop-opacity:1.0000000;"
+         offset="1.0000000"
+         id="stop2091" />
+    </linearGradient>
+    <linearGradient
+       id="linearGradient2077">
+      <stop
+         id="stop2079"
+         offset="0.0000000"
+         style="stop-color:#ed5b1a;stop-opacity:1.0000000;" />
+      <stop
+         style="stop-color:#ed5b1a;stop-opacity:1.0000000;"
+         offset="0.50000000"
+         id="stop2083" />
+      <stop
+         id="stop2081"
+         offset="1.0000000"
+         style="stop-color:#7e3615;stop-opacity:1.0000000;" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       id="linearGradient3560">
+      <stop
+         style="stop-color:#ffffff;stop-opacity:1;"
+         offset="0"
+         id="stop3562" />
+      <stop
+         style="stop-color:#ffffff;stop-opacity:0;"
+         offset="1"
+         id="stop3564" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       id="linearGradient3539">
+      <stop
+         style="stop-color:#ffffff;stop-opacity:1;"
+         offset="0"
+         id="stop3541" />
+      <stop
+         style="stop-color:#ffffff;stop-opacity:0;"
+         offset="1"
+         id="stop3543" />
+    </linearGradient>
+    <linearGradient
+       id="linearGradient3004">
+      <stop
+         id="stop3006"
+         offset="0"
+         style="stop-color:#ffffff;stop-opacity:1;" />
+      <stop
+         style="stop-color:#ffffff;stop-opacity:1;"
+         offset="0.34214258"
+         id="stop7609" />
+      <stop
+         style="stop-color:#bebdf3;stop-opacity:1;"
+         offset="0.51998252"
+         id="stop7599" />
+      <stop
+         id="stop7611"
+         offset="0.75408828"
+         style="stop-color:#8f82f9;stop-opacity:1;" />
+      <stop
+         style="stop-color:#9f99c7;stop-opacity:1;"
+         offset="0.8711412"
+         id="stop7613" />
+      <stop
+         id="stop3008"
+         offset="1"
+         style="stop-color:#524c76;stop-opacity:1;" />
+    </linearGradient>
+    <linearGradient
+       id="linearGradient2988">
+      <stop
+         style="stop-color:#c9491c;stop-opacity:1.0000000;"
+         offset="0.0000000"
+         id="stop2990" />
+      <stop
+         style="stop-color:#6b2e26;stop-opacity:1.0000000;"
+         offset="1.0000000"
+         id="stop2992" />
+    </linearGradient>
+    <linearGradient
+       id="linearGradient2980">
+      <stop
+         style="stop-color:#e76226;stop-opacity:1.0000000;"
+         offset="0.0000000"
+         id="stop2982" />
+      <stop
+         style="stop-color:#7e3615;stop-opacity:1.0000000;"
+         offset="1.0000000"
+         id="stop2984" />
+    </linearGradient>
+    <linearGradient
+       id="linearGradient2127">
+      <stop
+         style="stop-color:#cc0045;stop-opacity:1.0000000;"
+         offset="0.0000000"
+         id="stop2129" />
+      <stop
+         style="stop-color:#ff794d;stop-opacity:1.0000000;"
+         offset="1.0000000"
+         id="stop2131" />
+    </linearGradient>
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3004"
+       id="linearGradient2986"
+       x1="464.01675"
+       y1="697.43707"
+       x2="368.62137"
+       y2="269.70941"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(1.237124,0,0,1.237124,-161.0905,-377.3414)" />
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3004"
+       id="linearGradient2994"
+       x1="783.86316"
+       y1="-313.5238"
+       x2="1099.6853"
+       y2="1340.5599"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(1.237124,0,0,1.237124,-1037.425,-1010.413)" />
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3004"
+       id="linearGradient2786"
+       gradientUnits="userSpaceOnUse"
+       x1="142.8909"
+       y1="560.31262"
+       x2="305.19791"
+       y2="560.31262" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3004"
+       id="radialGradient2788"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(-2.182864e-2,-1.020879,1.918033,-4.101524e-2,-759.031,896.8714)"
+       cx="298.04648"
+       cy="512.46417"
+       fx="298.04648"
+       fy="512.46417"
+       r="218.02184" />
+    <linearGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3004"
+       id="linearGradient2801"
+       gradientUnits="userSpaceOnUse"
+       x1="34.285702"
+       y1="185.21933"
+       x2="-32.857155"
+       y2="205.21933"
+       gradientTransform="matrix(0.413051,0,0,0.413051,209.7551,299.5351)" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3539"
+       id="radialGradient3553"
+       cx="278.19101"
+       cy="365.99103"
+       fx="278.19101"
+       fy="365.99103"
+       r="22.023195"
+       gradientTransform="matrix(-1.335307,0.232165,-0.156016,-0.897333,707.4359,624.6685)"
+       gradientUnits="userSpaceOnUse" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3560"
+       id="radialGradient3566"
+       cx="281.96429"
+       cy="374.32648"
+       fx="281.96429"
+       fy="374.32648"
+       r="30.535715"
+       gradientTransform="matrix(1.586984,6.491459e-2,-3.791318e-3,0.906694,-164.0892,16.62349)"
+       gradientUnits="userSpaceOnUse" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient2085"
+       id="radialGradient2075"
+       cx="616.66583"
+       cy="357.7851"
+       fx="616.66583"
+       fy="357.7851"
+       r="77.994896"
+       gradientTransform="matrix(-0.784367,2.082605,-1.36893,-0.515577,1619.589,-726.3586)"
+       gradientUnits="userSpaceOnUse" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3004"
+       id="radialGradient3228"
+       gradientUnits="userSpaceOnUse"
+       gradientTransform="matrix(-6.60395e-2,4.190266,-3.573754,-5.626827e-2,2168.154,-1171.421)"
+       cx="332.72311"
+       cy="590.5899"
+       fx="332.72311"
+       fy="590.5899"
+       r="218.02184" />
+    <radialGradient
+       inkscape:collect="always"
+       xlink:href="#linearGradient3004"
+       id="radialGradient5851"
+       cx="49.529819"
+       cy="320.08572"
+       fx="49.529819"
+       fy="320.08572"
+       r="31.94874"
+       gradientTransform="matrix(3.287367,0,0,2.519654,111.6891,-642.7214)"
+       gradientUnits="userSpaceOnUse" />
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1"
+     inkscape:cx="341.56282"
+     inkscape:cy="336.08702"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer4"
+     inkscape:window-width="1024"
+     inkscape:window-height="719"
+     inkscape:window-x="0"
+     inkscape:window-y="27" />
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:groupmode="layer"
+     id="layer2"
+     inkscape:label="back"
+     style="display:inline"
+     sodipodi:insensitive="true"
+     transform="translate(-25.69105,-25.5213)">
+    <path
+       id="path2973"
+       style="opacity:1;fill:url(#linearGradient2994);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1"
+       d="M 25.756851,521.91391 C 25.825031,495.65357 48.148853,458.98977 79.868697,425.68116 C 101.06675,403.42137 122.59556,383.88231 169.52585,343.86782 C 137.06358,326.05537 86.575337,304.5643 61.242464,276.41883 C 51.868932,266.00461 34.879101,242.4107 38.174477,210.88878 C 44.890902,146.64282 124.18914,49.142619 236.90525,28.529375 C 274.4094,21.670714 317.46879,26.621594 352.90796,42.554294 C 464.08832,92.538537 600.05593,216.71656 616.78506,277.34922 C 622.67343,298.69087 621.54162,332.70947 611.39031,351.66904 C 598.8089,375.16727 555.25451,422.89399 495.66547,472.14219 C 402.16607,549.41609 271.14445,632.39066 173.31256,646.35271 C 141.70156,650.86406 109.40481,646.15872 86.740094,633.36993 C 51.279241,613.36083 39.508186,586.6468 35.370326,578.63961 C 24.367104,557.34729 25.73287,530.37254 25.756851,521.91391 z M 288.89937,226.87362 C 290.10675,211.9842 348.49263,226.80785 344.80352,238.59909 C 340.91155,251.03875 287.51426,243.95446 288.89937,226.87362 z "
+       sodipodi:nodetypes="cscssssssssssscss" />
+  </g>
+  <g
+     inkscape:groupmode="layer"
+     id="layer4"
+     inkscape:label="mid"
+     style="display:inline"
+     sodipodi:insensitive="true"
+     transform="translate(-25.69105,-25.5213)">
+    <path
+       id="path2975"
+       style="opacity:1;fill:url(#linearGradient2986);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 201.12502,319.26488 C 170.40092,345.206 149.97273,362.69737 124.3619,386.10521 C 62.686019,442.47585 20.779962,485.38384 42.384986,544.03745 C 67.307886,611.6985 121.94112,608.26771 186.00654,595.69143 C 351.14346,563.12161 622.59855,354.43165 608.76251,277.34931 C 597.56708,214.97818 445.90819,90.975251 356.11423,46.84913 C 328.062,33.063819 295.73224,25.934162 263.30502,27.459889 C 139.83437,33.287522 43.410732,145.70192 48.3364,206.6102 C 53.12843,265.866 202.89233,317.49757 201.12502,319.26488 z M 182.59146,112.40184 C 145.4382,153.73813 169.19273,233.71314 230.80632,277.3046 C 302.90158,328.31181 419.65062,337.54732 442.88372,298.21016 C 486.21887,224.83738 438.90343,147.25466 368.27318,112.64681 C 298.47778,78.448086 205.75091,86.63492 182.59146,112.40184 z "
+       sodipodi:nodetypes="csssssssccssss" />
+    <path
+       id="path4976"
+       style="opacity:1;fill:url(#radialGradient5851);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;display:inline"
+       d="M 309.29559,275.57053 C 361.45453,282.82047 406.41278,261.93195 413.44309,210.42711 C 418.79846,171.19341 358.75371,128.32717 322.65314,118.4403 C 292.50683,110.18416 227.05767,120.80064 222.64536,177.81809 C 218.05858,237.09011 278.88214,271.34317 309.29559,275.57053 z M 283.75291,176.98953 C 249.47413,230.09349 333.52318,246.4198 346.39128,236.73513 C 401.86836,194.98252 298.85531,153.59322 283.75291,176.98953 z "
+       sodipodi:nodetypes="csssscss" />
+  </g>
+  <g
+     inkscape:groupmode="layer"
+     id="layer5"
+     inkscape:label="top"
+     style="display:inline"
+     sodipodi:insensitive="true"
+     transform="translate(-25.69105,-25.5213)">
+    <path
+       style="opacity:1;fill:url(#radialGradient3228);fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       d="M 253.35285,41.570018 C 192.71898,47.959829 181.10644,55.76371 126.17687,97.322591 C 107.767,111.25125 73.883463,145.14202 65.201668,185.34831 C 61.895163,200.66106 65.803612,213.8809 76.831852,223.15243 C 112.14485,252.84039 171.24791,276.92638 219.73633,300.20947 C 233.93865,307.02911 224.53507,319.39451 201.63241,339.22199 C 143.84068,389.25385 65.705469,450.15645 60.25071,496.56402 C 57.680295,518.43239 65.166835,548.14722 91.710107,563.35382 C 122.71683,581.11751 187.08224,569.52337 230.06148,553.51882 C 292.86747,530.1312 375.36929,478.51514 440.86776,427.77778 C 508.97789,375.01736 572.3054,308.00452 575.43793,297.07484 C 579.28461,283.65337 578.90118,271.25689 571.47758,257.00416 C 559.81983,234.62227 544.23417,217.99109 527.49924,199.37578 C 482.59667,152.03725 435.087,110.44129 378.2447,78.565883 C 337.19672,55.547464 301.08129,36.540217 253.35285,41.570018 z M 342.42072,147.69946 C 386.22586,168.87809 431.21043,224.50639 342.03037,256.52426 C 317.78022,265.23068 240.87245,235.14204 243.22679,194.08046 C 246.65995,133.42478 288.93402,121.84005 342.42072,147.69946 z "
+       id="path2977"
+       sodipodi:nodetypes="cssssssssssscsscsss" />
+  </g>
+</svg>
diff --git a/pms.cls b/pms.cls
index 8a0c0f0..b767685 100644
--- a/pms.cls
+++ b/pms.cls
@@ -139,7 +139,8 @@
     pdfproducer={pdfLaTeX and hyperref},
 }
 % Some metadata needed for the title page generation
-\title{Package Manager Specification}
+\title{Package Manager
+    Specification\\\includegraphics[height=5ex,keepaspectratio]{gentoo-logo}}
 \author{Stephen P. Bennett \\
     \href{mailto:spb@exherbo.org}{spb@exherbo.org} \and Ciaran
     McCreesh \\
-- 
1.6.0.6


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 198 bytes --]