From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 06DC5158089 for ; Sun, 5 Nov 2023 16:48:45 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 4E8A12BC013; Sun, 5 Nov 2023 16:48:44 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 352132BC013 for ; Sun, 5 Nov 2023 16:48:44 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 78129335CCD for ; Sun, 5 Nov 2023 16:48:43 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 15EFDC3D for ; Sun, 5 Nov 2023 16:48:42 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1699202869.ecc2c5953a5523ab3f4d9709066042c124bf40fc.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: appendices/devbook-guide/ X-VCS-Repository: proj/devmanual X-VCS-Files: appendices/devbook-guide/text.xml X-VCS-Directories: appendices/devbook-guide/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: ecc2c5953a5523ab3f4d9709066042c124bf40fc X-VCS-Branch: master Date: Sun, 5 Nov 2023 16:48:42 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 187cd32b-7e68-4670-a122-f614917ecb61 X-Archives-Hash: 281627ff4bb67fb6eb296047da57a5a9 commit: ecc2c5953a5523ab3f4d9709066042c124bf40fc Author: Ulrich Müller gentoo org> AuthorDate: Sat Apr 16 07:16:43 2022 +0000 Commit: Ulrich Müller gentoo 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 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>

@@ -212,6 +217,11 @@ This is important. This is a warning. + +Text inside a todo element will appear in the +. + + @@ -224,15 +234,16 @@ This is a warning. We introduced a lot of new tags in the previous section here's what you need to know. The <p> (paragraph), <pre> (preformatted block), <codesample> (code block), -<note>, <important> and <warning> tags -all can contain one or more lines of text. Besides the <figure>, -<table>, <ul>, <ol> -and <dl> elements (which we'll cover in just a bit), these are the -only tags that should appear immediately inside a <body> element. -Another thing these tags should not be stacked in other words, -don't put a <note> element inside a <p> element. As -you might guess, the <pre> and <codesample> elements -preserve their whitespace exactly, making them well-suited for code excerpts: +<note>, <important>, <warning> and +<todo> tags all can contain one or more lines of text. +Besides the <figure>, <table>, <ul>, +<ol> and <dl> elements (which we'll cover in just +a bit), these are the only tags that should appear immediately inside a +<body> element. Another thing these tags should not +be stacked in other words, don't put a <note> element inside +a <p> element. As you might guess, the <pre> and +<codesample> elements preserve their whitespace exactly, making +them well-suited for code excerpts: