From 143db50760758ca340cc88f41f44955d4d16e1e7 Mon Sep 17 00:00:00 2001 From: Ulrich Müller Date: Thu, 26 Dec 2019 20:27:30 +0100 Subject: Remove all p elements below dd. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Where necessary, use multiple dd elements instead. Signed-off-by: Ulrich Müller --- appendices/common-problems/text.xml | 6 ------ appendices/contributing/text.xml | 31 +++++++++++++------------------ appendices/further-reading/text.xml | 6 ------ archs/amd64/text.xml | 12 +++--------- ebuild-writing/eapi/text.xml | 12 ++++++------ general-concepts/tree/text.xml | 25 ++++--------------------- keywording/text.xml | 8 -------- tools-reference/tr/text.xml | 16 +++++----------- 8 files changed, 31 insertions(+), 85 deletions(-) diff --git a/appendices/common-problems/text.xml b/appendices/common-problems/text.xml index 3af479b..430e74b 100644 --- a/appendices/common-problems/text.xml +++ b/appendices/common-problems/text.xml @@ -56,36 +56,30 @@ in use, there are various alternatives: sed, awk, grep, egrep, cut etc
-

Usually when any of the above are used in global scope, it is to manipulate a version or program name string. These should be avoided in favour of pure bash constructs. The eapi7-ver eclass is often of use here. See , man eapi7-ver.eclass and . -

has_version, best_version
-

Calls to either of these globally indicates a serious problem. You must not have metadata varying based upon system-dependent information see . You should rewrite your ebuilds to correctly use dependencies. -

python, perl etc
-

Ebuilds are bash scripts. Offloading anything you don't know how to do in bash onto another language is not acceptable if nothing else, because not all users will always have a full system when ebuilds are sourced. -

diff --git a/appendices/contributing/text.xml b/appendices/contributing/text.xml index 4b65c41..d17205a 100644 --- a/appendices/contributing/text.xml +++ b/appendices/contributing/text.xml @@ -81,34 +81,29 @@ really should first examine the GuideXML guide in a reasonable amount of depth. Indentation
-

- Indent when needed you should not indent any section flow elements such as - <subsection> but do indent tables, lists and definition lists. - Do not indent text in ordinary paragraph blocks. -

+ Indent when needed you should not indent any section flow elements + such as <subsection> but do indent tables, lists and + definition lists. Do not indent text in ordinary paragraph blocks.
Code Samples
-

- You can use the normal GuideXML tag <pre> when you need no syntax - highlighting. When you need syntax highlighting use the <codesample> - tag along with a lang attribute usually you want this to be set to - ebuild to syntax highlight ebuild code snippets. -

+ You can use the normal GuideXML tag <pre> when you need + no syntax highlighting. When you need syntax highlighting use the + <codesample> tag along with a lang attribute + usually you want this to be set to ebuild to syntax highlight ebuild + code snippets.
Hierarchy
-

- The whole document is organized as a tree. Each directory can contain one - document. Each document can inherit multiple sub-documents using the - <include> flag. You must ensure that the self tag - in each document correctly points to the relative path of the document from - the root node so that the tree-walking algorithms work correctly. -

+ The whole document is organized as a tree. Each directory can contain + one document. Each document can inherit multiple sub-documents using the + <include> flag. You must ensure that the self + tag in each document correctly points to the relative path of the document + from the root node so that the tree-walking algorithms work correctly.
diff --git a/appendices/further-reading/text.xml b/appendices/further-reading/text.xml index d48277c..0a658f6 100644 --- a/appendices/further-reading/text.xml +++ b/appendices/further-reading/text.xml @@ -19,12 +19,10 @@ recommendations, not padding designed to make this document look important. Mastering Regular Expressions
-

