aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2024-10-24 19:57:22 +0200
committerUlrich Müller <ulm@gentoo.org>2024-10-24 19:57:22 +0200
commitebce25b336d5e27ec1efa8193b11de38f1c4030d (patch)
treed202cc32f548c761fbc5323943dcf66d9ecce0f9
parent.github/workflows/devmanual-ci.yml: Update to actions/checkout@v4 (diff)
downloaddevmanual-ebce25b336d5e27ec1efa8193b11de38f1c4030d.tar.gz
devmanual-ebce25b336d5e27ec1efa8193b11de38f1c4030d.tar.bz2
devmanual-ebce25b336d5e27ec1efa8193b11de38f1c4030d.zip
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@gentoo.org>
-rw-r--r--appendices/devbook-guide/text.xml6
1 files 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>