zsh-users
 help / color / mirror / code / Atom feed
From: Peter Stephenson <p.w.stephenson@ntlworld.com>
To: dominik.vogt@gmx.de, Zsh Users <zsh-users@zsh.org>
Subject: Re: Split manpages; technical question
Date: Mon, 15 Nov 2021 11:22:15 +0000 (GMT)	[thread overview]
Message-ID: <327519053.221388.1636975335223@mail2.virginmedia.com> (raw)
In-Reply-To: <YZJAfUc2tuADg/cR@gmx.de>

> On 15 November 2021 at 11:11 Dominik Vogt <dominik.vogt@gmx.de> 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


  reply	other threads:[~2021-11-15 11:22 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-11-15 11:11 Dominik Vogt
2021-11-15 11:22 ` Peter Stephenson [this message]
2021-11-16 18:38   ` Dominik Vogt

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=327519053.221388.1636975335223@mail2.virginmedia.com \
    --to=p.w.stephenson@ntlworld.com \
    --cc=dominik.vogt@gmx.de \
    --cc=zsh-users@zsh.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.vuxu.org/mirror/zsh/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).