Gentoo Archives: gentoo-commits

From: "Ulrich Müller" <ulm@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] proj/devmanual:master commit in: appendices/contributing/devbook-guide/
Date: Thu, 26 Dec 2019 21:36:21
Message-Id: 1577392828.88fdd7e242a75846bd149c5e6c02d804701d58e6.ulm@gentoo
1 commit: 88fdd7e242a75846bd149c5e6c02d804701d58e6
2 Author: Ulrich Müller <ulm <AT> gentoo <DOT> org>
3 AuthorDate: Thu Dec 26 19:28:37 2019 +0000
4 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
5 CommitDate: Thu Dec 26 20:40:28 2019 +0000
6 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=88fdd7e2
7
8 Revert "appendices/contributing/devbook-guide: remove information on definition lists"
9
10 This reverts commit a1cad38db2fa2096b1161bf5a6ec85048d5a3a74.
11
12 Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
13
14 appendices/contributing/devbook-guide/text.xml | 47 ++++++++++++++++++++++++++
15 1 file changed, 47 insertions(+)
16
17 diff --git a/appendices/contributing/devbook-guide/text.xml b/appendices/contributing/devbook-guide/text.xml
18 index d39e794..5af7226 100644
19 --- a/appendices/contributing/devbook-guide/text.xml
20 +++ b/appendices/contributing/devbook-guide/text.xml
21 @@ -430,6 +430,53 @@ that you can have lists inside lists. Don't forget that you are writing XML and
22 that you must close all tags including list items unlike in HTML.
23 </p>
24
25 +<p>
26 +Definition lists (<c>&lt;dl&gt;</c>) are also supported. Please note that
27 +neither the definition term tag (<c>&lt;dt&gt;</c>) nor the definition data tag
28 +(<c>&lt;dd&gt;</c>) accept any other block level tag such as paragraphs or
29 +admonitions. A definition list comprises:
30 +</p>
31 +
32 +<dl>
33 + <dt><c>&lt;dl&gt;</c></dt>
34 + <dd>A <b>D</b>efinition <b>L</b>ist Tag containing</dd>
35 + <dt><c>&lt;dt&gt;</c></dt>
36 + <dd>Pairs of <b>D</b>efinition <b>T</b>erm Tags</dd>
37 + <dt><c>&lt;dd&gt;</c></dt>
38 + <dd>and <b>D</b>efinition <b>D</b>ata Tags</dd>
39 +</dl>
40 +
41 +<p>
42 +The following list copied from <uri
43 +link="http://www.w3.org/TR/REC-html40/struct/lists.html">w3.org</uri> shows
44 +that a definition list can contain ordered and unordered lists. It may not
45 +contain another definition list though.
46 +</p>
47 +
48 +<dl>
49 + <dt><b>The ingredients:</b></dt>
50 + <dd>
51 + <ul>
52 + <li>100 g. flour</li>
53 + <li>10 g. sugar</li>
54 + <li>1 cup water</li>
55 + <li>2 eggs</li>
56 + <li>salt, pepper</li>
57 + </ul>
58 + </dd>
59 + <dt><b>The procedure:</b></dt>
60 + <dd>
61 + <ol>
62 + <li>Mix dry ingredients thoroughly</li>
63 + <li>Pour in wet ingredients</li>
64 + <li>Mix for 10 minutes</li>
65 + <li>Bake for one hour at 300 degrees</li>
66 + </ol>
67 + </dd>
68 + <dt><b>Notes:</b></dt>
69 + <dd>The recipe may be improved by adding raisins</dd>
70 +</dl>
71 +
72 </body>
73 </subsection>
74 <subsection>