"Mastering Regular Expressions" by Jeffrey E. F. Friedl (O'Reilly, ISBN 0-596-00289-0) is the book on regular expressions. Very readable and devoid of the usual mathematical jargon that tends to fill up these kinds of books. Publisher's page -

@@ -40,21 +38,17 @@ recommendations, not padding designed to make this document look important. Making Packager-Friendly Software
-

Making Packager-Friendly Software by Julio M. Merino Vidal describes various things that can be done by upstream software providers to make life easy for the distribution people (that means you). -

How to Report Bugs Effectively
-

How to Report Bugs Effectively by Simon Tatham is a good overview of effective bug reporting. -

diff --git a/archs/amd64/text.xml b/archs/amd64/text.xml index 392999b..0f75426 100644 --- a/archs/amd64/text.xml +++ b/archs/amd64/text.xml @@ -269,25 +269,19 @@ configurations. d
-

- Directory containing mixed-bit objects -

+ Directory containing mixed-bit objects
dXX
-

- Directory containing XXbit objects -

+ Directory containing XXbit objects
l->foo
-

- Link to foo -

+ Link to foo
diff --git a/ebuild-writing/eapi/text.xml b/ebuild-writing/eapi/text.xml index 3f9590d..cb49e35 100644 --- a/ebuild-writing/eapi/text.xml +++ b/ebuild-writing/eapi/text.xml @@ -624,17 +624,17 @@ src_install() {

source
-

+

if building and installing a package from source, -

+
binary
-

+

if installing a binary package, -

+
buildonly
-

+

if building a binary package without installing it. -

+
  • diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml index 4afd8d5..4d2bf64 100644 --- a/general-concepts/tree/text.xml +++ b/general-concepts/tree/text.xml @@ -113,87 +113,70 @@ Software-wise, in general all of the following should be met in order for a pack
    Active, Cooperative Upstream
    -

    If a package is undeveloped or unmaintained upstream, it can be extremely difficult to get problems fixed. If a package does not have an active upstream, the developers who add the package to the tree must ensure that they are able to fix any issues which may arise. -

    -

    +

    +
    Sometimes upstream may have a reason for not wanting their package included in the tree. This should be respected. -

    Reasonably Stable
    -

    Keep super-experimental things out of the tree. If you must commit them, consider using package.mask until things calm down, or better yet make them available as overlay ebuilds. -

    Reasonably Useful
    -

    Don't feel obliged to include "Joe's '1337 XMMS Skinz Collection" or "Hans' Super Cool Fast File System" in the tree just because a few users ask for it. Stick to things that might actually be of use. -

    Properly Packaged
    -

    If something is only available in live CVS or dodgy autopackage format, don't include it until upstream can come up with a decent source package. Similarly, avoid things that don't have a proper build system (where relevant) these are very tricky to maintain. -

    Patching and Distribution Permitted
    -

    If we can't patch packages as necessary ourselves, we end up relying entirely upon upstream for support. This can be problematic, especially if upstream are slow at fixing things. We don't want to be in the situation where we can't stable a critical package because we're still waiting for a closed-source vendor to get their act together. -

    - -

    +

    +
    Similarly, not being able to mirror and distribute tarballs ourselves makes us rely entirely upon upstream mirrors. Experience has shown that these are often extremely unreliable, with files changing, moving or vanishing at random. -

    Working Ebuilds
    -

    If you don't have a working ebuild, don't include it. -

    Portable
    -

    If software is unportable, it's generally because it's badly written. Remember that although x86 has a market majority now, it probably won't in the not too distant future once x86-64 catches on. -

    Reasonable Security Record
    -

    Don't include software that has a terrible security record. Each vulnerability is a lot of work for a lot of people (security teams, arch teams and package maintainers). -

    diff --git a/keywording/text.xml b/keywording/text.xml index 2149f2d..a1dbed1 100644 --- a/keywording/text.xml +++ b/keywording/text.xml @@ -41,41 +41,33 @@ The different levels of keyword are: arch (x86, ppc-macos)
    -

    Both the package version and the ebuild are widely tested, known to work and not have any serious issues on the indicated platform. -

    ~arch (~x86, ~ppc-macos)
    -

    The package version and the ebuild are believed to work and do not have any known serious bugs, but more testing is required before the package version is considered suitable for arch. -

    No keyword
    -

    If a package has no keyword for a given arch, it means it is not known whether the package will work, or that insufficient testing has occurred for ~arch. -

    -arch (-x86, -ppc-macos)
    -

    The package version will not work on the arch. This could be caused by badly written code (for example, non-64-bit or endian clean code), relying upon particular hardware (for example, a BIOS querying tool would not work on non-BIOS architectures) or binary only packages. -

    diff --git a/tools-reference/tr/text.xml b/tools-reference/tr/text.xml index e7002e1..8a1a236 100644 --- a/tools-reference/tr/text.xml +++ b/tools-reference/tr/text.xml @@ -26,27 +26,21 @@ and only writes to standard output. Therefore, you will have to use Deleting characters
    -

    - To delete all occurrences of certain characters, use tr -d asdf. -

    + To delete all occurrences of certain characters, use tr -d asdf.
    Deleting repeated characters
    -

    - To replace repeated characters with a single character ('squeeze'), use - tr -s asdf. -

    + To replace repeated characters with a single character ('squeeze'), use + tr -s asdf.
    Transliterating characters
    -

    - To replace all 'a' characters with '1', all 'b' with '2' and all 'c' with - '3', use tr abc 123. -

    + To replace all 'a' characters with '1', all 'b' with '2' and all 'c' with + '3', use tr abc 123.
    -- cgit v1.2.3-65-gdbad