From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id AFFB7138350 for ; Wed, 15 Jan 2020 21:30:21 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id EC83DE0866; Wed, 15 Jan 2020 21:30:20 +0000 (UTC) Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id C6ED0E0866 for ; Wed, 15 Jan 2020 21:30:20 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 4C5DA34DC3D for ; Wed, 15 Jan 2020 21:30:04 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 27414B6 for ; Wed, 15 Jan 2020 21:30:00 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1579123728.e01f0401b79a3de5a0bb29e98918ee72cef249c7.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: appendices/devbook-guide/ X-VCS-Repository: proj/devmanual X-VCS-Files: appendices/devbook-guide/text.xml X-VCS-Directories: appendices/devbook-guide/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: e01f0401b79a3de5a0bb29e98918ee72cef249c7 X-VCS-Branch: master Date: Wed, 15 Jan 2020 21:30:00 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: effc0848-199f-4ec4-8cfa-95fe7dc835c8 X-Archives-Hash: bfb9e87233cb78f76a48ead3c859b775 commit: e01f0401b79a3de5a0bb29e98918ee72cef249c7 Author: Ulrich Müller gentoo org> AuthorDate: Wed Jan 15 21:25:12 2020 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Wed Jan 15 21:28:48 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=e01f0401 devbook-guide: Update "Internal Coding Style" section. Describe only the tags that are actually used in DevBook XML. Signed-off-by: Ulrich Müller gentoo.org> appendices/devbook-guide/text.xml | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml index 35ecace..b14a2a7 100644 --- a/appendices/devbook-guide/text.xml +++ b/appendices/devbook-guide/text.xml @@ -546,11 +546,11 @@ Both sections are described next.

Newlines must be placed immediately after every DevBook XML tag (both opening as closing), except for: -<version>, <date>, <title>, -<th>, <ti>, -<li>, <i>, <e>, -<uri>, <path>, <b>, <c>, -<mail>. +<title>, +<th>, <ti>, <li>, +<dt>, <dd>, +<b>, <c>, <e>, <d/>, +<uri>.

@@ -564,11 +564,12 @@ Both sections are described next.

Word-wrapping must be applied at 80 characters except inside -<pre>. You may only deviate from this rule when there is no other -choice (for instance when a URL exceeds the maximum amount of characters). The -editor must then wrap whenever the first whitespace occurs. You should try to -keep the rendered content of <pre> elements within 80 -columns to help console users. +<pre> and <codesample>. You may only deviate from +this rule when there is no other choice (for instance when a URL exceeds the +maximum amount of characters). The editor must then wrap whenever the first +whitespace occurs. You should try to keep the rendered content of +<pre> and <codesample> elements within 80 columns +to help console users.