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 7320B1382C5 for ; Fri, 19 Mar 2021 19:23:50 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id A6DE3E086E; Fri, 19 Mar 2021 19:23:49 +0000 (UTC) Received: from smtp.gentoo.org (smtp.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 8FE92E086E for ; Fri, 19 Mar 2021 19:23:49 +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 A464D33BE4D for ; Fri, 19 Mar 2021 19:23:48 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 4B6285A7 for ; Fri, 19 Mar 2021 19:23:47 +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: <1616181579.91b323cd575dff579191a767190e9d56ff255d44.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: 91b323cd575dff579191a767190e9d56ff255d44 X-VCS-Branch: master Date: Fri, 19 Mar 2021 19:23:47 +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: 778744e0-09e6-457a-bae2-955c0c074e5b X-Archives-Hash: f2246cc708b02d8d058a456e26e54972 commit: 91b323cd575dff579191a767190e9d56ff255d44 Author: Ulrich Müller gentoo org> AuthorDate: Fri Mar 12 17:51:37 2021 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Fri Mar 19 19:19:39 2021 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=91b323cd devbook-guide: Clearer section structure Drop the "Devbook XML" section header which was not very useful. Instead, promote "Basic structure" from subsection to section, and introduce two new sections "Body elements" and "Inline elements". So, the resulting section structure is: DevBook XML design goals Basic structure Sections and subsections Including sub-documents An example Body elements Code samples and colour-coding Figures Tables Lists Inline elements , , and Intra-document references Coding Style Internal Coding Style External Coding Style Signed-off-by: Ulrich Müller gentoo.org> appendices/devbook-guide/text.xml | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml index 28fbacd..64d1178 100644 --- a/appendices/devbook-guide/text.xml +++ b/appendices/devbook-guide/text.xml @@ -24,8 +24,6 @@ documents.
-Devbook XML - Basic structure @@ -71,7 +69,7 @@ All tags must be closed of course, so the document ends with: - + Sections and subsections @@ -221,8 +219,10 @@ This is a warning. - -The <body> tags +
+ +
+Body elements

@@ -248,7 +248,7 @@ preserve their whitespace exactly, making them well-suited for code excerpts: - + Code samples and colour-coding @@ -454,6 +454,10 @@ together: +

+ +
+Inline elements <c>, <b>, and <e>