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 B352E138334 for ; Mon, 9 Dec 2019 21:40:02 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id EFF70E0909; Mon, 9 Dec 2019 21:40:01 +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 619E5E08F0 for ; Mon, 9 Dec 2019 21:40:01 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (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 631C634D8C9 for ; Mon, 9 Dec 2019 21:40:00 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id C3843902 for ; Mon, 9 Dec 2019 21:39:56 +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: <1575804725.6a1c35efce4347c22c94680e39a84d3f1df794d0.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master 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: 6a1c35efce4347c22c94680e39a84d3f1df794d0 X-VCS-Branch: master Date: Mon, 9 Dec 2019 21:39:56 +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: 2c1d4bdb-9cd0-40d6-8a95-4750f4f5675d X-Archives-Hash: 65711bb4a20e8f4f567b8f007ab690aa commit: 6a1c35efce4347c22c94680e39a84d3f1df794d0 Author: Ulrich Müller gentoo org> AuthorDate: Wed Dec 4 17:25:41 2019 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Sun Dec 8 11:32:05 2019 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=6a1c35ef devbook-guide: Don't mention caption as attribute of
.

Signed-off-by: Ulrich Müller  gentoo.org>

 appendices/contributing/devbook-guide/text.xml | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/appendices/contributing/devbook-guide/text.xml b/appendices/contributing/devbook-guide/text.xml
index 5aa5525..672a083 100644
--- a/appendices/contributing/devbook-guide/text.xml
+++ b/appendices/contributing/devbook-guide/text.xml
@@ -189,7 +189,7 @@ This is a paragraph.  <path>/etc/passwd</path> is a file.
 Type <c>ls</c> if you feel like it.  I <e>really</e> want to go to sleep now.
 </p>
 
-<pre caption="Code Sample">
+<pre>
 This is text output or code.
 # <i>this is user input</i>
 
@@ -257,12 +257,11 @@ only tags that should appear immediately inside a <body> element.
 Another thing -- these tags should not be stacked -- in other words,
 don't put a <note> element inside a <p> element. As
 you might guess, the <pre> element preserves its whitespace
-exactly, making it well-suited for code excerpts.  You must name the
-<pre> tag with a caption attribute:
+exactly, making it well-suited for code excerpts:
 

-<pre caption="Output of uptime"> +<pre> # <i>uptime</i> 16:50:47 up 164 days, 2:06, 5 users, load average: 0.23, 0.20, 0.25 </pre> @@ -551,8 +550,8 @@ and the attribute value. As an example:

-Wrong : <pre caption = "Attributes"> -Correct: <pre caption="Attributes"> +Wrong : <uri link = "https://forums.gentoo.org/"> +Correct: <uri link="https://forums.gentoo.org/"> @@ -580,10 +579,6 @@ with a capital letter. </ul>
-

-Code Listings should always have a caption. -

-

Try to use <uri> with the link attribute as much as possible. In other words, the Gentoo