commit: 450692994d68bed141e324284ac9be671f8c84bf Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> AuthorDate: Tue Jan 21 11:02:00 2020 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Thu Jan 23 07:48:07 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=45069299
ebuild-maintenance/maintenance-tasks: Drop "Homepage unavailable" section. 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 <AT> gentoo.org> ebuild-maintenance/maintenance-tasks/text.xml | 28 --------------------------- ebuild-maintenance/text.xml | 7 +++++-- ebuild-writing/common-mistakes/text.xml | 12 ++++++------ 3 files changed, 11 insertions(+), 36 deletions(-) diff --git a/ebuild-maintenance/maintenance-tasks/text.xml b/ebuild-maintenance/maintenance-tasks/text.xml deleted file mode 100644 index ccdefe9..0000000 --- a/ebuild-maintenance/maintenance-tasks/text.xml +++ /dev/null @@ -1,28 +0,0 @@ -<?xml version="1.0"?> -<guide self="ebuild-maintenance/maintenance-tasks/"> -<chapter> -<title>Maintenance Tasks</title> - -<body> -<p> -This guide aims to explain common everyday ebuild maintenance -routines, as well as other rarer maintenance routines which -developers may not be familiar with. -</p> -</body> - -<section> -<title>Homepage unavailable</title> -<body> - -<p> -If the <c>HOMEPAGE</c> of your package seems to be unavailable or it -never existed at all, please set the HOMEPAGE variable in every ebuild -to <uri link="https://wiki.gentoo.org/wiki/No_homepage"> -https://wiki.gentoo.org/wiki/No_homepage</uri> -</p> - -</body> -</section> -</chapter> -</guide> diff --git a/ebuild-maintenance/text.xml b/ebuild-maintenance/text.xml index 1917b07..a9f295c 100644 --- a/ebuild-maintenance/text.xml +++ b/ebuild-maintenance/text.xml @@ -2,11 +2,14 @@ <guide self="ebuild-maintenance/"> <chapter> <title>Ebuild Maintenance</title> - <body> + <p> -This section covers various tasks related to working with ebuilds. +This section aims to explain common everyday ebuild maintenance routines, +as well as other rarer maintenance routines which developers may not be +familiar with. </p> + </body> <section> diff --git a/ebuild-writing/common-mistakes/text.xml b/ebuild-writing/common-mistakes/text.xml index 2127b3f..ff9b377 100644 --- a/ebuild-writing/common-mistakes/text.xml +++ b/ebuild-writing/common-mistakes/text.xml @@ -363,12 +363,12 @@ SLOT="0" <body> <p> -Please check if the HOMEPAGE variable is right and leads users to the right -page if they want to find out more about the package. And make sure the -DESCRIPTION is not overly long. Good descriptions will describe the main -function of the package in a sentence. Set HOMEPAGE to -<uri link="::ebuild-maintenance/maintenance-tasks#Homepage unavailable"> -No_homepage wiki page</uri>, if there is none. +Please check if the <c>HOMEPAGE</c> variable is right and leads users to the +right page if they want to find out more about the package. And make sure +the <c>DESCRIPTION</c> is not overly long. Good descriptions will describe +the main function of the package in a sentence. If no homepage for the package +is available, set the <c>HOMEPAGE</c> variable to +<c>https://wiki.gentoo.org/wiki/No_homepage</c>. </p> </body>