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 3B0D4138334 for ; Sun, 23 Sep 2018 14:54:34 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id DF846E089C; Sun, 23 Sep 2018 14:54:32 +0000 (UTC) Received: from smtp.gentoo.org (dev.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 9D427E089C for ; Sun, 23 Sep 2018 14:54:32 +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 C0F72335CC7 for ; Sun, 23 Sep 2018 14:54:29 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id ED5C53E2 for ; Sun, 23 Sep 2018 14:54:27 +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: <1537712600.f568823a1bca21f40a402588871e6396df9322ad.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:devbook-guide commit in: appendices/contributing/devbook-guide/ X-VCS-Repository: proj/devmanual X-VCS-Files: appendices/contributing/devbook-guide/text.xml X-VCS-Directories: appendices/contributing/devbook-guide/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: f568823a1bca21f40a402588871e6396df9322ad X-VCS-Branch: devbook-guide Date: Sun, 23 Sep 2018 14:54:27 +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-Archives-Salt: 898f865d-c74a-4763-bcfe-a3fd0bb9f284 X-Archives-Hash: aa1170ddddd6e491ecdc9b8bc2bf990b commit: f568823a1bca21f40a402588871e6396df9322ad Author: Ulrich Müller gentoo org> AuthorDate: Sun Sep 23 14:23:20 2018 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Sun Sep 23 14:23:20 2018 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=f568823a appendices/contributing/devbook-guide: Change
 to .

 appendices/contributing/devbook-guide/text.xml | 32 +++++++++++++-------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/appendices/contributing/devbook-guide/text.xml b/appendices/contributing/devbook-guide/text.xml
index 42865d5..564e29d 100644
--- a/appendices/contributing/devbook-guide/text.xml
+++ b/appendices/contributing/devbook-guide/text.xml
@@ -38,7 +38,7 @@ Let's start learning the GuideXML syntax.  We'll start with the the initial
 tags used in a GuideXML document:
 

-
+
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 <!-- $Header$ -->
@@ -63,7 +63,7 @@ using GuideXML.
 
 <version>1</version>
 <date>2011-11-29</date>
-
+

On the first lines, we see the requisite tag that identifies this as an XML @@ -135,7 +135,7 @@ link="#doc_chap2_pre1">previous excerpt and append a guide document:

-
+
 <chapter>
 <title>This is my chapter</title>
 <section>
@@ -149,7 +149,7 @@ guide document:
 </body>
 </section>
 </chapter>
-
+

Above, I set the chapter title by adding a child <title> @@ -180,7 +180,7 @@ Now, it's time to learn how to mark up actual content. Here's the XML code for an example <body> element:

-
+
 <p>
 This is a paragraph.  <path>/etc/passwd</path> is a file.
 <uri>http://forums.gentoo.org</uri> is my favorite website.
@@ -206,7 +206,7 @@ This is a warning.
 <impo>
 This is important.
 </impo>
-
+

Now, here's how the <body> element above is rendered: @@ -218,13 +218,13 @@ This is a paragraph. /etc/passwd is a file. Type ls if you feel like it. I really want to go to sleep now.

-
+
 This is text output or code.
 # this is user input
 
 Make HTML/XML easier to read by using selective emphasis:
 <foo>bar</foo>
-
+ This is a note. @@ -259,12 +259,12 @@ exactly, making it well-suited for code excerpts. You must name the <pre> tag with a caption attribute:

-
+
 <pre caption="Output of uptime">
 # <i>uptime</i>
 16:50:47 up 164 days,  2:06,  5 users,  load average: 0.23, 0.20, 0.25
 </pre>
-
+ @@ -522,7 +522,7 @@ the content. An example for indentation is:

-
+
 <table>
 <tr>
   <th>Foo</th>
@@ -541,17 +541,17 @@ An example for indentation is:
   <li>First option</li>
   <li>Second option</li>
 </ul>
-
+

Attributes may not have spaces in between the attribute, the "=" mark, and the attribute value. As an example:

-
+
 Wrong  :     <pre caption = "Attributes">
 Correct:     <pre caption="Attributes">
-
+ @@ -571,12 +571,12 @@ Every sentence, including those inside tables and listings, should start with a capital letter.

-
+
 <ul>
   <li>No period</li>
   <li>With period. Multiple sentences, remember?</li>
 </ul>
-
+

Code Listings should always have a caption.