From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <zsh-workers-return-30396-mason-zsh=primenet.com.au@zsh.org>
Received: (qmail 23476 invoked by alias); 13 Apr 2012 14:10:43 -0000
Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm
Precedence: bulk
X-No-Archive: yes
List-Id: Zsh Workers List <zsh-workers.zsh.org>
List-Post: <mailto:zsh-workers@zsh.org>
List-Help: <mailto:zsh-workers-help@zsh.org>
X-Seq: 30396
Received: (qmail 14012 invoked from network); 13 Apr 2012 14:10:42 -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.160.43 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=a2n02+LtCOamnfpOfbQ/nZUy5dAyN8NyDnPxwiz6BP0=;
        b=fJj07i/S4hewb0IRb0Xei2u6sR8M4Q8zEjhM127444lgozMHAxn1Xdjjh1GQm2fqh2
         y39r8v6IbBnt8ZEYdgYw1GvTxmkiATWiFR1mtmoSlRVKoKccjCfZokRTpBgZTPEUAAc8
         fIrRRikMd+PeCRK3NhLvaZPD3+sMipFGH08/vo48Xa5nYKT0wCBHcuT1Lzu2Di+5h/jz
         WHYSYtHEg1HhJZI0KOade4x2ldsHorjs2GXm4SzThkfczLuMTBDRhSRKZgi3VzwiRcz+
         l/WPc22eva7EXjgn54mxE+zJdJnd6qfIaSa1XptrnF9WWTlXIbpOXpCXdtgSK5AjyRFp
         uVzw==
MIME-Version: 1.0
In-Reply-To: <20120413133524.076d7c74@pwslap01u.europe.root.pri>
References: <CAHYJk3TwZVY2-QyO8d6HVFsvsj9+674BiRU9428606mYJQGUZw@mail.gmail.com>
	<20120413133524.076d7c74@pwslap01u.europe.root.pri>
Date: Fri, 13 Apr 2012 16:10:37 +0200
Message-ID: <CAHYJk3ShtPWFZhqM3hM-wF4RwQ3zWvGHZQRvZ2MAPwzM_1XfRA@mail.gmail.com>
Subject: Re: intro.ms
From: Mikael Magnusson <mikachu@gmail.com>
To: Peter Stephenson <Peter.Stephenson@csr.com>
Cc: zsh workers <zsh-workers@zsh.org>
Content-Type: text/plain; charset=UTF-8

On 13 April 2012 14:35, Peter Stephenson <Peter.Stephenson@csr.com> wrote:
> On Fri, 13 Apr 2012 14:21:27 +0200
> Mikael Magnusson <mikachu@gmail.com> 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.

-- 
Mikael Magnusson