[gentoo-commits] proj/devmanual:devbook-guide commit in: appendices/contributing/devbook-guide/

["Göktürk Yüksek" <gokturk@gentoo.org>]

commit:     9409ed6f32c3e5148b1c77c62862916a747c7b6e
Author:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
AuthorDate: Sat Jul 29 20:41:16 2017 +0000
Commit:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Sat Jul 29 20:41:16 2017 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=9409ed6f

appendices/contributing/devbook-guide: remove the <comment> tag

It has no use in devmanual.

 appendices/contributing/devbook-guide/text.xml | 23 +++--------------------
 1 file changed, 3 insertions(+), 20 deletions(-)

diff --git a/appendices/contributing/devbook-guide/text.xml b/appendices/contributing/devbook-guide/text.xml
index 971dddd..85a3390 100644
--- a/appendices/contributing/devbook-guide/text.xml
+++ b/appendices/contributing/devbook-guide/text.xml
@@ -218,8 +218,6 @@ This is text output or code.
 
 Make HTML/XML easier to read by using selective emphasis:
 &lt;foo&gt;&lt;i&gt;bar&lt;/i&gt;&lt;/foo&gt;
-
-&lt;comment&gt;(This is how to insert a comment into a code block)&lt;/comment&gt;
 &lt;/pre&gt;
 
 &lt;note&gt;
@@ -251,8 +249,6 @@ This is text output or code.
 
 Make HTML/XML easier to read by using selective emphasis:
 &lt;foo&gt;<i>bar</i>&lt;/foo&gt;
-
-<comment>(This is how to insert a comment into a code block)</comment>
 </pre>
 
 <note>
@@ -511,7 +507,7 @@ GuideXML-tag (both opening as closing), except for:
 <c>&lt;th&gt;</c>, <c>&lt;ti&gt;</c>,
 <c>&lt;li&gt;</c>, <c>&lt;i&gt;</c>, <c>&lt;e&gt;</c>,
 <c>&lt;uri&gt;</c>, <c>&lt;path&gt;</c>, <c>&lt;b&gt;</c>, <c>&lt;c&gt;</c>, 
-<c>&lt;comment&gt;</c>, <c>&lt;mail&gt;</c>.
+<c>&lt;mail&gt;</c>.
 </p>
 
 <p>
@@ -578,8 +574,8 @@ and the attribute value. As an example:
 </p>
 
 <pre caption="Attributes">
-<comment>Wrong  :</comment>     &lt;pre caption = "Attributes"&gt;
-<comment>Correct:</comment>     &lt;pre caption="Attributes"&gt;
+Wrong  :     &lt;pre caption = "Attributes"&gt;
+Correct:     &lt;pre caption="Attributes"&gt;
 </pre>
 
 </body>
@@ -617,19 +613,6 @@ possible. In other words, the <uri link="http://forums.gentoo.org">Gentoo
 Forums</uri> is preferred over <uri>http://forums.gentoo.org</uri>.
 </p>
 
-<p>
-When you comment something inside a <c>&lt;pre&gt;</c> construct, use
-<c>&lt;comment&gt;</c> and parentheses or the comment marker for the language
-that is being used (<c>#</c> for bash scripts and many other things, <c>//</c>
-for C code, etc.) Also place the comment <e>before</e> the subject of the
-comment.
-</p>
-
-<pre caption="Comment example">
-<comment>(Substitute "john" with your user name)</comment>
-# <i>id john</i>
-</pre>
-
 </body>
 </section>
 </chapter>