Get Gentoo!
gentoo.org sites
gentoo.org Wiki Bugs Forums Packages
Planet Archives Sources
Infra Status
aboutsummaryrefslogtreecommitdiff
path: root/ebuild-writing/misc-files
Commit message (Collapse)AuthorAgeFilesLines
* ebuild-writing/misc-files/patches: modernise patch exampleSam James2021-06-181-2/+2
| | | | | | | | * Drop dates as we now recommend * Use patch level 1 Signed-off-by: Sam James <sam@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/patches: add reference to ${FILESDIR} in other sectionSam James2021-04-071-1/+3
| | | | | Signed-off-by: Sam James <sam@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/patches: slight phrasing tweak re patch sourceSam James2021-04-071-2/+2
| | | | | Signed-off-by: Sam James <sam@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/patches: grammatical fix re patch strip levelSam James2021-04-071-1/+1
| | | | | Signed-off-by: Sam James <sam@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* */*: consistent 'Portage' casingSam James2021-03-211-1/+1
| | | | | Signed-off-by: Sam James <sam@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/patches: TypoUlrich Müller2021-02-221-1/+1
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/patches: Convert to DevBook XML markupUlrich Müller2021-02-201-137/+200
| | | | | | | | | | | | - Start sentences with uppercase letters - Change some sentences from first-person to third-person - Less informal/colloquial style - Modernise the text a little (e.g., eapply instead of epatch) - Be more in line with GLEP 66 (e.g., "Bug" instead of "Gentoo-Bug-URL") Closes: https://bugs.gentoo.org/247266 Closes: https://github.com/gentoo/devmanual/pull/192 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/patches: Add section about clean patchesUlrich Müller2021-02-201-0/+214
| | | | | | | | | | Taken from https://dev.gentoo.org/~vapier/clean-patches (verbatim, except for escaping reserved characters). Original-Author: Mike Frysinger <vapier@gentoo.org> Bug: https://bugs.gentoo.org/247266 Signed-off-by: Mike Frysinger <vapier@gentoo.org> Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/metadata: Add example code for m-n detection.Ulrich Müller2020-04-161-2/+10
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/metadata: Describe stabilize-allarches.Ulrich Müller2020-04-161-2/+11
| | | | | | Information taken from metadata.dtd and GLEP 68. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/metadata: Reorder tags.Ulrich Müller2020-04-161-11/+11
| | | | | | | <maintainer> before <longdescription> seems to be the most common ordering, in the examples below and in the tree. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Remove unnecessary quotation marks.Ulrich Müller2020-04-071-1/+1
| | | | | | According to the style guide. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/misc-files/metadata: Explain EAPI 0 atom.Ulrich Müller2020-01-231-3/+4
| | | | | | | Since EAPIs 0 to 2 are no longer mentioned, we need to explain what an "EAPI=0 package dependency specification" is. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Use source form of URI fragment identifiers throughout.Ulrich Müller2020-01-152-5/+5
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* ebuild-writing/.../metadata: clarify that upstream maintainer takes no 'type'Göktürk Yüksek2020-01-141-0/+2
| | | | | | Closes: https://bugs.gentoo.org/703626 Closes: https://github.com/gentoo/devmanual/pull/140 Signed-off-by: Göktürk Yüksek <gokturk@gentoo.org>
* Replace <path> by <c> throughout.Ulrich Müller2019-12-261-9/+9
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* Elements <brite>, <mail>, and <pkg> are not supported.Ulrich Müller2019-12-081-49/+46
| | | | | | | 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-1/+2
| | | | | | | | - 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-5/+4
| | | | | | | No sectioning elements are allowed inside <body>, according to the devbook guide. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* general-concepts: Remove Herds and rename the sub to 'Projects'Michał Górny2019-10-161-1/+1
| | | | | | | | | | Herds are gone for over 3.5 years, so it's time to finally remove them from documentation. Remove the relevant section of 'Herds and Projects' article, and rename it to just 'Projects' accordingly. 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>
* ebuild-writing/../patches: add warning about stripMikle Kolyada2018-06-221-0/+7
|
* Convert various 'http://' URIs to 'https://'Göktürk Yüksek2018-04-201-1/+1
| | | | | | | 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
* Update links to GLEPs.Ulrich Müller2017-10-131-4/+4
| | | | | | GLEPs have been moved to https://www.gentoo.org/glep/. Bug: https://bugs.gentoo.org/634198
* ebuild-writing/misc-files/metadata: repoman does not depend on libxml2 anymoreGöktürk Yüksek2017-04-131-3/+2
| | | | | | | | When repoman was a part of sys-apps/portage, it didn't pull in libxml2 in the ebuild. The developers needed to make sure that libxml2 is installed on the system to perform metadata checks. Now that it's split into app-portage/repoman, it pulls in dev-python/lxml properly and this statement is no longer valid.
* ebuild-writing: Delete obsolete sections about CVS keyword expansion.Ulrich Müller2017-02-281-19/+0
| | | | | Git doesn't by default expand any keywords like $Id$ or $Date$, so patches can be committed like any other file.
* ebuild-writing/metadata: indentation rules, #591548Wim Muskee2016-12-111-0/+15
|
* ebuild-writing/misc-files/patches: suggest compressing patches with xzGöktürk Yüksek2016-06-151-6/+7
| | | | | | | With app-arch/xz-utils being in @system, suggest patches to be compressed with xz as it achieves higher compression rates than bzip2. Reported-by: dracwyrm <j.scruggs@gmail.com>
* ebuild-writing/misc-files: re-indent the category metadata.xml exampleGöktürk Yüksek2016-05-181-12/+12
| | | | | | | Re-indent the category metadata.xml example so that it's more in line with the package metadata examples. Signed-off-by: Göktürk Yüksek <gokturk@gentoo.org>
* ebuild-writing/misc-files: do not use https in DOCTYPE for metadata filesGöktürk Yüksek2016-05-181-1/+1
| | | | | | | | | | libxml2 has no SSL support and therefore cannot fetch the DTD served over https. See the Gentoo commit: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=1bfb585cc60a9e This partially reverts 5b16122e6786de482bf8a57ae7eebcc8a31d4b17 Signed-off-by: Göktürk Yüksek <gokturk@gentoo.org>
* ebuild-writing/misc-files/metadata: add an example for slots and subslotsGöktürk Yüksek2016-05-181-0/+50
| | | | Signed-off-by: Göktürk Yüksek <gokturk@binghamton.edu>
* ebuild-writing/misc-files/metadata: update wrt slotting and per GLEP 68Göktürk Yüksek2016-05-181-47/+93
| | | | | | | | | | | Add information about specifying slots and subslots in the metadata. Also, update the section according to the specifications in GLEP 68, clarify some of the tags better, and reorder the tags to improve the flow of the text. Signed-off-by: Göktürk Yüksek <gokturk@binghamton.edu>
* ebuild-writing/misc-files/metadata: rewrite the section per GLEP 67 #572144Göktürk Yüksek2016-05-181-180/+238
| | | | | | | | | | | | | | | | | | | | | | | | A major rewrite of the section. Here is a brief summary of changes: - Remove the information about the <herd> tag per GLEP 67 - Restructure the section in the following order: - metadata.xml syntax - package metadata - metadata examples - maintainer-needed - category metadata - Update the tables for metadata.xml syntax per GLEP 67 - Rewrite the package metadata examples to reflect better on GLEP 67 and enhance with more explanations - Assign meaningful titles to package metadata examples instead of using "First Example", "Second Example" etc. - Add a subsection for handling maintainer-needed in metadata.xml per GLEP 67 and provide an example This commit also makes #545272 obsolete. Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=572144 Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=545272 Signed-off-by: Göktürk Yüksek <gokturk@binghamton.edu>
* Update years in example ebuild and eclass headers.Ulrich Müller2016-04-021-2/+2
| | | | Also escape any VCS keywords that could potentially be expanded.
* ebuild-writing/misc-files/metadata: Don't mention glep31check.Ulrich Müller2016-02-051-1/+0
| | | | | | | This tool isn't (and never was) in the tree and the sources seem to be unavailable. Therefore the documentation should not recommend its use. Bug: 572156
* ebuild-writing/misc-files: remove ChangeLog section #485314Michael Orlitzky2016-02-052-112/+0
| | | | | | | | The ChangeLog section under misc-files is misleading now that our main repository has been switched to git (and we no longer have ChangeLogs). Remove the ebuild-writing/misc-files/changelog page. Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=485314
* ebuild-writing/misc-files: replace the code for cvs commit with git #558642Gokturk Yuksek2016-02-051-1/+15
| | | | | | | Replace "cvs commit" with the equivalent "git add && git commit" version. Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=558642 Signed-off-by: Gokturk Yuksek <gokturk@binghamton.edu>
* Gentoo is doing https for everythin nowJustin Lecher2015-08-212-7/+7
| | | | Signed-off-by: Justin Lecher <jlec@gentoo.org>
* Update patchesJohannes Huber2015-08-201-10/+6
| | | | Due to git migration.
* fixing a small typo in ebuild-writing/misc-files/patchesmudler2014-07-231-1/+1
|
* update GLEP links to new wiki locationMarkus Meier2014-03-311-3/+3
| | | | | | | GLEPs have been moved to wiki.g.o - update all GLEP links to the new location X-Gentoo-Bug: 504526 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=504526
* ebuild-writing/metadata: Fix second metadata.xml exampleMarkus Meier2014-01-191-2/+2
| | | | | | | | use <codesample lang="sgml"> instead of <pre> to get colored output like the other examples. X-Gentoo-Bug: 498556 X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=498556
* metadata: fix important sequence of email and name in maintainer sectionDavid Heidelberger2014-01-031-7/+7
|
* ChangeLog: Add note about missing ChangeLog filesMarkos Chandras2013-09-281-0/+6
| | | | Bug #464216
* Add reference to the mirror page from the patch pageJohann Schmitz2013-08-171-1/+2
| | | | Clarify why it is a good idea to use dev.gentoo.org
* Fix for incorrect hyperlink to metastructure project, see ↵Sergey Popov2013-05-121-1/+1
| | | | https://bugs.gentoo.org/show_bug.cgi?id=455132
* echangelog: Add cross-references between echangelog and ChangeLogMarkos Chandras2012-12-151-1/+1
|
* metadata: Add examples from the devrel handbookMarkos Chandras2012-11-111-22/+442
|
* Make <herd/> optional, remove 'no-herd'. Bug #384175Michał Górny2012-11-021-4/+3
|
* Improve English for ChangeLog textPetteri Räty2011-05-101-2/+2
| | | | Brian Harring thinks a semicolon is better English here.
* Updating ChangeLog in all situations is mandatoryPetteri Räty2011-05-101-5/+4
| | | | | | | Council just voted in the meeting today that ChangeLog must be updated with each commit so that it is like a local VCS log. The original trigger for this change was that ebuild removals were not logged in all cases.