From: Richard Coleman <coleman@math.gatech.edu>
To: zsh-users@math.gatech.edu (ZSH Mailing List)
Subject: Re: Man pages missing
Date: Thu, 30 Jan 1997 18:14:04 -0500 [thread overview]
Message-ID: <199701302314.SAA14604@redwood.skiles.gatech.edu> (raw)
In-Reply-To: Your message of "Thu, 30 Jan 1997 16:32:11 CST." <199701302232.QAA04207@ftms.ftms.com>
> Is it me, or has the documentation become a rat's nest, i.e., g/n/troff,
> TeX, texinfo and now yodl? Just what we need, another text formatting
> package to learn. :-) Sorry to sound negative, but when is the progression
> of manual preparation going to stick with one package? If I run across
> something in the manual that needs clarification, all I can do is send a
> message to the mail list indicating what needs to be changed, instead of
> including a diff file with the changes. It means more work for someone
> else, but to me the zsh manual is a bit much. A manual that has nroff,
> TeX and texinfo commands all wrapped within yodl commands. What a nightmare,
> at least for me. I've never heard of yodl before.
But yodl is an attempt to bring order to this mess. We've been
searching for some time for a set of tools and meta-document format
that would allow us to generate all the formats necessary, while
maintaining only one document base. I researched the problem
when I was maintainer of zsh, but I couldn't find a solid (and
free) solution. Yodl is fairly new, but appears to be the best
solution so far.
rc
next prev parent reply other threads:[~1997-01-30 23:29 UTC|newest]
Thread overview: 26+ messages / expand[flat|nested] mbox.gz Atom feed top
1997-01-30 22:32 Vidiot
1997-01-30 23:14 ` Richard Coleman [this message]
1997-01-30 23:28 ` Zefram
1997-01-31 4:18 ` Vidiot
1997-01-31 4:57 ` Hrvoje Niksic
1997-01-31 5:47 ` Vidiot
1997-01-31 7:18 ` Hrvoje Niksic
1997-01-31 15:26 ` Vidiot
1997-01-31 16:10 ` James B. Crigler
1997-01-31 16:15 ` Bruce Stephens
1997-02-01 10:09 ` Hrvoje Niksic
1997-02-26 18:51 ` Juergen Erhard
1997-02-26 18:09 ` Uli Zappe
1997-02-27 0:11 ` man " Duncan Sargeant
1997-01-31 11:53 ` Man " Zefram
1997-01-31 12:36 ` Juergen Christoffel
1997-01-31 12:51 ` Zefram
1997-01-31 13:16 ` Bruce Stephens
1997-01-31 18:33 ` Juergen Christoffel
1997-02-01 10:03 ` Hrvoje Niksic
1997-01-31 16:11 ` Vidiot
1997-01-31 16:55 ` Zefram
1997-01-31 11:45 ` Zefram
1997-01-31 16:02 ` Vidiot
1997-01-31 16:18 ` Lee Eakin
1997-01-31 17:24 Karl E. Vogel
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=199701302314.SAA14604@redwood.skiles.gatech.edu \
--to=coleman@math.gatech.edu \
--cc=zsh-users@math.gatech.edu \
/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).