summaryrefslogtreecommitdiff
Commit message (Collapse)AuthorAgeFilesLines
* Use sentence case throughoutUlrich Müller2024-05-081-8/+8
| | | | | | | | | | | | Subsection headings were already changed from title case to sentence case in commit ca463ce. This left chapter and section headings alone, which is inconsistent (although it is specified by some style guides like APA). This commit changes headings to sentence case throughout, following most other Gentoo documentation, e.g. wiki and devmanual. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tree-layout.tex: Plural use of "data" is preferred in BEUlrich Müller2024-02-221-1/+1
| | | | | | | | https://digitalblog.ons.gov.uk/2016/12/08/data-is-versus-data-are/ This also fixes an "underfull \hbox" error. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tree-layout.tex: Loosen restrictions on reusing package and slot namesUlrich Müller2024-01-271-3/+3
| | | | | Closes: https://bugs.gentoo.org/923019 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* pms.bib: Use @techreport entry type for GLEPsUlrich Müller2023-05-291-1/+1
| | | | | | | This is a slightly better fit than @manual. Also, change citation keys to lowercase. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Use "app:" instead of "ch:" for labels in the appendixUlrich Müller2022-12-271-2/+2
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* EAPI 8 has less strict naming rules in the updates directoryUlrich Müller2021-06-051-4/+21
| | | | | Bug: https://bugs.gentoo.org/692774 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Add an EAPI 8 identical to EAPI 7Ulrich Müller2021-06-051-2/+2
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Clarify that updates files are processed in no particular orderUlrich Müller2021-05-231-0/+3
| | | | | Bug: https://bugs.gentoo.org/296713#c14 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Fix bad page breaks before listsUlrich Müller2021-05-211-1/+3
| | | | | | Taken from https://tex.stackexchange.com/a/2645. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* pms.cls: Do not define \e for \emphUlrich Müller2021-04-301-2/+2
| | | | | | | | This is only used a few times, so a shorthand is not needed. (We really should get rid of \i and \t as well, because redefining LaTeX internal commands sucks.) Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* pms.bib: Add GLEP 74 to bibliography.Ulrich Müller2019-11-061-1/+1
| | | | | | | GLEP 74 has replaced GLEP 44, so use it as reference for the Manifest file. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tree-layout.tex: Typographic fix.Ulrich Müller2019-08-241-1/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Refer to chapters as chapters.Ulrich Müller2019-03-241-21/+17
| | | | | | | Also rename label prefixes, "ch:" for chapters, "sec:" for sections, as suggested by Michael Orlitzky. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Fix whitespace in list items.Ulrich Müller2018-08-121-3/+3
|
* EAPI 7 supports a directory for package.mask.Ulrich Müller2018-03-301-0/+20
| | | | Bug: https://bugs.gentoo.org/282296
* metadata-cache: Fix section label.Ulrich Müller2017-10-121-1/+1
|
* Use simple underscores throughout.Ulrich Müller2017-05-151-6/+6
| | | | | Replacement was done using "sed -i 's/\\_/_/g' *.tex". This does not change the resulting PDF and HTML output.
* tree-layout.tex: Clarify that empty Manifest files can be omitted.Ulrich Müller2016-09-131-1/+2
| | | | | | With thin manifests the file can end up empty (e.g., if the package contains only live ebuilds). Current practice is to leave such empty files out.
* tree-layout.tex: Remove item list of ebuild file name components.Ulrich Müller2016-09-131-9/+3
| | | | | This was another leftover of the kdebuild-1 conditionals, see commit 51ad24e7c6eab928eabe4aedeba18946d76363dd.
* Clarify that eapi in profiles is not inherited in subdirectories.Ulrich Müller2015-08-271-1/+1
| | | | See also bug 558956.
* Use the same line width for Emacs and Vim.Ulrich Müller2015-04-111-0/+1
| | | | | | Lines seem to be wrapped at 100 characters throughout, with the exception of eapi-cheatsheet.tex which is wrapped at 70 characters. Assign the "fill-column" file local variable for Emacs accordingly.
* Typographic fixes to make chktex happier.Ulrich Müller2015-03-241-5/+5
|
* Tune LaTeX formatting to suppress overfull boxes in output.Ulrich Müller2012-09-161-3/+4
| | | | | | | | | | | | | | - Change teletype font from Courier to Computer Modern Typewriter which is narrower. - Be more tolerant when formatting paragraphs, to avoid overfull boxes. Do this by increasing \tolerance, \hfuzz, and \emergencystretch. - Allow line breaks after underscores (but with a large penalty). - The second column of the "defined variables" table was too narrow. - Increase the width of margin notes to 40 mm (was about 33 mm before). - Rename the two longest featurelabels (profile-iuse-injection and controllable-compress) because they still didn't fit into the margin. - I'd rather have avoided explicit \allowbreak commands, but in very few cases there is no other way.
* Distinguish between \e and \i.Ulrich Mueller2011-01-301-2/+2
| | | | Section "Conventions" says that \i should be used for technical terms.
* Spelling corrections.Ulrich Mueller2010-09-191-1/+1
|
* Remove conditionals for kdebuild-1.Ulrich Mueller2010-01-101-7/+1
| | | | Signed-off-by: Ulrich Mueller <ulm@gentoo.org>
* Expand Emacs local variablesChristian Faulhammer2009-04-231-0/+4
| | | | | | Set indentation level to 4 Fix some cosmetic spacing issues Add missing local variables list
* Move metadata cache into its own chapter.Ciaran McCreesh2009-04-231-38/+2
| | | | Also clarify that the cache can contain bogus entries or be incomplete.
* Reference EAPI features by name, not section.Ciaran McCreesh2009-04-231-1/+2
|
* PROPERTIES, DEFINED_PHASES mandatory in EAPI 3Ciaran McCreesh2009-04-111-2/+4
|
* Add prefixes to labels.Christian Faulhammer2009-02-201-29/+29
|
* Profiles eapi file.Ciaran McCreesh2009-01-141-3/+9
| | | | See Council meeting on 20081211.
* Add DEFINED_PHASES.Ciaran McCreesh2009-01-141-0/+1
| | | | See Council meeting on 20081211.
* Document PROPERTIES, interactive property.Ciaran McCreesh2008-09-251-0/+1
|
* Add appendices showing EAPI changes.Ciaran McCreesh2008-09-141-2/+2
|
* Optionally include kdebuild-1 documentation.Ciaran McCreesh2008-03-191-3/+14
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | kdebuild-1 is a new EAPI requested by the Gentoo KDE project for use in their overlay. Having documentation of this format is useful for package manager writers and kdebuild-1 ebuild authors, but we may or may not want to include it in the PMS copy we'll submit to the Council. So we have options in pms.tex to enable or disable inclusion -- edit the value of the ENABLE-KDEBUILD boolean as appropriate (for now it's on by default). We also have an option to show what PMS looks like both with and without ENABLE-KDEBUILD, by showing both sides of conditionals in different colours. This is the ENABLE-ALL-OPTIONS boolean, which is also enabled by default. Squashed commit of the following: commit 137e55e3a2712e5b1f9cbb5d168634ca68b2dbe9 Author: Ciaran McCreesh <ciaran.mccreesh@googlemail.com> Date: Tue Mar 18 07:24:14 2008 +0000 Wording tweak commit dcd912651f6d0bda15631ec3f16a306740decebc Author: Ciaran McCreesh <ciaran.mccreesh@googlemail.com> Date: Tue Mar 18 06:56:25 2008 +0000 Rewrite the "no magic mkdir" rules. The ban on magic mkdir voodoo gets really messy definition-wise if it's put on 'into', since we don't want it to apply where the package manager is explicit. Reword it so that it just bans on explicit utilities. commit e39c9d23614a37c3cd6f7e336598f27712cd4b0a Author: Ciaran McCreesh <ciaran.mccreesh@googlemail.com> Date: Tue Mar 18 06:22:12 2008 +0000 Optionally include kdebuild-1 documentation.
* Fix references to metadata/cache EAPI line number.Richard Brown2008-03-181-2/+2
|
* Change "confusing" wording about category directories.Richard Brown2008-03-181-3/+3
|
* stable|dev is too restrictiveCiaran McCreesh2008-03-161-7/+16
|
* Zero or more ebuilds, not one or more ebuilds.Ciaran McCreesh2008-03-161-1/+1
|
* Use compactenum rather than enumerateCiaran McCreesh2008-03-161-2/+2
|
* Make non-breakable space in front of references...keeps the layout tidy Some ↵Christian Faulhammer2008-03-161-28/+33
| | | | reformatting caused by these changes
* Make it usable for Emacs, tooChristian Faulhammer2008-03-161-0/+5
|
* exchange bulletlist with compactitem in all filesChristian Faulhammer2008-03-161-6/+6
|
* EAPI in flat cache files needs special treatmentCiaran McCreesh2008-02-191-0/+6
|
* Reusing updated things is not allowedCiaran McCreesh2008-02-191-0/+3
|
* mirror://gentoo/ is speshulCiaran McCreesh2008-02-191-0/+3
|
* Package managers may subset and reorder mirrorsCiaran McCreesh2008-02-191-1/+3
|
* Clarify that paths may appear in mirror:// URIsCiaran McCreesh2008-02-191-4/+4
|
* mirror:// mapping to mirror:// is undefinedCiaran McCreesh2008-02-191-1/+1
|