From owner-freebsd-hackers Sun Jan 12 08:32:18 1997 Return-Path: Received: (from root@localhost) by freefall.freebsd.org (8.8.4/8.8.4) id IAA04309 for hackers-outgoing; Sun, 12 Jan 1997 08:32:18 -0800 (PST) Received: from sax.sax.de (sax.sax.de [193.175.26.33]) by freefall.freebsd.org (8.8.4/8.8.4) with SMTP id IAA04304 for ; Sun, 12 Jan 1997 08:32:09 -0800 (PST) Received: (from uucp@localhost) by sax.sax.de (8.6.12/8.6.12-s1) with UUCP id RAA19039 for freebsd-hackers@FreeBSD.ORG; Sun, 12 Jan 1997 17:31:05 +0100 Received: (from j@localhost) by uriah.heep.sax.de (8.8.4/8.6.9) id RAA03348; Sun, 12 Jan 1997 17:09:30 +0100 (MET) Message-ID: Date: Sun, 12 Jan 1997 17:09:30 +0100 From: j@uriah.heep.sax.de (J Wunsch) To: freebsd-hackers@FreeBSD.ORG Subject: Re: new texinfo is busted! References: <199701121158.MAA09203@ravenock.cybercity.dk> X-Mailer: Mutt 0.55-PL10 Mime-Version: 1.0 X-Phone: +49-351-2012 669 X-PGP-Fingerprint: DC 47 E6 E4 FF A6 E9 8F 93 21 E0 7D F9 12 D6 4E Reply-To: joerg_wunsch@uriah.heep.sax.de (Joerg Wunsch) In-Reply-To: <199701121158.MAA09203@ravenock.cybercity.dk>; from sos@FreeBSD.ORG on Jan 12, 1997 12:58:44 +0100 Sender: owner-hackers@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk As sos@FreeBSD.ORG wrote: > AMEN!!, we _dont_ need info files, make the man pages (as god intended > them to be) or at least HTML... Well, i think there's room for both, a man-style utility, and a fancy xref'ing utility, e.g. HTML-based. I usually prefer man pages for a quick reference. However, there are examples in the man pages that would better off in HTML. Funny, mdoc.samples(7) is a good example to begin with :), but things like the Perl 5 man page are good candidates for something that goes well beyond the limit of the historic man system. However, i would still prefer a quick reference for Perl as a man page, a terse one, just mentioning all the builtins and the syntax (but leaving out the semantics details). This would come handy for a quick reference if you already basically know what you want. If we prefer to convert all the .texi docs into HTML, i'm all for it. I think both formats are fairly compatible and similar in their goals (only that texinfo is older, from an era where HTML was nothing known). -- cheers, J"org joerg_wunsch@uriah.heep.sax.de -- http://www.sax.de/~joerg/ -- NIC: JW11-RIPE Never trust an operating system you don't have sources for. ;-)