commit: ecc2c5953a5523ab3f4d9709066042c124bf40fc Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> AuthorDate: Sat Apr 16 07:16:43 2022 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Sun Nov 5 16:47:49 2023 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=ecc2c595
devbook-guide: Document the todo element Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> appendices/devbook-guide/text.xml | 29 ++++++++++++++++++++--------- 1 file changed, 20 insertions(+), 9 deletions(-) diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml index 484a230..5015f0b 100644 --- a/appendices/devbook-guide/text.xml +++ b/appendices/devbook-guide/text.xml @@ -178,6 +178,11 @@ This is important. <warning> This is a warning. </warning> + +<todo> +Text inside a <c>todo</c> element will appear in the +<uri link="::appendices/todo-list/"/>. +</todo> </codesample> <p> @@ -212,6 +217,11 @@ This is important. This is a warning. </warning> +<todo> +Text inside a <c>todo</c> element will appear in the +<uri link="::appendices/todo-list/"/>. +</todo> + </body> </subsection> </section> @@ -224,15 +234,16 @@ This is a warning. We introduced a lot of new tags in the previous section <d/> here's what you need to know. The <c><p></c> (paragraph), <c><pre></c> (preformatted block), <c><codesample></c> (code block), -<c><note></c>, <c><important></c> and <c><warning></c> tags -all can contain one or more lines of text. Besides the <c><figure></c>, -<c><table></c>, <c><ul></c>, <c><ol></c> -and <c><dl></c> elements (which we'll cover in just a bit), these are the -only tags that should appear immediately inside a <c><body></c> element. -Another thing <d/> these tags <e>should not</e> be stacked <d/> in other words, -don't put a <c><note></c> element inside a <c><p></c> element. As -you might guess, the <c><pre></c> and <c><codesample></c> elements -preserve their whitespace exactly, making them well-suited for code excerpts: +<c><note></c>, <c><important></c>, <c><warning></c> and +<c><todo></c> tags all can contain one or more lines of text. +Besides the <c><figure></c>, <c><table></c>, <c><ul></c>, +<c><ol></c> and <c><dl></c> elements (which we'll cover in just +a bit), these are the only tags that should appear immediately inside a +<c><body></c> element. Another thing <d/> these tags <e>should not</e> +be stacked <d/> in other words, don't put a <c><note></c> element inside +a <c><p></c> element. As you might guess, the <c><pre></c> and +<c><codesample></c> elements preserve their whitespace exactly, making +them well-suited for code excerpts: </p> <codesample lang="sgml"><!-- Named <pre> -->
