aboutsummaryrefslogtreecommitdiff
Commit message (Collapse)AuthorAgeFilesLines
* Fix multiple typos and grammatical errorsHEADmasterSebastian Engel7 days6-15/+15
| | | | | Signed-off-by: Sebastian Engel <sighunter@gmx.de> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: Use self-closing tags when possibleUlrich Müller2024-07-301-22/+22
| | | | | | | This makes no difference for the HMTL output, i.e. xsltproc will expand <foo/> to <foo></foo>. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/copyright-policy: Exceptions are granted by the CouncilUlrich Müller2024-07-251-1/+1
| | | | | | | See GLEP 76 update: https://gitweb.gentoo.org/data/glep.git/commit/?id=7f0ce454b2359ed742b84d1d60176fadad15c066 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/common-mistakes: Delete P0 from list of custom variablesUlrich Müller2024-07-241-1/+1
| | | | | | As discussed in #gentoo-qa. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/eapi: Add todo items for EAPIs 5 and 6Ulrich Müller2024-07-051-0/+14
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing, function-reference: Update eqawarn documentationUlrich Müller2024-07-052-5/+6
| | | | | | No longer mention eutils.eclass for eqawarn. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* function-reference/version-functions: New chapterUlrich Müller2024-07-054-17/+229
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* appendices/contributors: WhitespaceUlrich Müller2024-06-111-4/+4
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* appendices/contributors: DTD has been replaced by RELAX NG schemaUlrich Müller2024-06-111-1/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Makefile: Check if /guide/@self agrees with the document pathUlrich Müller2024-06-111-0/+7
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: Rename parameter of repeat-string templateUlrich Müller2024-06-101-6/+6
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Revert "general-concepts/tree: Allow @ in filenames"Ulrich Müller2024-06-021-1/+1
| | | | | | | | | | | As it turns out, Portage will silently drop files containing an @ char during Manifest generation. See bug 411127 and bug 106544 for further reference. This reverts commit 38de9c654dd036b304b158a32b14dbe785327938. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/tree: Allow @ in filenamesUlrich Müller2024-06-021-1/+1
| | | | | | As discussed in #gentoo-dev. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/removal: Use the new PKGREMOVED resolutionMichał Górny2024-05-081-1/+1
| | | | Signed-off-by: Michał Górny <mgorny@gentoo.org>
* devbook.xsl: Use abbreviated CC-BY-SA-4.0 in footerUlrich Müller2024-05-071-1/+1
| | | | | | This agrees with the footer in other gentoo.org sites. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook-guide: Document that sentence case should be used in titlesUlrich Müller2024-05-071-0/+6
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* More sentence case changesUlrich Müller2024-05-077-13/+13
| | | | | | Apparently these have been missed previously. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Fix internal referencesUlrich Müller2024-05-0737-71/+75
| | | | | | | Internal links referring to sections were broken by the previous "Sentence case devmanual" commit. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/patches: Revert wording changeUlrich Müller2024-05-071-1/+1
| | | | | | | | This is referred to as the "Clean patch howto" from several other places. The wording change would also break links because the section title is used as fragment identifier. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Sentence case devmanualMatthew Marchese2024-05-07113-348/+349
| | | | | | Signed-off-by: Matthew Marchese <maffblaster@gentoo.org> [Whitespace. Fix rebase artifact in ebuild-writing/functions/src_test.] Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/functions/src_prepare/eapply: fix typoLouis Sautier2024-04-291-1/+1
| | | | | Signed-off-by: Louis Sautier <sbraz@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/licenses: Licenses must be plain textUlrich Müller2024-04-291-5/+5
| | | | | | | Historically we had some PDF files in the repository, but the last of them was removed in 2011. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* No longer mention PORTDIRUlrich Müller2024-04-294-12/+11
| | | | | Closes: https://bugs.gentoo.org/865455 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* eclass-writing: Some updates from patch reviewUlrich Müller2024-04-241-4/+4
| | | | | | Suggested by mjo and sam. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* eclass-writing: Formatting fixesUlrich Müller2024-04-241-4/+5
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* eclass-writing: Add @DEAD tag to tableUlrich Müller2024-04-241-0/+9
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Revert "eclass-writing: @DEAD must be the first tag"Ulrich Müller2024-04-241-3/+1
| | | | | | | | eclass-to-manpages is now less strict about placement of the tag. This reverts commit cd392d0c6cd064ac3a1381111e678f4fe111afcc. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/functions/src_prepare/eapply: Clarify eapply for dirUlrich Müller2024-04-231-3/+3
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* .gitignore: Ignore Emacs backup filesUlrich Müller2024-04-221-0/+4
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* lang.highlight.ebuild.xsl: Drop epatch keywordUlrich Müller2024-04-221-2/+0
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/functions/src_prepare/eapply: Rework the chapterUlrich Müller2024-04-221-127/+76
| | | | | | | Drop explanation of epatch. Rework the eapply sections and add additional examples. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/functions/src_prepare: Rename epatch chapter to eapplyUlrich Müller2024-04-215-5/+5
| | | | | | Update references throughout. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tools-reference/diff-and-patch: No longer mention epatchUlrich Müller2024-04-211-2/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/git: drop repoman from commit messageVolkmar W. Pogatzki2024-04-131-6/+0
| | | | | Signed-off-by: Volkmar W. Pogatzki <gentoo@pogatzki.net> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: Add Gentoo e.V. to page footerUlrich Müller2024-03-231-1/+1
| | | | | Bug: https://bugs.gentoo.org/927555 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/file-format: Update year in ebuild headerUlrich Müller2024-02-211-1/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* package-moves: Allow moving back, and describe how to chain updatesMichał Górny2024-02-081-2/+48
| | | | | | | | | | | | | | | | | Make the rule forbidding reusing old package names less strict. There is no real reason not to move packages back — we can safely assume that the package manager will handle that just fine. The only real restriction is that no other package must reuse any of the old names, i.e. effectively cause the package manager to attempt merging the packages together. Add explicit rules for updating old package move entries. These match the logic used in pkgcheck, and therefore ensure both correct results and no warnings from pkgcheck. Signed-off-by: Michał Górny <mgorny@gentoo.org> [Replace Unicode subscripts by <sub> markup] Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: Add sub and sup elementsUlrich Müller2024-02-084-4/+31
| | | | | | | These were present in GuideXML: https://gitweb.gentoo.org/proj/devmanual.git/tree/appendices/contributing/devbook-guide/text.xml?id=8be0d382fb82dc4cfe73b1b85bb7fc3c923a21c7#n397 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Makefile: Drop obsolete test for xmllint --quietUlrich Müller2024-01-281-3/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Update copyright yearsUlrich Müller2024-01-192-2/+2
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* eclass-writing: @USAGE is not requiredUlrich Müller2024-01-141-1/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/licenses: The main license should be listed firstUlrich Müller2023-11-251-1/+2
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: Use same test for eclass pages everywhereUlrich Müller2023-11-231-4/+4
| | | | | | Drop relative_path_depth variable which is no longer used. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* lang.highlight.ebuild.xsl: Collect shell commands in a variableUlrich Müller2023-11-061-9/+11
| | | | | | Rewrap some long lines. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* lang.highlight.ebuild.xsl: Update keyword listsUlrich Müller2023-11-061-248/+89
| | | | | | | | | | | | | | Update list of package manager commands up to EAPI 8. Include eclasses that are: - used in an existing example in the Devmanual, or - general purpose eclasses and inherited by more than 1000 ebuilds in the Gentoo repository. The lists of commands are taken from ebuild-mode. Closes: https://bugs.gentoo.org/916628 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook-guide: Document the todo elementUlrich Müller2023-11-051-9/+20
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook-guide: Don't require blank lines in list items and table cellsUlrich Müller2023-11-051-0/+2
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: Manipulate paths in getLastNode consistentlyUlrich Müller2023-11-051-5/+5
| | | | | | | Directory paths are used everywhere else, so append text.xml only when actually accessing the file. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: Fix links created by contentsTree extractionUlrich Müller2023-11-021-3/+15
| | | | | | | | | | | | | If the element that is extracted from the external document contains internal references, these links would be relative to the wrong start location, namely the one defined in that document. Therefore, define our own copy of /guide/@self (pointing to the location of the target document), and rebase the tree onto it. This fixes the intra-document links in appendices/todo-list/. Closes: https://bugs.gentoo.org/916523 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: Use hexadecimal for character entitiesUlrich Müller2023-11-021-3/+3
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>