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.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id AC70F158042 for ; Fri, 25 Oct 2024 11:21:48 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id CD6FAE0855; Fri, 25 Oct 2024 11:21:47 +0000 (UTC) Received: from smtp.gentoo.org (woodpecker.gentoo.org [140.211.166.183]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id B189CE0855 for ; Fri, 25 Oct 2024 11:21:47 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id AF7833430C5 for ; Fri, 25 Oct 2024 11:21:46 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 1C5331295 for ; Fri, 25 Oct 2024 11:21:45 +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: <1729792642.ebce25b336d5e27ec1efa8193b11de38f1c4030d.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: ebce25b336d5e27ec1efa8193b11de38f1c4030d X-VCS-Branch: master Date: Fri, 25 Oct 2024 11:21:45 +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: aaa81597-58e8-4fbd-8837-625ec1e8222e X-Archives-Hash: 64598c64b86bf98393d435a046365502 commit: ebce25b336d5e27ec1efa8193b11de38f1c4030d Author: Ulrich Müller gentoo org> AuthorDate: Thu Oct 24 17:57:22 2024 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Thu Oct 24 17:57:22 2024 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=ebce25b3 devbook-guide: Clarify use of the term "tag" - The XML declaration is not a tag. - A tag cannot be closed; an element can (by a closing tag). Signed-off-by: Ulrich Müller gentoo.org> appendices/devbook-guide/text.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml index c725307..b853b0b 100644 --- a/appendices/devbook-guide/text.xml +++ b/appendices/devbook-guide/text.xml @@ -40,7 +40,7 @@ used in a DevBook XML document:

-On the first lines, we see the requisite tag that identifies this as an XML +On the first lines, we see the XML declaration that identifies this as an XML document. Next, there's a <guide> tag the entire document is enclosed within a <guide> </guide> pair. Its self attribute must point to the relative path of the document from the root node; @@ -55,7 +55,7 @@ document.

-All tags must be closed of course, so the document ends with: +All elements must be closed of course, so the document ends with:

@@ -126,7 +126,7 @@ tag. Note that the trailing slash in the href value is mandatory.

A table of contents can be generated with <contentsTree>. -Typically, this tag would be the only element in its own section body, as in +Typically, this would be the only element in its own section body, as in the following example: