From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1Lu71d-0005pp-0t for garchives@archives.gentoo.org; Wed, 15 Apr 2009 15:27:46 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id E5749E06BA; Wed, 15 Apr 2009 15:27:43 +0000 (UTC) Received: from mo-p05-ob.rzone.de (mo-p05-ob.rzone.de [81.169.146.182]) by pigeon.gentoo.org (Postfix) with ESMTP id 020FFE06BA for ; Wed, 15 Apr 2009 15:27:42 +0000 (UTC) X-RZG-AUTH: :K2kKYU+nW/MMMlTokcN5Yot1/Bj/FTl+WviP6RIJci0HRMpbh/x+X6ShOQvVOjw+sRFUfkIHJ9TO X-RZG-CLASS-ID: mo05 Received: from terra.solaris (p57A4EFCD.dip.t-dialin.net [87.164.239.205]) by post.strato.de (mrclete mo13) (RZmta 18.28) with ESMTP id y00923l3FF0viM ; Wed, 15 Apr 2009 17:27:37 +0200 (MEST) Date: Wed, 15 Apr 2009 17:28:01 +0200 From: Christian Faulhammer To: Ciaran McCreesh Cc: gentoo-pms@lists.gentoo.org Subject: Re: [gentoo-pms] Patches for your reviewing pleasure: Various improvements, including cheat sheet Message-ID: <20090415172801.382456e0@terra.solaris> In-Reply-To: <20090414154657.37fb5ad8@snowcone> References: <20090412211447.536a297a@terra.solaris> <20090412203624.79ae97c3@snowmobile> <20090413110148.17d9cd5f@terra.solaris> <20090413170143.31087b9c@snowcone> <20090414104448.20153bfb@terra.solaris> <20090414140423.27055b57@snowcone> <20090414155543.16e78e66@terra.solaris> <20090414154657.37fb5ad8@snowcone> X-Mailer: Claws Mail 3.7.1 (GTK+ 2.14.7; i686-pc-linux-gnu) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Package Manager Specification discussions X-BeenThere: gentoo-pms@gentoo.org X-BeenThere: gentoo-pms@lists.gentoo.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="Sig_/17/WKRxOwHMHlta0DIO5gai"; protocol="application/pgp-signature"; micalg=PGP-SHA1 X-Archives-Salt: d6452f81-4be7-4e58-b622-29dc32a95530 X-Archives-Hash: 7f9b2f4a15d186c68b2d439c8e257249 --Sig_/17/WKRxOwHMHlta0DIO5gai Content-Type: multipart/mixed; boundary="MP_/n1VWa+oGSvXIQxKn0GPP/3+" --MP_/n1VWa+oGSvXIQxKn0GPP/3+ Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable Content-Disposition: inline Hi, Ciaran McCreesh : [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. >=20 > 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. =20 >=20 > has trailing whitespace. Git moans about this. Fixed. =20 > > + Please report mistakes or enhancements to this document via the >=20 > should read "mistakes in or enhancements to" >=20 > > +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. >=20 > 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. >=20 > > + disabled explicitely by user configuration) with a \code{+} sign > > in >=20 > Spelling of 'explicitly'. >=20 > > +\item[Named slot dependencies] Dependencies can explicitely > > request a >=20 > Ditto. >=20 > > +\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}. >=20 > Not sure on this wording. How about something like: >=20 > SRC_URI=3D"http://some/url -> foo" can be used to use foo as the > filename for downloads. >=20 > > +\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. >=20 > 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. >=20 > > + Patching and other preparing tasks must no longer take place in > > + \code{src\_unpack} but in \code{src\_prepare}. >=20 > Patching and similar preparation must now be done in src_prepare, > not src_unpack. >=20 > > + 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. >=20 > so duplicating the standard implementation is no longer necessary. > The default function calls the current phase's default_ function > automatically. >=20 > > + Duplicating checks from the \code{pkg\_setup} phase may be > > + necessary. >=20 > Most checks should usually be repeated in pkg_setup. >=20 > > + phase can be called even for non-installed packages. Do not > > depend > > + on any outside programs in that case! See \featureref{pkg-info}. >=20 > Be warned that dependencies might not have been installed. >=20 > > +\item[Slot operators] There are two ways to define a wanted slot > > in a > > + dependency string: >=20 > Dependencies that are both DEPEND and RDEPEND and that can match > multiple slots should specify one of: >=20 > > +\item[USE dependency defaults] Additionally to the features > > offered in >=20 > In addition to the ... >=20 > > + after a USE flag (mind the braces). >=20 > Braces are {}. You want brackets or parentheses. >=20 > > 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 >=20 > The former specifies that flags not in IUSE should be treated as > enabled; the latter, disabled. Cannot be used with USE_EXPAND > flags. >=20 > > + \code{/usr/share\{doc,info,man\}} are compressed on-disk after >=20 > s/are/may be >=20 > > + 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}. >=20 > docompress path ... adds paths to the inclusion list for > compression. docompress -x path ... adds paths to the exclusion > list. >=20 > > + files respectively in the known manner. >=20 > "in the known manner" sounds weird. >=20 > > + command given as argument will not abort the build process in > > case > > + of a failure but preserve the exit status nonetheless. See >=20 > I'd mention that commands die on error before this. And then: >=20 > will return non-zero on failure rather than aborting the build. >=20 > > +\item[USE flags in any-of] Inside of \code{||} constructs USE flag > > + conditionals are forbidden (with exceptions). >=20 > use? ( ) blocks are forbidden as direct children of || ( ) blocks. >=20 > > + anymore. >=20 > '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 --=20 Christian Faulhammer, Gentoo Lisp project , #gentoo-lisp on FreeNode --MP_/n1VWa+oGSvXIQxKn0GPP/3+ Content-Type: text/x-patch Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename=0001-Desk-reference-for-quick-look-up.patch =46rom 39d589249a093170434df2a6185dbace3fd1221c Mon Sep 17 00:00:00 2001 From: Christian Faulhammer 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 =20 -LATEXFILES =3D $(shell ls *.tex) pms.cls +LATEXFILES =3D $(shell find -name '*.tex') pms.cls LISTINGFILES =3D $(shell ls *.listing) SOURCEFILES =3D $(LATEXFILES) $(LISTINGFILES) =20 -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 =20 pms.html: $(SOURCEFILES) pms.bbl @@ -31,6 +32,9 @@ pms.bbl: pms.bib pms.tex vc.tex latex pms bibtex pms =20 +eapi_cheatsheet.pdf: vc.tex + pdflatex cheatsheet/eapi_cheatsheet + vc.tex: pms.tex /bin/sh ./vc =20 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=3D.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=3Dblack, + colorlinks=3Dtrue, + citecolor=3Dblack, + linkcolor=3Dblack, + pdftitle=3D{EAPI Desk Reference}, + pdfauthor=3D{Christian Faulhammer}, + pdfsubject=3D{Making look-up faster for EAPI features}, + pdflang=3D{en}, + pdfkeywords=3D{Gentoo, package manager, reference}, + pdfproducer=3D{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=3D"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=3D]}] The flag must be enabled if the flag is + enabled for the package with the dependency, or disabled + otherwise. + \item[{[!opt=3D]}] 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=3DDEPEND} 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{:=3D}] 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=3Dtex fileencoding=3Dutf8 et tw=3D100 spell spelllang= =3Den : + +%%% 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=C3=A4ty (environment state, section~\ref{sec:ebuild-env-state}) = for contributions. Thanks to -Christian Faulhammer for fixing some of the more horrible formatting screw= ups. Thanks also to Mike -Frysinger and Brian Harring for proof-reading and suggestions for fixes an= d/or clarification. +Christian Faulhammer for fixing some of the more horrible formatting screw= ups and providing the EAPI +cheat sheet. Thanks also to Mike Frysinger and Brian Harring for proof-rea= ding and suggestions for +fixes and/or clarification. =20 \section*{Copyright and Licence} =20 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 @@ =20 \bibliography{pms} =20 +\includepdf[pages=3D-,landscape]{eapi_cheatsheet} + \end{document} =20 % vim: set filetype=3Dtex fileencoding=3Dutf8 et tw=3D100 spell spelllang= =3Den : --=20 1.6.0.6 --MP_/n1VWa+oGSvXIQxKn0GPP/3+ Content-Type: text/x-patch Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename=0002-Expand-Emacs-local-variables.patch =46rom 603f19e4fbdc913d6ec191ab9629dd1610adc7f5 Mon Sep 17 00:00:00 2001 From: Christian Faulhammer 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 b= e 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 =20 % vim: set filetype=3Dtex fileencoding=3Dutf8 et tw=3D100 spell spelllang= =3Den : =20 - %%% 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 specifi= cation 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 ar= e mandated: =20 % vim: set filetype=3Dtex fileencoding=3Dutf8 et tw=3D100 spell spelllang= =3Den : =20 - %%% 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. =20 \end{description} =20 - % vim: set filetype=3Dtex fileencoding=3Dutf8 et tw=3D100 spell spelllang= =3Den : =20 %%% 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 w= ith 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 f= ile (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} =20 % vim: set filetype=3Dtex fileencoding=3Dutf8 et tw=3D100 spell spelllang= =3Den : + +%%% 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 @@ =20 % vim: set filetype=3Dtex fileencoding=3Dutf8 et tw=3D100 spell spelllang= =3Den : =20 - %%% 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 m= anager. %%% 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 no= t 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 reposito= ry timestamps. =20 The \t{metadata/cache} directory may contain a cached form of all importan= t ebuild metadata variables. The contents of this directory are described in section~\ref{me= tadata-cache}. + % vim: set filetype=3Dtex fileencoding=3Dutf8 et tw=3D100 spell spelllang= =3Den : =20 %%% 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 docume= nted 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: --=20 1.6.0.6 --MP_/n1VWa+oGSvXIQxKn0GPP/3+ Content-Type: text/x-patch Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename=0003-Change-intendation-to-4-spaces.patch =46rom e584fa958309219424175231c13ed75e63a80df5 Mon Sep 17 00:00:00 2001 From: Christian Faulhammer 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} =20 \newboolean{TEX4HT-HACKS} @@ -110,33 +110,33 @@ } =20 \hypersetup{% - urlcolor=3Dblack, - colorlinks=3Dtrue, - citecolor=3Dblack, - linkcolor=3Dblack, - pdftitle=3D{Package Manager Specification}, - pdfauthor=3D{Stephen P. Bennett, Ciaran McCreesh}, - pdfcreator=3D{pdfLaTeX and hyperref}, - pdfsubject=3D{Defining a feature set for package managers in the - Gentoo world}, - pdflang=3D{en}, - pdfkeywords=3D{Gentoo, package manager, specification}, - pdfproducer=3D{pdfLaTeX and hyperref}, + urlcolor=3Dblack, + colorlinks=3Dtrue, + citecolor=3Dblack, + linkcolor=3Dblack, + pdftitle=3D{Package Manager Specification}, + pdfauthor=3D{Stephen P. Bennett, Ciaran McCreesh}, + pdfcreator=3D{pdfLaTeX and hyperref}, + pdfsubject=3D{Defining a feature set for package managers in the + Gentoo world}, + pdflang=3D{en}, + pdfkeywords=3D{Gentoo, package manager, specification}, + pdfproducer=3D{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}} } =20 \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. --=20 1.6.0.6 --MP_/n1VWa+oGSvXIQxKn0GPP/3+ Content-Type: text/x-patch Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename=0004-Comment-class-file-a-bit-more-for-beginner.patch =46rom 79d6b8f71f6b205576a37144aabb703338d70cd1 Mon Sep 17 00:00:00 2001 From: Christian Faulhammer 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=3Dtop}{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,=09 + 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} =20 +% 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{fe= at:#1}} +\newcommand{\featurelabel}[1]{\marginnote{% + \framebox{\textsc{#1}}}\label{feat:#1} +} \bibliographystyle{plainurl} =20 +% 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} =20 -%%% Enable the below option if you'd like to see both sides of KDEBUILD co= nditionals 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} =20 -%%% 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} =20 \ifthenelse{\boolean{ENABLE-ALL-OPTIONS}\and\not\boolean{TEX4HT-HACKS}} @@ -99,6 +112,8 @@ } } =20 +% Because we are lazy, we define a table environment to fullfil our +% needs \newenvironment{centertable}[1]% { \begin{table} @@ -109,6 +124,7 @@ \end{table} } =20 +% Define some PDF meta-data. \hypersetup{% urlcolor=3Dblack, colorlinks=3Dtrue, @@ -123,10 +139,12 @@ pdfkeywords=3D{Gentoo, package manager, specification}, pdfproducer=3D{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}} } =20 +% Set page title \pagestyle{myheadings} \markboth{\scshape Package Manager Specification}{\scshape Package Manager Specification} --=20 1.6.0.6 --MP_/n1VWa+oGSvXIQxKn0GPP/3+ Content-Type: text/x-patch Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename=0005-Remove-appendix.sty.patch =46rom e1ca8aeccac2b0844d3acf591d0bfd83c57d3757 Mon Sep 17 00:00:00 2001 From: Christian Faulhammer 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} =20 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,=09 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 @@ =20 \include{glossary} =20 +\appendix \include{appendices} =20 \include{eapi-differences} --=20 1.6.0.6 --MP_/n1VWa+oGSvXIQxKn0GPP/3+ Content-Type: text/x-patch Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename=0006-Tweak-Makefile-with-additional-dependency-on-targets.patch =46rom 9048120e6d4f7da329c790441642b1b8f3c615d1 Mon Sep 17 00:00:00 2001 From: Christian Faulhammer 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 '//{N;s/\n\(class=3D"[^"]\+">\)\([0-9]:= \)<\/span>/\1\ \2/}' pms.html =20 -pms.bbl: pms.bib pms.tex vc.tex +pms.bbl: pms.bib pms.tex vc.tex eapi_cheatsheet.pdf latex pms bibtex pms =20 eapi_cheatsheet.pdf: vc.tex pdflatex cheatsheet/eapi_cheatsheet =20 -vc.tex: pms.tex +vc.tex: pms.tex vc-git.awk /bin/sh ./vc =20 pms.dvi: $(SOURCEFILES) pms.bbl --=20 1.6.0.6 --MP_/n1VWa+oGSvXIQxKn0GPP/3+ Content-Type: text/x-patch Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename=0007-Make-email-addresses-clickable.patch =46rom d9dc7964a91ad377e430d5884a4cf6a6ae90bc78 Mon Sep 17 00:00:00 2001 From: Christian Faulhammer 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@googlemai= l.com}} % Reads the last commit date from the Git repository and even succeeds % when none is available \ifthenelse{\equal{\VCDateISO}{}} --=20 1.6.0.6 --MP_/n1VWa+oGSvXIQxKn0GPP/3+ Content-Type: text/x-patch Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename=0008-Add-Gentoo-logo-to-desk-reference-and-titlepage-of-P.patch =46rom a963ed74f76e04a2ca89ecccd2fe1721cf4bf001 Mon Sep 17 00:00:00 2001 From: Christian Faulhammer 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 =3D $(shell find -name '*.tex') pms.cls LISTINGFILES =3D $(shell ls *.listing) SOURCEFILES =3D $(LATEXFILES) $(LISTINGFILES) =20 -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 =20 -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 '//{N;s/\n\(class=3D"[^"]\+">\)\([0-9]:= \)<\/span>/\1\ \2/}' pms.html =20 -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 =20 -eapi_cheatsheet.pdf: vc.tex +eapi_cheatsheet.pdf: vc.tex gentoo-logo.png pdflatex cheatsheet/eapi_cheatsheet =20 vc.tex: pms.tex vc-git.awk /bin/sh ./vc =20 -pms.dvi: $(SOURCEFILES) pms.bbl - latex pms - latex pms - latex pms +gentoo-logo.png: gentoo-logo.svg + convert gentoo-logo.svg gentoo-logo.png =20 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=3D.90]{helvet} @@ -45,6 +46,8 @@ pdfkeywords=3D{Gentoo, package manager, reference}, pdfproducer=3D{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 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + diff --git a/pms.cls b/pms.cls index 8a0c0f0..b767685 100644 --- a/pms.cls +++ b/pms.cls @@ -139,7 +139,8 @@ pdfproducer=3D{pdfLaTeX and hyperref}, } % Some metadata needed for the title page generation -\title{Package Manager Specification} +\title{Package Manager + Specification\\\includegraphics[height=3D5ex,keepaspectratio]{gentoo-l= ogo}} \author{Stephen P. Bennett \\ \href{mailto:spb@exherbo.org}{spb@exherbo.org} \and Ciaran McCreesh \\ --=20 1.6.0.6 --MP_/n1VWa+oGSvXIQxKn0GPP/3+-- --Sig_/17/WKRxOwHMHlta0DIO5gai Content-Type: application/pgp-signature; name=signature.asc Content-Disposition: attachment; filename=signature.asc -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.10 (GNU/Linux) iEYEARECAAYFAknl/QoACgkQNQqtfCuFneM0VwCfXQJE9zfGlOlcGMwCZ7s6yHNa 2YQAnRS2e5fPCQF4ul3YZ6XTZJDSqK25 =uc1/ -----END PGP SIGNATURE----- --Sig_/17/WKRxOwHMHlta0DIO5gai--