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.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 65C3E138350 for ; Wed, 15 Jan 2020 21:30:06 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 89939E085A; Wed, 15 Jan 2020 21:30:04 +0000 (UTC) Received: from smtp.gentoo.org (dev.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 60EEEE085A for ; Wed, 15 Jan 2020 21:30:04 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 3E5DA34E0C8 for ; Wed, 15 Jan 2020 21:30:03 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id E2448B2 for ; Wed, 15 Jan 2020 21:29:59 +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: <1579123726.3a84fac87dd431fbfbdddf51dcf34e6bcc71b6c6.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: 3a84fac87dd431fbfbdddf51dcf34e6bcc71b6c6 X-VCS-Branch: master Date: Wed, 15 Jan 2020 21:29:59 +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: 57ff7d7d-7348-4dbe-b9eb-e2ff636c54ec X-Archives-Hash: 5f6e946c741dc5f748b5f4144285dbab commit: 3a84fac87dd431fbfbdddf51dcf34e6bcc71b6c6 Author: Ulrich Müller gentoo org> AuthorDate: Sat Jan 11 20:05:40 2020 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Wed Jan 15 21:28:46 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=3a84fac8 devbook-guide: Section on including sub-documents. Signed-off-by: Ulrich Müller gentoo.org> appendices/devbook-guide/text.xml | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml index 3b583f2..1e73104 100644 --- a/appendices/devbook-guide/text.xml +++ b/appendices/devbook-guide/text.xml @@ -122,6 +122,33 @@ any number of section elements of the next lower level. Skipping of levels is not allowed, e.g., a subsection cannot be directly below a chapter. + + + +Including sub-documents + + +

+The manual is organized as a tree. Each directory contains one document, which +can include multiple sub-documents using the <include href="foo/"/> +tag. Note that the trailing slash in the href value is mandatory. +

+ +

+A table of contents can be generated with <contentsTree>. +Typically, this tag would be the only element in its own section body, as in +the following example: +

+ + +<section> +<title>Contents</title> +<body> +<contentsTree/> +</body> +</section> + +