From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE autolearn=ham autolearn_force=no version=3.4.2 Received: from minnie.tuhs.org (minnie.tuhs.org [45.79.103.53]) by inbox.vuxu.org (OpenSMTPD) with ESMTP id 95ca340b for ; Mon, 16 Sep 2019 22:11:08 +0000 (UTC) Received: by minnie.tuhs.org (Postfix, from userid 112) id 5AA099BF7E; Tue, 17 Sep 2019 08:11:07 +1000 (AEST) Received: from minnie.tuhs.org (localhost [127.0.0.1]) by minnie.tuhs.org (Postfix) with ESMTP id 442E69478F; Tue, 17 Sep 2019 08:10:42 +1000 (AEST) Received: by minnie.tuhs.org (Postfix, from userid 112) id B7D129478F; Tue, 17 Sep 2019 08:10:39 +1000 (AEST) Received: from mail.bitblocks.com (ns1.bitblocks.com [173.228.5.8]) by minnie.tuhs.org (Postfix) with ESMTP id A08929478D for ; Tue, 17 Sep 2019 08:10:38 +1000 (AEST) Received: from bitblocks.com (localhost [127.0.0.1]) by mail.bitblocks.com (Postfix) with ESMTP id 5E55C1570CE9; Mon, 16 Sep 2019 15:10:24 -0700 (PDT) To: Jon Steinhart In-reply-to: Your message of "Mon, 16 Sep 2019 14:54:49 -0700." <201909162154.x8GLsnOs011718@darkstar.fourwinds.com> References: <20190913221345.GA16129@minnie.tuhs.org> <20190914020240.GO2046@mcvoy.com> <20190914024433.GA19193@minnie.tuhs.org> <2e84c4d0-5239-b223-856d-00aacf8d3028@andrewnesbit.org> <201909150654.x8F6sChG021185@freefriends.org> <201909160552.x8G5qBYK025195@freefriends.org> <20190916214832.GW2046@mcvoy.com> <201909162154.x8GLsnOs011718@darkstar.fourwinds.com> Comments: In-reply-to Jon Steinhart message dated "Mon, 16 Sep 2019 14:54:49 -0700." From: Bakul Shah MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <47889.1568671824.1@bitblocks.com> Date: Mon, 16 Sep 2019 15:10:24 -0700 Message-Id: <20190916221031.5E55C1570CE9@mail.bitblocks.com> Subject: Re: [TUHS] earliest Unix roff X-BeenThere: tuhs@minnie.tuhs.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: The Unix Heritage Society mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: The Eunuchs Hysterical Society Errors-To: tuhs-bounces@minnie.tuhs.org Sender: "TUHS" On Mon, 16 Sep 2019 14:54:49 -0700 Jon Steinhart wrote: > Larry McVoy writes: > > > > I think, someone correct me if I'm wrong, the info stuff was designed > > to handle larger, more complex stuff, with a table of contents, etc. > > Something like perl could fit in one info doc but the perl man page is > > not a thing, it's just a series of pointers to more man pages. > > Can't answer you directly on this one, but I prefer the old system of > having man pages and separate documents for longer things. I still > have old notebooks full of papers on lex, yacc, and so on. > > One of the problems with using info for something like perl is that it > doesn't have a useful organization. There's a difference to me between > a reference manual and a user's guide. Most of the stuff referenced by > the main perl page is user's guide stuff to me, it's not a reference. > > Probably someone knows more than me about all this. I have always been > under the impression that one read the user's guide to learn about > complicated stuff. The manual pages were there so that you could find > the right options when you forgot. Putting every detail about a complex > program into a manual page doesn't feel right to me. A typical manpage had just the right length. Reading man pages and experimenting is how I initially learned all about unix commands. Keeping a manpage short also limited what you as the implementer would be tempted to add to the command. Manpages work best for programs that follow the unix mantra of do one thing and do it well. But not for kitchensink programs. When you need a multipage reference manual (for *experts*) with a TOC and program to "navigate", you're much more likely to give into the temptation of adding more features than partition functionality into separate programs that work well together. Not to mention it is harder to get something right that has many more features.