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

[Ulrich Müller]

commit:     491304c07ca6951359d417add04d3a503cb47ed0
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Thu Dec 26 19:34:57 2019 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Thu Dec 26 20:40:28 2019 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=491304c0

appendices/contributing/devbook-guide: Update <dl> description.

We currently don't allow other lists inside definition lists.
Note that multiple dd following each dt are allowed.

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

 appendices/contributing/devbook-guide/text.xml | 35 ++------------------------
 1 file changed, 2 insertions(+), 33 deletions(-)

diff --git a/appendices/contributing/devbook-guide/text.xml 
b/appendices/contributing/devbook-guide/text.xml
index 5af7226..7c59ed4 100644
--- a/appendices/contributing/devbook-guide/text.xml
+++ b/appendices/contributing/devbook-guide/text.xml
@@ -441,40 +441,9 @@ admonitions. A definition list comprises:
   <dt><c>&lt;dl&gt;</c></dt>
   <dd>A <b>D</b>efinition <b>L</b>ist Tag containing</dd>
   <dt><c>&lt;dt&gt;</c></dt>
-  <dd>Pairs of <b>D</b>efinition <b>T</b>erm Tags</dd>
+  <dd><b>D</b>efinition <b>T</b>erm Tags,</dd>
   <dt><c>&lt;dd&gt;</c></dt>
-  <dd>and <b>D</b>efinition <b>D</b>ata Tags</dd>
-</dl>
-
-<p>
-The following list copied from <uri
-link="http://www.w3.org/TR/REC-html40/struct/lists.html";>w3.org</uri> shows
-that a definition list can contain ordered and unordered lists. It may not
-contain another definition list though.
-</p>
-
-<dl>
-  <dt><b>The ingredients:</b></dt>
-  <dd>
-    <ul>
-      <li>100 g. flour</li>
-      <li>10 g. sugar</li>
-      <li>1 cup water</li>
-      <li>2 eggs</li>
-      <li>salt, pepper</li>
-    </ul>
-  </dd>
-  <dt><b>The procedure:</b></dt>
-  <dd>
-    <ol>
-      <li>Mix dry ingredients thoroughly</li>
-      <li>Pour in wet ingredients</li>
-      <li>Mix for 10 minutes</li>
-      <li>Bake for one hour at 300 degrees</li>
-    </ol>
-  </dd>
-  <dt><b>Notes:</b></dt>
-  <dd>The recipe may be improved by adding raisins</dd>
+  <dd>each followed by one or more <b>D</b>efinition <b>D</b>ata Tags.</dd>
 </dl>
 
 </body>