From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.3 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 8781 invoked from network); 16 Nov 2021 18:41:55 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 16 Nov 2021 18:41:55 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1637088115; b=Y/l0pQ7Sy9WVur7JPLebz6eraT+K09pxx3vBDfYprm2fgY3FqjwiKfYBDMj7AR+3Qcae69Sepx l4Sk77qMoT/SF9oyDE2AH/4+KNeNeQGlQdXu79WJUxoe/59J4/3710srXfy7hjduzDPK5G8Fac /4GwYQVy2MLNHE9/YyfshU5CnxyZvEScpM4NzlPDMQiNSKy6rxWRCwc/dWhOAGEzS7h/b3GG+w 6f7mU/t7U/kLUCnPoTtEpOlHJrrlla0uk0uAuPz2L060Ko9j7ieRK4aVkPzNyaw6q5hfJFltgg oGuPFMbdO5AcUDfHqDmlKtIYS7cQqCAum5x0LyxFB614qQ==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mout.gmx.net) smtp.remote-ip=212.227.15.18; dkim=pass header.d=gmx.net header.s=badeba3b8450 header.a=rsa-sha256; dmarc=none header.from=gmx.de; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1637088115; bh=rO/nJBB/fIWuutkvb6R/5yB6VMJEjnxbKRjnm5bPQ4c=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:In-Reply-To:Content-Type: MIME-Version:References:Reply-To:Message-ID:Subject:To:From:Date: DKIM-Signature:DKIM-Signature; b=sf7TIEnTB+90HTgWjgVCQqHY6IstHXUw1wkHrIEsWNl+/N2E5QcP8YyDKA0yyz8DB85Yir4QZR s3A5c3wLOd/CGLKqEAIPEnjADRdvxvLubu2n0O3Lzsg6Xq3Cz66BK6s9VidtM5zqJb2ZSHN8nY 1IRTjcL94WU8TJNijHwCTexK9EWrccv6e4iWyPlW9ipzsK89Vdz5s6VeM28H8acxnwezxi+Qg6 KGgMbcAc641RfvNlwyXJmW7R4cQtwYQ8YCK7WrohDmTvR56sRfBQIG6WOGd2bCjeKcmS9FImP4 yWBo7FRrV7HfExcKjOQyY+kwS7zaLzDTGbpqUCZ23AzGZQ==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20210803; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:Content-Transfer-Encoding:In-Reply-To :Content-Type:MIME-Version:References:Reply-To:Message-ID:Subject:To:From: Date:Cc:Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID; bh=MNUvjbeP4xfGX9y4HxLJQ/kD3h6dq8X7JJIk3STKaOI=; b=jRKMwiaB9FBT1JV9oX56itto6A 5UQSmPkMOdWQLhYfgB83uzYss4TjDMNY0rx94Bma7ZpWrgS69nTE5NqKZ5NRC/dgNEaWP1IPuKCXQ eDmx8zsKIfmRNGH6Fl9o0bP2Gfm6mtfHXW3NqdE3rv5Wg3U7bLQhuQHKnxVgSPd2qwYWaZT5ykXag pXl9Z8CkZb/KUQiXKkkcyTfwh7vi+AmcGcQ5o+g/BXI1KxD6W3TkiI2uF63NQPcv2gcorO8bCHduH HEWvuwJJ1lj/8m25WOrR4nuSYH+PMeER9yQEwthBoqPCHog9emoakupqsi2SHH8UN9PDHkv/PosZH 5fW7gaiw==; Received: from authenticated user by zero.zsh.org with local id 1mn3Oz-0005Fk-Ix; Tue, 16 Nov 2021 18:41:53 +0000 Authentication-Results: zsh.org; iprev=pass (mout.gmx.net) smtp.remote-ip=212.227.15.18; dkim=pass header.d=gmx.net header.s=badeba3b8450 header.a=rsa-sha256; dmarc=none header.from=gmx.de; arc=none Received: from mout.gmx.net ([212.227.15.18]:46695) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_256_GCM_SHA384:256) id 1mn3ON-0004Yi-8E; Tue, 16 Nov 2021 18:41:15 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1637088074; bh=rO/nJBB/fIWuutkvb6R/5yB6VMJEjnxbKRjnm5bPQ4c=; h=X-UI-Sender-Class:Date:From:To:Subject:Reply-To:References: In-Reply-To; b=heGndoH1gHRT0ieyL0lwqmUPyMBpCmZO4ItFq7HD+Z+LU4h7NciD/BauUs8N6S+CL lql53IrRrfN8gwzba8TIk0/BLMZ0lUnSYQ4veWK5IWhbTLmd9gt9RKmkldF2w37F6d +Q7uYWReJDN7KQMGuwcmvtGLjJoiumqlD65WZYME= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Received: from zitrone.obstwiese ([46.223.163.233]) by mail.gmx.net (mrgmx004 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MHG8g-1mrOzS2Uqm-00DIUw for ; Tue, 16 Nov 2021 19:41:14 +0100 Received: from luthien by zitrone.obstwiese with local (Exim 4.94.2) (envelope-from ) id 1mn3Ln-0000bS-AR; Tue, 16 Nov 2021 19:38:35 +0100 Date: Tue, 16 Nov 2021 19:38:35 +0100 From: Dominik Vogt To: Zsh Users Subject: Re: Split manpages; technical question Message-ID: Reply-To: dominik.vogt@gmx.de Mail-Followup-To: Zsh Users References: <327519053.221388.1636975335223@mail2.virginmedia.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <327519053.221388.1636975335223@mail2.virginmedia.com> X-Provags-ID: V03:K1:jupgXq0kd31TywPIZYl1Fhr9O0XY4sinQ6+4HByOz31n2Ol7VOv Y0uP9TxvLxadTuQQeQoSOpfbz3AjhV31b5o+wIP4UG7B7BB95+BFeoggoAEkb3XElg13tga 7QLBq0LafbnxDrPAgyfAP160/d57jR7i1EctHm+osOIb4wi2d9TmGuYZ0xKkDNg/fEKALqF yj8kHgo4PHDu/J8Kw4hhg== X-UI-Out-Filterresults: notjunk:1;V03:K0:D41Q39pJkSY=:SU00zWVi0KAk91i9ukKwOz VSrFhtCWbP3oJcRver1p1Cj4JqEs66E5KaKSdyy3W7Xskjr03UVabtVVm9ECGg+D+Ptkt17BE HTdgwK1LgJOo+Vtf+fB6vnadCUZF1U23H7vidRS2FSrsHCAJNDNF4J3yvER2xoMq21DX6N27d AXuWVi4V3WynHHcBrQXwvDDINJ6ruA5RsTjuPdbRzk3ZCXgQ7KUN6H5vBuCx007SCOQALgydf YqDyKWDW+J4sGmbyiNg+iVkhlYC3+Q6U8e1MoCYNV7cOcU8DQLNVt2GEGXthQ6EK+rMatpFbL EPveQXoHjtusFJ+QaR/zLKY3sgH4FiQpdU5ytpjEkUlCu6VwkEBw1cU1N65vpino8u/2R7hG9 nvRmX0wzxr8d63uDfLzaz1+xydoQMXau5X/vUGKbiMs45/1Qfq9F454p6lbD0yghE4AYqsp1V SxXDIYo4RDIF0gYon+EqgLPlhPWOMgx9BCM7xK5nRVMZ2qQ7Y/rLOidxt7yFlhxEs0jlUaN4C om6GK+p4AFoK/7y4RlPUUkzfKs7rY19MTetmRAgFesse3ZJpVFUFVDWIFI2iP2lpTx3A2ezUX 2DVsDS1QiactG154HtaFmhxHBzssFbiuZLCT9aoIX/o44DwWqhIMQjxH86R9Nd+LGHZqC+n4N boCkhaYgt11wfNzMn2cvPM74zhrlgWiv3TpBNrGSk6BFnTjYTrffslWMBV27UAoxb42Brbwan E1iPfZR1qUeDIvtSTydkG0KOAdoozqbO8WqDK+6KHp8oiNutsYYB5Tm/pw4SHRzGARt5iKYaa 3LInlMgTNkTZME0WXB5UEjHAks6VRLYWDBziISglQJboQDiM8EHTsh9MIpeqx5wMfdOXvJHbn e0+1mU4w9VSFe46K5Adv8WKXriUxWlV14QWpEt9Wgyz8IMO58VY8+5GalhmUBRLhaygHmRGOp gE4DkBijXvsaBM0FENu6PrXqiTYfXtrGuELUC5tgMP7pp1EWUT0CIlnqGg+2XtjNpD3p+buch 3j/18APEjislDLsxgdu1tWF9JAt9r4RYoode1I6qEpsMrpYGlv+S0zvP+roVRCaj5F6JNKdFM XPPBXxSznUlgWE= Content-Transfer-Encoding: quoted-printable X-Seq: 27351 Archived-At: X-Loop: zsh-users@zsh.org Errors-To: zsh-users-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-users-request@zsh.org X-no-archive: yes List-Id: List-Help: List-Subscribe: List-Unsubscribe: List-Post: List-Owner: List-Archive: On Mon, Nov 15, 2021 at 11:22:15AM +0000, Peter Stephenson wrote: > > On 15 November 2021 at 11:11 Dominik Vogt wrote: > > This is more of a development question. How do you manage the > > split man pages internally? I guess the split pages and the > > monolothic "zshall" page are all generated from the same sources? > > Is it one source file that is split into several pages, or several > > sources that are combined into a single page? What tools do you > > use for that, are there any pitfalls? > > > > (Background is that we finally want to split the fvwm man page > > because it has become too big, but have zero experience with > > that.) > > It's done from separate Yodl sources, i.e. the inputs are all > split. The structure is fairly clear from the source distribution, > even if you don't want to know the details of the processing. > So this probably doesn't help you a great deal unless you want > to move to Yodl --- which is a big job and not a very standard > format, although it's served us pretty well. > > The zshall page is basically just the separate sources pasted > together, yes. Thanks. We're using asciidoc, which is a bit tricky and less structured when dealing with nested structures. It's much easier than thought. Ciao Dominik ^_^ ^_^ =2D- Dominik Vogt