summaryrefslogtreecommitdiff
Commit message (Collapse)AuthorAgeFilesLines
* Use sentence case throughoutUlrich Müller2024-05-081-3/+3
| | | | | | | | | | | | 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>
* Distinguish between "phase" and "phase function"Ulrich Müller2023-01-181-3/+3
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* WhitespaceUlrich Müller2023-01-181-2/+3
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* EAPI 8: Default src_prepare doesn't accept options in PATCHESUlrich Müller2021-06-051-3/+18
| | | | | | | | Also simplify array detection by using the @a operator in parameter expansion. This feature was introduced in bash-4.4. Bug: https://bugs.gentoo.org/752486 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Rearrange listings of phase functionsUlrich Müller2021-06-051-87/+77
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* EAPI 8 has an empty working directory in pkg_* phasesUlrich Müller2021-06-051-5/+21
| | | | | https://bugs.gentoo.org/595030 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Add an EAPI 8 identical to EAPI 7Ulrich Müller2021-06-051-21/+21
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Fix bad page breaks before listsUlrich Müller2021-05-211-1/+1
| | | | | | 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-1/+1
| | | | | | | | 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>
* ebuild-functions.tex: Phase functions can write to temporary dirs.Ulrich Müller2020-07-051-5/+6
| | | | | | | | All package managers support that functions like pkg_pretend() write to temporary directories T, TMPDIR and HOME. This is also used in the tree, see for example bug 469210. Update the spec to match this. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-functions.tex: Update array detection code.Ulrich Müller2020-02-151-4/+4
| | | | | | | | | | | | | | | | | Remove the space after "declare -a" for matching "declare -p" output. With the update of the bash version to 4.2 in EAPI 6, variables can have other attributes in addition, which would make the test fail. For example, see https://bugs.gentoo.org/444832#c7. The implementation in Portage already omits the space. Replace grep by functionally equivalent code in bash. This is how the test is implemented in package managers, and follows the principle that external programs should not be called unnecessarily. Redirect stderr for "declare -p", because it outputs an error message if the PATCHES variable is not defined. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-functions.tex: Reorder phase functions in table.Ulrich Müller2019-11-251-1/+1
| | | | | | Ordering corresponding to their call order (except pkg_nofetch). Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Refer to chapters as chapters.Ulrich Müller2019-03-241-2/+2
| | | | | | | Also rename label prefixes, "ch:" for chapters, "sec:" for sections, as suggested by Michael Orlitzky. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-functions.tex: S to WORKDIR fallback is conditional for src_test.Ulrich Müller2019-03-051-4/+6
| | | | | | | | | | | | | | | | | | | | Arguably, section 9.1.1 "Initial working directories" applies also to src_test, even if section 9.1.8 "src_test" doesn't refer back to 9.1.1. In src_test, a fallback from S to WORKDIR could only happen for an ebuild that: - Has no files in A to be unpacked. - Doesn't define any of the unpack, prepare, configure, compile or install phases (otherwise it would die in one of these phases). Since that scenario is very unlikely, fix the wording in section 9.1.8 retroactively for EAPI 4 and later. Note: Implementations also differ about this: portage will always fall back, while for pkgcore it is a conditional error. Closes: https://bugs.gentoo.org/652050 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Add an EAPI 7 identical to EAPI 6.Ulrich Müller2018-03-301-18/+18
|
* pms.cls: Update \note command to suppress vertical space.Ulrich Müller2018-03-291-2/+2
| | | | Use the command correctly throughout; it requires an argument.
* Use simple underscores throughout.Ulrich Müller2017-05-151-121/+121
| | | | | Replacement was done using "sed -i 's/\\_/_/g' *.tex". This does not change the resulting PDF and HTML output.
* More consistent capitalisation of headings.eapi-6-approved-2017-04-29Ulrich Müller2017-04-161-2/+2
| | | | | | | | Use title case for first and second level headings (i.e., \chapter and \section in the main text, \section and \subsection in the EAPI cheat sheet); use sentence case everywhere else. https://archives.gentoo.org/gentoo-pms/message/cef75e03f1a3b692281a5b79065dc2b6
* In captions, use teletype font where appropriate.Ulrich Müller2017-04-101-8/+8
|
* Remove unused labels.Ulrich Müller2016-09-131-27/+11
|
* EAPI 6 has a different src_install implementation.Ulrich Müller2015-11-081-1/+18
|
* EAPI 6 has a default src_prepare.Ulrich Müller2015-11-081-9/+30
| | | | | | This adds support for the PATCHES array and for user patches. Bug: 463692
* Reformat EAPI tables to be more compact.Ulrich Müller2015-11-081-131/+94
| | | | | Combine all lines with identical behaviour for different EAPIs. Also use consistent indentation for tables in the LaTeX source.
* Add an EAPI 6 identical to EAPI 5.Ulrich Müller2015-11-081-9/+19
|
* Move listings of ebuild functions into listing environments.Ulrich Müller2015-11-041-0/+18
|
* 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-2/+2
|
* src-install-4: Replace single quotes by double quotesUlrich Müller2012-11-281-1/+1
| | | | This improves readability. It doesn't make any difference for bash.
* EAPI 5: src_test supports parallel tests.Ulrich Müller2012-09-131-2/+22
| | | | See bug 363005.
* Add an EAPI 5 identical to EAPI 4Ciaran McCreesh2012-09-131-8/+17
|
* Add \ChangeWhenAddingAnEAPI command.Ciaran McCreesh2012-09-131-0/+8
| | | | | This gives us an easy way to grep and find every place that needs updating when we add a new EAPI.
* src_test really calls emake -j1, not make.Ulrich Müller2012-05-111-3/+3
|
* Denote that src_test() can be disabled by user as well.Michał Górny2011-05-221-2/+3
| | | | | | Right now, the section on phase functions could suggest that src_test() will be run always unless RESTRICT=test is specified. Try to clear that up.
* Fixes for TeX4ht.Ulrich Mueller2011-01-271-7/+7
| | | | | | | | Postpone definition of \b command. Don't load pdfpages.sty when processing with TeX4ht. Avoid parboxes in tables. Recode the few non-ascii characters in pms.html. Fix xhtml syntax in longtable captions.
* Fix call order of pkg_* functions, bug 338339.Ulrich Mueller2010-10-111-18/+4
| | | | | | This reverts commit 2d3de7abf5484c616e9bc3fe398669d9935dd62c. In addition, add a note about possible different behaviour in EAPI 0 and 1. See also bug 174328.
* Fix spacing in all occurences of e.g. and i.e.Ulrich Mueller2010-09-191-1/+1
|
* Remove conditionals for kdebuild-1.Ulrich Mueller2010-01-101-164/+0
| | | | Signed-off-by: Ulrich Mueller <ulm@gentoo.org>
* Move EAPI 3 to EAPI 4 as decided by councilChristian Faulhammer2009-12-101-10/+29
| | | | | | | ulm prepared this patch to move all features that were currently found in EAPI 3 to EAPI 4, as the new EAPI 3 will be added as an intermediate version for Prefix support. Details about that still need to be filled in.
* src_unpack does source preparation only in EAPIs without src_prepare.Ulrich Mueller2009-09-261-2/+3
|
* Expand Emacs local variablesChristian Faulhammer2009-04-231-0/+3
| | | | | | Set indentation level to 4 Fix some cosmetic spacing issues Add missing local variables list
* shorter label namesCiaran McCreesh2009-04-231-2/+2
|
* Don't stick a blank line after featurelabelsCiaran McCreesh2009-04-231-52/+44
|
* Reference EAPI features by name, not section.Ciaran McCreesh2009-04-231-0/+14
|
* S to WORKDIR fallback conditional for EAPI 3Ciaran McCreesh2009-04-231-8/+60
|
* EAPI 3 supports pkg_info on non-installed packagesCiaran McCreesh2009-04-231-15/+20
|
* EAPI 3 has a default src_installCiaran McCreesh2009-04-111-3/+58
|
* EAPI 3 has pkg_pretend.Ciaran McCreesh2009-04-111-1/+56
|
* Rework tables for EAPI 3.Ciaran McCreesh2009-04-111-2/+14
| | | | | | | | | | | Update all feature tables for EAPI 3 as a copy of EAPI 2, and introduce an empty change list for EAPI 3. Things differing in EAPI 3 will be changed in subsequent commits. A few tables used the order 0, 1, 2, kdebuild-1 rather than 0, 1, kdebuild-1, 2. These are now fixed for consistency. Switch the features table to landscape, to make it fit better.
* Add prefixes to labels.Christian Faulhammer2009-02-201-38/+38
|
* Formatting tweaks.Christian Faulhammer2009-02-201-1/+1
| | | | | | | | Add curly braces to make variables look Gentoo-like. Do not prefix a variable with a dollar sign for consistency. Add curly braces to prevent ligatures in --.