commit:     ebce25b336d5e27ec1efa8193b11de38f1c4030d
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Thu Oct 24 17:57:22 2024 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> 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 <ulm <AT> 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:
 </codesample>
 
 <p>
-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 <c>&lt;guide&gt;</c> tag <d/> the entire document is
 enclosed within a <c>&lt;guide&gt; &lt;/guide&gt;</c> pair. Its <c>self</c>
 attribute must point to the relative path of the document from the root node;
@@ -55,7 +55,7 @@ document.
 </p>
 
 <p>
-All tags must be closed of course, so the document ends with:
+All elements must be closed of course, so the document ends with:
 </p>
 
 <codesample lang="sgml">
@@ -126,7 +126,7 @@ tag. Note that the trailing slash in the <c>href</c> value 
is mandatory.
 
 <p>
 A table of contents can be generated with <c>&lt;contentsTree&gt;</c>.
-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:
 </p>
 

Reply via email to