aboutsummaryrefslogtreecommitdiff
Commit message (Collapse)AuthorAgeFilesLines
* ebuild-maintenance/removal: Change inconsistent virtual revbump policySam James2022-10-141-4/+2
| | | | | | | | | | | | | | | | This partly reverts commit f28b85f069c70538c618a3cedece77a359601dd8. There's no reason to treat virtuals differently here, there's no exception for it in how Portage works, and it may cause upgrade difficulties for users. It's also led to extensive confusion with contributors & new developers as we have to try to explain the inconsistency between devmanual and policy for non-virtuals. See: https://github.com/gentoo/gentoo/pull/27637 Closes: https://github.com/gentoo/devmanual/pull/303 Signed-off-by: Sam James <sam@gentoo.org>
* Explicitly specify UTF-8 encoding in XML declarationsUlrich Müller2022-10-095-5/+5
| | | | | | As specified by the DevBook XML guide. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Remove references to repomanMatt Turner2022-03-142-27/+20
| | | | | | Bug: https://bugs.gentoo.org/835013 Closes: https://github.com/gentoo/devmanual/pull/274 Signed-off-by: Matt Turner <mattst88@gentoo.org>
* ebuild-maintenance/package-moves: link to updates/ pageSam James2022-02-181-3/+4
| | | | | | | Bug: https://bugs.gentoo.org/388685 Signed-off-by: Sam James <sam@gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/268 Signed-off-by: Sam James <sam@gentoo.org>
* ebuild-maintenance/new-ebuild: use .patch, not .diffSam James2022-01-221-2/+2
| | | | | | We almost always use .patch now, so let's just reference it here too. Signed-off-by: Sam James <sam@gentoo.org>
* ebuild-maintenance/package-moves: minor grammar and formatting nitsSam James2022-01-221-3/+3
| | | | | | | | | - Drop a comma - Use <c>SLOT</c> Signed-off-by: Sam James <sam@gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/260 Signed-off-by: Sam James <sam@gentoo.org>
* ebuild-maintenance/package-moves: mention optfeatureSam James2022-01-221-2/+2
| | | | Signed-off-by: Sam James <sam@gentoo.org>
* ebuild-maintenance/package-moves: mention updating wiki pagesSam James2022-01-221-0/+3
| | | | Signed-off-by: Sam James <sam@gentoo.org>
* ebuild-maintenance/package-moves: add common terms for pkgmove/slotmoveSam James2022-01-221-7/+8
| | | | Signed-off-by: Sam James <sam@gentoo.org>
* ebuild-maintenance/git: link to general-concepts/copyright-policyJoonas Niilola2021-09-261-4/+3
| | | | | Signed-off-by: Joonas Niilola <juippis@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/new-ebuild: mention non-developers and large patchesSam James2021-04-071-3/+9
| | | | | Signed-off-by: Sam James <sam@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/git: Formatting fixesUlrich Müller2021-03-301-56/+69
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/new-ebuild: mention pkgdev as an alternative to repomanSam James2021-03-301-3/+4
| | | | | Signed-off-by: Sam James <sam@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/git: reference pkgcheck scan --commits and pkgdevSam James2021-03-301-14/+15
| | | | | Signed-off-by: Sam James <sam@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/git: Write tags in the same way as GLEP 66 doesUlrich Müller2021-02-231-3/+3
| | | | | | Namely, Suggested-by: and Reported-by: with lowercase "by". Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/removal: Process for virtual removalMichał Górny2021-01-181-0/+43
| | | | | Signed-off-by: Michał Górny <mgorny@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Remove unnecessary quotation marks.Ulrich Müller2020-04-071-3/+3
| | | | | | According to the style guide. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/removal: Add git sign-off parameter to example.Mike Pagano2020-03-071-1/+1
| | | | | | | Closes: https://bugs.gentoo.org/711810 Signed-off-by: Mike Pagano <mpagano@gentoo.org> [Order of options flipped.] Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/new-ebuild: Update "What (not) to put in the tree".Ulrich Müller2020-03-021-14/+13
| | | | | | Closes: https://bugs.gentoo.org/585218 Reported-by: Jonas Stein <jstein@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/package-collisions: Moved here from ebuild-maintenance.Ulrich Müller2020-01-282-50/+0
| | | | | | | This section is about a general concept, not a particular maintenance operation. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* keywording: Include sections about stabilization.Ulrich Müller2020-01-252-120/+0
| | | | | | | | | Remove the ebuild-maintenance/stabilization section (which resulted from the split of ebuild-maintenance/maintenance-tasks), and include it in keywording. Delete duplicate and outdated information. Closes: https://bugs.gentoo.org/648316 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance: Delete dead include.Ulrich Müller2020-01-231-1/+0
| | | | | Fixes:450692994d68bed141e324284ac9be671f8c84bf Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/package-and-slot-moves: Update package movesMichał Górny2020-01-231-67/+27
| | | | | | | | | | | | | Update the text on package moves to cover the case when PN changes as well as category. Cover necessary changes in moved ebuild. Switch from wall-of-text block into a more readable list. Move additional points from examples to this list. Finally, remove the example that now pretty much repeats what was said above. Signed-off-by: Michał Górny <mgorny@gentoo.org> [Clarification added by committer to first paragraph of "Moving or renaming a package".] Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/package-and-slot-moves: Add extra warningsMichał Górny2020-01-231-1/+21
| | | | | | | | Since people are frequently getting moves wrong, try to point out a few important limitations. Signed-off-by: Michał Górny <mgorny@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/maintenance-tasks: Drop "Homepage unavailable" section.Ulrich Müller2020-01-232-30/+5
| | | | | | | | | | | This isn't really a maintenance task. Also, we already mention this twice elsewhere, namely in ebuild-writing/variables and in ebuild-writing/common-mistakes. Update and fix link in the latter. Move the introductory paragraph to the parent document, and remove the chapter which has become empty. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/collisions: New chapter.Ulrich Müller2020-01-233-47/+50
| | | | | | Split off from ebuild-maintenance/maintenance-tasks. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/removal: New chapter.Ulrich Müller2020-01-233-83/+90
| | | | | | Split off from ebuild-maintenance/maintenance-tasks. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/stabilization: New chapter.Ulrich Müller2020-01-233-111/+120
| | | | | | Split off from ebuild-maintenance/maintenance-tasks. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/new-ebuild: New chapter.Ulrich Müller2020-01-233-123/+127
| | | | | | Split off from ebuild-maintenance/maintenance-tasks. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance: Move package & slot moves into sep chapterMichał Górny2020-01-233-120/+135
| | | | | | Signed-off-by: Michał Górny <mgorny@gentoo.org> [Fixed guide tag, use title case for chapter title.] Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Use source form of URI fragment identifiers throughout.Ulrich Müller2020-01-151-1/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/git: merge different references to #BUG-IDWim Muskee2020-01-141-9/+3
| | | | | | Closes: https://github.com/gentoo/devmanual/pull/133 Signed-off-by: Wim Muskee <wimmuskee@gmail.com> Signed-off-by: Göktürk Yüksek <gokturk@gentoo.org>
* Update some external links.Ulrich Müller2020-01-091-1/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Replace <path> by <c> throughout.Ulrich Müller2019-12-262-26/+26
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/maintenance-tasks: add missing '--signoff' in pkgmoveMiroslav Šulc2019-12-181-5/+7
| | | | | | | | | | | | | | when moving a package, the git commit command must also contain --signoff as without it Signed-off-by is not added to the commit message and git server rejects the commit. also updated commit message to one that contains Signed-off-by. (The commit message subject line is modified by the committer) Closes: https://github.com/gentoo/devmanual/pull/124 Signed-off-by: Miroslav Šulc <fordfrog@gentoo.org> Signed-off-by: Göktürk Yüksek <gokturk@gentoo.org>
* Use <d/> for dashes throughout.Ulrich Müller2019-12-081-4/+4
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Drop caption attribute from <pre> elements.Ulrich Müller2019-12-082-7/+7
| | | | | | This isn't processed by devbook.xsl and doesn't show up in the output. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Elements <brite>, <mail>, and <pkg> are not supported.Ulrich Müller2019-12-082-10/+8
| | | | | | | Use <c> instead, which seems to be the most appropriate replacement in their respective contexts. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Fix nesting of elements.Ulrich Müller2019-12-081-2/+4
| | | | | | | | - Lists inside <p> are not allowed. - <ul> is not a direct child of <ul>; it must be inside <li>. - <p>, <note>, etc. are no children of <p>. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Fix <body> elements.Ulrich Müller2019-12-082-14/+2
| | | | | | | No sectioning elements are allowed inside <body>, according to the devbook guide. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/git: add sign-off for Certificate of OriginWim Muskee2019-10-291-3/+9
| | | | | | | | Bug: https://bugs.gentoo.org/668686 Closes: https://github.com/gentoo/devmanual.gentoo.org/pull/113 Acked-by: Michał Górny <mgorny@gentoo.org> Signed-off-by: Wim Muskee <wimmuskee@gmail.com> Signed-off-by: Göktürk Yüksek <gokturk@gentoo.org>
* ebuild-maintenance/maintenance-tasks: "Touching other..." movedMichał Górny2019-10-161-33/+0
| | | | | | | | | | The "Touching other developers ebuilds" section has been effectively moved to "Package Maintainers". Remove the duplicate. Closes: https://github.com/gentoo/devmanual.gentoo.org/pull/104 Acked-by: Michael Orlitzky <mjo@gentoo.org> Signed-off-by: Michał Górny <mgorny@gentoo.org> Signed-off-by: Göktürk Yüksek <gokturk@gentoo.org>
* Avoid absolute (and outdated) /usr/portage path.Ulrich Müller2019-06-171-5/+4
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Fix 404 errorsBrian Evans2019-03-191-2/+1
| | | | | Closes: https://bugs.gentoo.org/653644 Signed-off-by: Brian Evans <grknight@gentoo.org>
* ebuild-maintenance/maintenance-tasks: Amend section on package removal.Ulrich Müller2018-09-231-2/+7
| | | | Clarify that reverse dependencies are to be removed.
* Convert various 'http://' URIs to 'https://'Göktürk Yüksek2018-04-201-2/+2
| | | | | | | Here's the heuristic for conversion: - If the https substitute is valid, always convert to https - If it's a bogus URI used in an example, convert it to https - If it's a valid URI used in an example with no valid https, leave it alone
* ebuild-maintenance: remove the Gentoo-Bug tag in the package removal subsectionGöktürk Yüksek2018-01-031-6/+6
| | | | | | | | | Per GLEP 66, the tags Bug and Closes should be used when referring to bugs. The example only illustrates the use of Closes per the commit message. Acked-by: Michael Orlitzky <mjo@gentoo.org> Closes: https://bugs.gentoo.org/640788
* ebuild-maintenance/git: Try to describe atomic commits better (GLEP 66)Michał Górny2018-01-021-13/+37
|
* ebuild-maintenance/git: Add new section on repoman commit/fullMichał Górny2018-01-021-7/+36
|
* Move the commit policy & commit message to gitMichał Górny2018-01-022-151/+158
|