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.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 19187 invoked from network); 15 Nov 2021 11:22:58 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 15 Nov 2021 11:22:58 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1636975378; b=T3EhCt92OngW/eFIh9rm5GivFAmtZoY7AiZ42MD3H+lJ03UDLyaBWEVXUwM9ULkRGO5IPgVK+c e6m5eflJlD/009m8tBWcH/89WUP/UdGjFvSpAHEwmwXye2bRRBvWe49iqSK1NuuIpSMW7w4wVR Lpu6HtuXY3+MunuDDrQ+Oj2pq/nwWOCGMtbfn7hrCYXk2rTG/CXo4WHFPieC3Gkp5OHJ/PtgN6 nBSOQ5YMapWOnWpB5t6XuQypg8SGwjDg/zvrzk4YGYoL4iEhrZr6/Ztm7L+t5QIKePqDLYRp9g Ffvn9dOg7g0R4fY0L6S8bPLkuD769pSYSX74delT8E8KAw==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (smtpq2.tb.ukmail.iss.as9143.net) smtp.remote-ip=212.54.57.97; dkim=pass header.d=ntlworld.com header.s=meg.feb2017 header.a=rsa-sha256; dmarc=pass header.from=ntlworld.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1636975378; bh=9/ERvZJ2DyCX+3Y3XyyMnZ6hR7haBLD56VQHqcmNaMk=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:Content-Type:MIME-Version:Subject: References:In-Reply-To:Message-ID:To:From:Date:DKIM-Signature: DKIM-Signature; b=j3GXGCgfA/a6EVjG80AKuEZ+b/oO5ByodAhLNBqxzOqSSazpaj23ctsIjg6X1uSaCWdMWRYhkv 5SALNPQCYAj4orVa8xIi956HLbQs5WC0V1zTSOhITdXakBVXUAz+ofjYPx1v2A1hNBe2HZ01BP KDLq5CfaVfZ88yu4dh8emaI0tatwSf7xdA37FoHS5c1CcgDlvCuVXKD0Tr7fSU5Q656MQ8+a3B eoiCJA858gy02OhuSdxiL7e93W2lt6+0hhen+aQ0D1wYd5ktlrbjjhAcT1PYHPTSiJCERzbSSD z2MSx3FksYLM5nivaBDEJddH0GJcpfnStaSL3K4EQ7XMUw==; 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: Content-Type:MIME-Version:Subject:References:In-Reply-To:Message-ID:To:From: Date:Reply-To:Cc:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=Hi7rRoOcqH0DgNtU62MPwdo9/CVv+c6kTVXb0a7h3xU=; b=SEAMb6OXaUi8X+SuGpSxnj4DT2 xmQf0BW2jINw0WjFhF4KtsKKfjoK20wObAfzgMaYlQKDt2ZyUO+xvL25e51ZUTj2UiKj2rr1irTkX CweL0ZbQkxt6MN2UDSo+y2Jh6zFkNvT0yEzO3OC5+b3KWMDxwyPMdt539HPxS9C0+dXKS/drp4mJB rKyDjbM7Aga76BehLqrbA+hsSnaBIujrePgQRttQvc8p5Xcjn9tca2nshudb8Ax/qj193yA2k6B03 OjuaZVZcsSvylvQsKSOKZCqNKZByFjnwxxi6g65WU4DJ2TYQEol6WHwmqpSoZ34jjjmz3fIJ/PEsK kQfcdoPA==; Received: from authenticated user by zero.zsh.org with local id 1mma4g-0006BK-89; Mon, 15 Nov 2021 11:22:58 +0000 Authentication-Results: zsh.org; iprev=pass (smtpq2.tb.ukmail.iss.as9143.net) smtp.remote-ip=212.54.57.97; dkim=pass header.d=ntlworld.com header.s=meg.feb2017 header.a=rsa-sha256; dmarc=pass header.from=ntlworld.com; arc=none Received: from smtpq2.tb.ukmail.iss.as9143.net ([212.54.57.97]:37790) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) id 1mma3z-0005TH-Lg; Mon, 15 Nov 2021 11:22:16 +0000 Received: from [212.54.57.81] (helo=smtp2.tb.ukmail.iss.as9143.net) by smtpq2.tb.ukmail.iss.as9143.net with esmtp (Exim 4.90_1) (envelope-from ) id 1mma3z-0004Ny-H3 for zsh-users@zsh.org; Mon, 15 Nov 2021 12:22:15 +0100 Received: from oxbe8.tb.ukmail.iss.as9143.net ([172.25.160.139]) by smtp2.tb.ukmail.iss.as9143.net with ESMTP id ma3zmpooGAVILma3zmHCxv; Mon, 15 Nov 2021 12:22:15 +0100 X-Env-Mailfrom: p.w.stephenson@ntlworld.com X-Env-Rcptto: zsh-users@zsh.org X-SourceIP: 172.25.160.139 X-CNFS-Analysis: v=2.4 cv=FaIkeby6 c=1 sm=1 tr=0 ts=619242e7 cx=a_exe a=pgSR3NrKiwmx/6vnWRL19w==:117 a=I_Av47A-8eYA:10 a=IkcTkHD0fZMA:10 a=vinPr5In5y8A:10 a=ky-2ETmmPDlmeiMIUw4A:9 a=QEXdDO2ut3YA:10 X-Authenticated-Sender: p.w.stephenson@ntlworld.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ntlworld.com; s=meg.feb2017; t=1636975335; bh=9/ERvZJ2DyCX+3Y3XyyMnZ6hR7haBLD56VQHqcmNaMk=; h=Date:From:To:In-Reply-To:References:Subject; b=iLWdKh8/rsZoIlxiW9RzRCP0moegj+Pt35veb+Zra45pRc+1N0GjjT2zvPxZsCJG9 h9hhpNF7rxwYgVDf0QzGmbCobak+87qpBhTuXrAXjjiBKTAgtI5R8g7Lmzpksj1mpu H3HwRM36g5v/1FSnw0JhyaxZB363U/D5PcmBH4uE/3+hGUnx1ukTjmGPsk5RSyM/xZ NbRDD3w/ifFdnnqWYEOmR1eLsppdx2KkU/DKMd+6GNtORy1CRXMsoBaB/fvxPvRXca CAKto9ZX56BeN21OOeG0PHL8nX2pc1+WC0aDa5SELutuDug2SevByVsvjOfqkVCayF 98/q4xGvB1PBQ== Date: Mon, 15 Nov 2021 11:22:15 +0000 (GMT) From: Peter Stephenson To: dominik.vogt@gmx.de, Zsh Users Message-ID: <327519053.221388.1636975335223@mail2.virginmedia.com> In-Reply-To: References: Subject: Re: Split manpages; technical question MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Priority: 3 Importance: Medium X-Mailer: Open-Xchange Mailer v7.8.4-Rev72 X-Originating-IP: 165.225.17.146 X-Originating-Client: open-xchange-appsuite X-CMAE-Envelope: MS4xfCenQWN9YDzSRlml/hOuaa7O+K8e68FPdZvY4AJbDEq5WufgxRTZry0U1BJYMkeD0D0PI5SM3iVrf/3XdM3uSGjmKhYzDvE47KL+Ro9EB+ZeVU+hiq5E 8+bxvDWtod+Y1/R3Owe1KISm0XEBnQlHp7sxjs3RnccjOkHtrh6D6zL+pS47PcOgP/r6uZ8M+gSgbzHi8ris4g+wEpeBy9ZvO2IGEDPJPi4pQfgFbnOX6Shb l9rjlHR/yhJLS2Ymc1QbDw== X-Seq: 27348 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 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. pws