From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 24197 invoked by alias); 14 Apr 2012 20:07:13 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: X-Seq: 30409 Received: (qmail 26458 invoked from network); 14 Apr 2012 20:07:01 -0000 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-1.6 required=5.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED,FREEMAIL_FROM,NML_ADSP_CUSTOM_MED,RCVD_IN_DNSWL_LOW, T_DKIM_INVALID autolearn=no version=3.3.2 Received-SPF: pass (ns1.primenet.com.au: SPF record at _spf.google.com designates 209.85.210.44 as permitted sender) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=OLS+pqaNDfBYJ/6Y+yj/4lmf48bUcZMvGcmOIBoxf8M=; b=zMqPNg7lvahABSZJ0GJQQOMN082FtFLKJtZKBWhINKz2PhxDCwBAY5EnF6UUQ4yvUW eZ+lQAZ9YH8FUJzaKbWwf0Y27tZCIt3+tnAoDBX5guiNtnlZWwYvCt+Et3k0jsou1V7W fRgvsDWJhJw3g1uOi6lH0Z2AtV/9wQT8BG/O1GBbplCtOvI8+BrpIF0E9Lr9Kp0TQjJ7 GQ4vWfCh89a3woiAzQf1bdrLH2/QlPJ+IoiaCUEjrxCAFWHn2s0/mgb+jgB358kT+nn+ ANQ4W92w65pIphZcgWgpOqbFHgmGsRZtYIVgoV7lsm/iskJkpuCCWGxwXV/Oy/drJK8t ZX5w== MIME-Version: 1.0 In-Reply-To: References: <20120413133524.076d7c74@pwslap01u.europe.root.pri> Date: Sat, 14 Apr 2012 22:06:55 +0200 Message-ID: Subject: Re: intro.ms From: Mikael Magnusson To: Peter Stephenson Cc: zsh workers Content-Type: text/plain; charset=UTF-8 On 13 April 2012 16:10, Mikael Magnusson wrote: > On 13 April 2012 14:35, Peter Stephenson wrote: >> On Fri, 13 Apr 2012 14:21:27 +0200 >> Mikael Magnusson wrote: >>> For more information, the files Doc/intro.txt or Doc/intro.troff >>> included with the source distribution are highly recommended. A list >>> of features is given in FEATURES, also with the source. >>> >>> But these files don't exist at least since we started using cvs, and I >>> can't get any man/troff/nroff/*roff variant to produce readable output >>> from intro.ms. /README notes that it is based on zsh 2.5 but still a >>> good introduction. Does anyone know how to build it, or should we >>> remove it and/or the recommendation to read it? >> >> "nroff -ms" is still producing quite readable about for me, and "pdfroff >> -ms" produced a usable document which we could distribute in the doc >> bundle, but it's not a very sensible source format. I suppose it would >> need to be translated by hand. > > Ah, I didn't know you had to pass any switches to it, all I know about > roff is it's something to do with man pages usually :). I read about a > third of it so far, and most of it is still applicable. We might want > to remove the bits about compctl if we keep the recommendation in the > FAQ to read it. I just made it to the end, and noticed that, at least for me, the pdfroff -ms command produces a pdf that has the whole content twice, ie it is 84 pages. nroff -ms doesn't seem to do this. -- Mikael Magnusson