Get Gentoo!
gentoo.org sites
gentoo.org Wiki Bugs Forums Packages
Planet Archives Sources
Infra Status
aboutsummaryrefslogtreecommitdiff
Commit message (Collapse)AuthorAgeFilesLines
...
* function-reference/install-functions: Mention dosym -r optionUlrich Müller2023-10-211-5/+10
| | | | | Closes: https://bugs.gentoo.org/916017 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/new-ebuild; Fix link to bugzilla advanced searchUlrich Müller2023-10-211-9/+10
| | | | | | Also update the paragraph explaining it. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: WhitespaceUlrich Müller2023-10-051-3/+3
| | | | | Fixes: 19153057c1dbbc3537dfc9d1ca20a12d69a46c81 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* appendices/devbook-guide: GuideXML -> DevBook XMLUlrich Müller2023-10-051-1/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl, bin/gen-eclass-html.sh: Link to privacy policyUlrich Müller2023-10-052-2/+10
| | | | | Bug: https://bugs.gentoo.org/613938 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* function-reference/query-functions: usev accepts two args in EAPI 8Ulrich Müller2023-10-011-2/+3
| | | | | Closes: https://bugs.gentoo.org/914590 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/dependencies: use <c> tag for dev-util/ebuildtesterPetr Vaněk2023-09-271-1/+1
| | | | | Signed-off-by: Petr Vaněk <arkamar@atlas.cz> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/ebuild-revisions: License updates may require a revbumpUlrich Müller2023-08-261-0/+4
| | | | | | | See for example bug 912458, where removal of the unused CMake license caused a blocker on users' systems. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* eclass-writing: Use underscores for function names in the exampleUlrich Müller2023-08-261-7/+8
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/use-flags: Clarification about compiler flagsJonas Frei2023-08-221-5/+6
| | | | | | Signed-off-by: Jonas Frei <freijon@pm.me> [Whitespace fixed.] Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* function-reference/install-functions: Reword dostrip documentationUlrich Müller2023-05-271-5/+5
| | | | | | | | As a followup to the previous change, use a better path for the example and reword. No longer mention EAPI 7 because all older EAPIs are deprecated. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* eclass-writing: Drop INCLUDES_EPREFIX documentation tagUlrich Müller2023-05-271-23/+0
| | | | | | This reflects its being dropped from eclass-to-manpage. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* function-reference/install-functions: add note about paths to dostripmatoro2023-04-291-0/+1
| | | | | | | | | Found this extremely unintuitive especially compared to the documentation on the `dosym` function which is much clearer. Closes: https://bugs.gentoo.org/888817 Signed-off-by: Matoro Mahri <matoro@users.noreply.github.com> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Update copyright yearsUlrich Müller2023-01-212-2/+2
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/ebuild-revisions: clarify interaction with adding/removing ↵Sam James2023-01-141-2/+8
| | | | | | | | | | | | | | | | USE flags Note that when adding a USE flag where the functionality was previously on (not off in build system), one must revbump because a dep was unconditional that now became conditional. Also, if removing a USE flag where the behaviour is now on, but was previously always off (not on in build system), one must revbump also, because people might have never set USE=foo (hence --changed-use wouldn't pick it up) but their deps have now effectively changed. Bug: https://github.com/pkgcore/pkgcheck/pull/435 Signed-off-by: Sam James <sam@gentoo.org>
* ebuild-writing/file-format: update copyright header's year to 2023Joonas Niilola2023-01-121-1/+1
| | | | | | - since some people get it from this file. Signed-off-by: Joonas Niilola <juippis@gentoo.org>
* ebuild-maintenance/git: update grafted repo URLSam James2022-11-221-2/+2
| | | | | | Signed-off-by: Sam James <sam@gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/306 Signed-off-by: Sam James <sam@gentoo.org>
* general-concepts/ebuild-revisions: note that build failures may be a missing ↵Sam James2022-11-101-2/+3
| | | | | | | | | | | rdepend If, for example, a "qtcore" missing dependency results in a src_configure failure and a bug is filed, that doesn't mean a revbump can be skipped, as for others, if they had qtcore installed already, the package is silently linked against it without it being recorded as a dependency. Signed-off-by: Sam James <sam@gentoo.org>
* general-concepts/ebuild-revisions: note which build-time fixes need a new ↵Sam James2022-11-101-1/+5
| | | | | | revision Signed-off-by: Sam James <sam@gentoo.org>
* ebuild-writing/eapi: Replace interactive by live in exampleUlrich Müller2022-10-191-2/+2
| | | | | | The former is semi-deprecated and we shouldn't advertise its use. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-maintenance/removal: Change inconsistent virtual revbump policySam James2022-10-142-9/+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-09130-130/+130
| | | | | | As specified by the DevBook XML guide. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/variables: Fix example for ROOTUlrich Müller2022-08-251-2/+2
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/variables: Add section about reserved variablesUlrich Müller2022-08-181-0/+35
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/variables: Demote single variable sections to subsectionsUlrich Müller2022-08-171-170/+170
| | | | | | Reorder subsections to follow the ordering of the tables. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/copyright-policy: List licenses explicitlyUlrich Müller2022-06-251-4/+24
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/copyright-policy: Drop a linkUlrich Müller2022-06-251-4/+3
| | | | | | | There is a link to GLEP 76 immediately above and another in the same sentence. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Describe mailing lists used by developersMichał Górny2022-06-242-0/+81
| | | | | Signed-off-by: Michał Górny <mgorny@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Makefile: Dependencies for todo-listUlrich Müller2022-06-241-0/+2
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* appendices/common-problems: Remove empty sectionUlrich Müller2022-06-241-11/+0
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* appendices/common-problems: Drop incomprehensible TODO directiveUlrich Müller2022-06-241-11/+0
| | | | | | This exists since at least 2005 but nobody has written it. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tools-reference/sed: Add cross reference to "Further reading"Ulrich Müller2022-06-241-4/+5
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/dependencies: add paragraph explaining exampleFlorian Schmaus2022-06-241-0/+32
| | | | | | | | | | | Add a small paragraph explaining the existing slot-operator example. This is scavenged from my proposed change for bug #739858. Signed-off-by: Florian Schmaus <flow@gentoo.org> Bug: https://bugs.gentoo.org/739858 [Commits squashed; small fixes according to style guide.] Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: Fix whitespace in <note> and friendsUlrich Müller2022-06-221-4/+4
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.rnc: TypoUlrich Müller2022-06-172-2/+2
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* devbook.xsl: Eclass documentation needs GPL-2 in the footerUlrich Müller2022-06-101-1/+9
| | | | | | | Eclasses are licensed GPL-2, therefore we need a different footer. Hardcode this for all sub-pages of eclass-reference/. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tools-reference/bash: Add tables of metacharacters and constructsUlrich Müller2022-06-101-7/+54
| | | | | | | | | Parts of this have been taken from the Bash Reference Manual authored by Chet Ramey and Brian Fox. See https://bugs.gentoo.org/829916#c9. Closes: https://bugs.gentoo.org/829916 Reported-by: Alexis <flexibeast@gmail.com> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/config-protect: WhitespaceUlrich Müller2022-06-051-14/+15
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/config-protect: Add example for env.dAmit Dor-Shifer2022-06-051-0/+15
| | | | | | Closes: https://bugs.gentoo.org/289565 [Make the XML validate. Small tweaks to example and wording.] Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/features: RemoveUlrich Müller2022-06-042-65/+0
| | | | | | | | Incomplete and outdated. make.conf(5) is a better reference and is available in eclass-reference/. Closes: https://bugs.gentoo.org/667536 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/metadata: Update restrict attributeUlrich Müller2022-05-271-9/+6
| | | | | | | | | | | | | | The description currently says: "When this attribute is used, other tags with or without the restrict attribute must be present to cover all the versions of the package. A tag without the restrict attribute serves as the default." However, this is not reflected by the specification in GLEP 68. It appears to have originated from the old DevRel Handbook where it had been added in 2004: https://gitweb.gentoo.org/archive/proj/gentoo.git/tree/xml/htdocs/proj/en/devrel/handbook/hb-guide-metadata.xml?id=26d18f5f20f00e538b7af0d5a795008f3426d243#n135 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/metadata: Language tags can be BCP 47Ulrich Müller2022-05-271-3/+3
| | | | | | | This corresponds to the update of GLEP 68. Bug: https://bugs.gentoo.org/578294 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tools-reference/bash: Rework table on file comparisonUlrich Müller2022-05-271-5/+5
| | | | | | | | - Replace "same device and inode numbers" by "hard link". - Fix grammar (remove "if"). - Remove full stops (according to style guide). Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tools-reference/bash: Fix a typoUlrich Müller2022-05-271-2/+2
| | | | | | lexiographic -> lexicographic Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tools-reference/bash: More compact table formatting in source codeUlrich Müller2022-05-271-526/+270
| | | | | | No change of text. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tools-reference/bash: Remove obsolete comment about Bash 3Ulrich Müller2022-05-271-1/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* tools-reference/bash: Drop redundant quotation marks in [[ ]] testsUlrich Müller2022-05-271-15/+9
| | | | | | | Remove a note that was recommending them. Use {} braces around variable names throughout. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/dependencies: WhitespaceUlrich Müller2022-05-271-2/+2
| | | | | | Fixes: d08d5f0dea3d8580c55a052d6424863d6aeb8ae9 Fixes: 6c0b51ae63833c2ddfd58412727c0004db06d605 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts/dependencies: expand on finding correct deps a bitJoonas Niilola2022-05-221-3/+11
| | | | | Signed-off-by: Joonas Niilola <juippis@gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/284
* general-concepts/dependencies: add new section for indirect depsJoonas Niilola2022-05-221-0/+17
| | | | Signed-off-by: Joonas Niilola <juippis@gentoo.org>