Re: zsh 5.0.0 released, finally

Re: zsh 5.0.0 released, finally

[Simon Ruderich]

[-- Attachment #1: Type: text/plain, Size: 1178 bytes --]

On Tue, Jul 24, 2012 at 09:42:29AM +0100, Peter Stephenson wrote:
> After what seems like years, for a very good reason, a new stable
> release of zsh, 5.0.0, has appeared.  You can get it from the main zsh
> site, or mirrors, or from Sourceforge.  The main FTP site is:
>
> [snip]

I updated the website for 5.0.0 [1]. The commits are in the
public web repository [2] (199c59f..7e0689e; tag zsh-5.0.0). If
you find any problems/mistakes please inform me.

While generating intro.pdf I noticed a problem. It seems like
pdfroff -ms $(sdir)/intro.ms >intro.pdf creates a PDF which
contains the data twice. For the website I used roff2ps and then
ps2pdf, but I'm not sure if that's the best way. Is this just a
issue with my pdfroff or a general problem?

Are the texinfo sources for intro.ms available (the link on the
website doesn't work anymore) or is there another way to create
HTML from intro.ms (roff2html doesn't really work)?

Regards,
Simon

[1]: http://zsh.sourceforge.net/
[2]: http://zsh.git.sourceforge.net/git/gitweb.cgi?p=zsh/web;a=summary
-- 
+ privacy is necessary
+ using gnupg http://gnupg.org
+ public key id: 0x92FEFDB7E44C32F9

[-- Attachment #2: Type: application/pgp-signature, Size: 836 bytes --]

Re: zsh 5.0.0 released, finally

[Simon Ruderich]

[-- Attachment #1: Type: text/plain, Size: 1525 bytes --]

On Tue, Jul 24, 2012 at 05:59:53PM +0200, Simon Ruderich wrote:
>
> I updated the website for 5.0.0 [1]. The commits are in the
> public web repository [2] (199c59f..7e0689e; tag zsh-5.0.0). If
> you find any problems/mistakes please inform me.
>
> [snip]

I noticed two typos in NEWS, the following patch fixes them:

diff --git a/NEWS b/NEWS
index 23097b6..68a9935 100644
--- a/NEWS
+++ b/NEWS
@@ -29,7 +29,7 @@ Here is a summary of the most significant changes:
 - The zshroadmap manual page provides a slightly more helpful
   introduction to the shell manual than was previously available.
 
-- There have been some notable enhancements to POSIX comptability
+- There have been some notable enhancements to POSIX compatibility
   when the shell is in a corresponding emulation (e.g. "emulate sh").
 
 Expansion (parameters, globbing, etc.) and redirection
@@ -78,7 +78,7 @@ Expansion (parameters, globbing, etc.) and redirection
   calculated by the (l) and (r) flags or the # operator should take
   account of the printing width of characters in multibyte mode, whether
   0, 1 or more.  (mm) causes printing characters to count as 1 and
-  non-printing chracters to count as 0.
+  non-printing characters to count as 0.
 
 - The parameter substitution flag (q-) picks the most minimal way of
   quoting the parameter words, to make the result as readable as possible.

Regards,
Simon
-- 
+ privacy is necessary
+ using gnupg http://gnupg.org
+ public key id: 0x92FEFDB7E44C32F9

[-- Attachment #2: Type: application/pgp-signature, Size: 836 bytes --]

Re: zsh 5.0.0 released, finally

[Peter Stephenson]

On Tue, 24 Jul 2012 17:59:53 +0200
Simon Ruderich <simon@ruderich.org> wrote:
> I updated the website for 5.0.0 [1]. 

Thanks.

> While generating intro.pdf I noticed a problem. It seems like
> pdfroff -ms $(sdir)/intro.ms >intro.pdf creates a PDF which
> contains the data twice. For the website I used roff2ps and then
> ps2pdf, but I'm not sure if that's the best way. Is this just a
> issue with my pdfroff or a general problem?

It appears to be a general problem.  I remember playing with a
workaround but I don't think I got to the point of anything useful.

> Are the texinfo sources for intro.ms available (the link on the
> website doesn't work anymore) or is there another way to create
> HTML from intro.ms (roff2html doesn't really work)?

I think intro.ms has been edited in that form.  The original source is
lost to history (or we wouldn't be carrying round a .ms file at all).

-- 
Peter Stephenson <pws@csr.com>            Software Engineer
Tel: +44 (0)1223 692070                   Cambridge Silicon Radio Limited
Churchill House, Cambridge Business Park, Cowley Road, Cambridge, CB4 0WZ, UK


Member of the CSR plc group of companies. CSR plc registered in England and Wales, registered number 4187346, registered office Churchill House, Cambridge Business Park, Cowley Road, Cambridge, CB4 0WZ, United Kingdom
More information can be found at www.csr.com. Follow CSR on Twitter at http://twitter.com/CSR_PLC and read our blog at www.csr.com/blog

Re: zsh 5.0.0 released, finally

[Bart Schaefer]

On Jul 25, 10:13am, Peter Stephenson wrote:
}
} I think intro.ms has been edited in that form.  The original source is
} lost to history (or we wouldn't be carrying round a .ms file at all).

intro.ms *is* the original source.  Yes, back in the '80s we used to
edit *roff files directly.  It was fairly innovative for my PhD thesis
to be written it laTeX ... which had to be converted to *roff to print,
as I recall.

Re: zsh 5.0.0 released, finally

[Simon Ruderich]

[-- Attachment #1: Type: text/plain, Size: 1447 bytes --]

On Wed, Jul 25, 2012 at 10:13:56AM +0100, Peter Stephenson wrote:
>> While generating intro.pdf I noticed a problem. It seems like
>> pdfroff -ms $(sdir)/intro.ms >intro.pdf creates a PDF which
>> contains the data twice. For the website I used roff2ps and then
>> ps2pdf, but I'm not sure if that's the best way. Is this just a
>> issue with my pdfroff or a general problem?
>
> It appears to be a general problem.  I remember playing with a
> workaround but I don't think I got to the point of anything useful.

Should we switch to the roff2ps & ps2pdf approach for the
Doc/Makefile? Then we won't ship the doubled PDF in the doc
package. The website needs a4 and us-letter (and their PS
versions), so maybe something like this:

    roff2ps -ms -P-pa4 < intro.ms > intro.a4.ps && ps2pdf intro.a4.ps
    roff2ps -ms -P-pletter < intro.ms > intro.us.ps && ps2pdf intro.us.ps

>> Are the texinfo sources for intro.ms available (the link on the
>> website doesn't work anymore) or is there another way to create
>> HTML from intro.ms (roff2html doesn't really work)?
>
> I think intro.ms has been edited in that form.  The original source is
> lost to history (or we wouldn't be carrying round a .ms file at all).

Is it possible to create HTML files from a roff file? My attempts
with roff2html failed.

Regards,
Simon
-- 
+ privacy is necessary
+ using gnupg http://gnupg.org
+ public key id: 0x92FEFDB7E44C32F9

[-- Attachment #2: Type: application/pgp-signature, Size: 836 bytes --]

Re: zsh 5.0.0 released, finally

[Peter Stephenson]

On Wed, 25 Jul 2012 22:57:09 +0200
Simon Ruderich <simon@ruderich.org> wrote:
> Should we switch to the roff2ps & ps2pdf approach for the
> Doc/Makefile? Then we won't ship the doubled PDF in the doc
> package. The website needs a4 and us-letter (and their PS
> versions), so maybe something like this:
> 
>     roff2ps -ms -P-pa4 < intro.ms > intro.a4.ps && ps2pdf intro.a4.ps
>     roff2ps -ms -P-pletter < intro.ms > intro.us.ps && ps2pdf intro.us.ps

Yes, that looks OK.
 
> Is it possible to create HTML files from a roff file? My attempts
> with roff2html failed.

I've never looked at this.

Index: Doc/.distfiles
===================================================================
RCS file: /cvsroot/zsh/zsh/Doc/.distfiles,v
retrieving revision 1.11
diff -p -u -r1.11 .distfiles
--- Doc/.distfiles	14 Apr 2012 20:42:39 -0000	1.11
+++ Doc/.distfiles	25 Jul 2012 21:14:11 -0000
@@ -18,5 +18,5 @@ DISTFILES_DOC='
     *.html
     zsh.dvi
     zsh.pdf
-    intro.pdf
+    intro.a4.pdf intro.us.pdf
 '
Index: Doc/Makefile.in
===================================================================
RCS file: /cvsroot/zsh/zsh/Doc/Makefile.in,v
retrieving revision 1.50
diff -p -u -r1.50 Makefile.in
--- Doc/Makefile.in	14 Apr 2012 20:42:39 -0000	1.50
+++ Doc/Makefile.in	25 Jul 2012 21:14:11 -0000
@@ -94,7 +94,7 @@ dvi: zsh.dvi
 zsh.dvi: $(sdir)/zsh.texi
 	$(TEXI2DVI) $(sdir)/zsh.texi
 
-pdf: zsh.pdf intro.pdf
+pdf: zsh.pdf intro.a4.pdf intro.us.pdf
 .PHONY: pdf
 
 zsh.pdf: $(sdir)/zsh.texi
@@ -104,8 +104,14 @@ zsh.pdf: $(sdir)/zsh.texi
 	  PDFTEX=$(PDFETEX) $(TEXI2DVI) --pdf $(sdir)/zsh.texi; \
 	fi
 
-intro.pdf: $(sdir)/intro.ms
-	pdfroff -ms $(sdir)/intro.ms >intro.pdf
+# Use roff2ps / ps2pdf because pdfroff produces doubled output.
+intro.a4.pdf: $(sdir)/intro.ms
+	roff2ps -ms -P-pa4 < $(sdir)/intro.ms > intro.a4.ps
+	ps2pdf intro.a4.ps
+
+intro.us.pdf: $(sdir)/intro.ms
+	roff2ps -ms -P-pletter < $(sdir)/intro.ms > intro.us.ps
+	ps2pdf intro.us.ps
 
 texi: $(sdir)/zsh.texi
 .PHONY: texi


-- 
Peter Stephenson <p.w.stephenson@ntlworld.com>
Web page now at http://homepage.ntlworld.com/p.w.stephenson/

Re: zsh 5.0.0 released, finally

[Simon Ruderich]

[-- Attachment #1: Type: text/plain, Size: 640 bytes --]

On Wed, Jul 25, 2012 at 10:15:40PM +0100, Peter Stephenson wrote:
>> Is it possible to create HTML files from a roff file? My attempts
>> with roff2html failed.
>
> I've never looked at this.

Okay. AFAIK it's not really possible.

The questions is what should we do about the HTML intro on the
website? It's outdated (at least missing recent changes to
intro.ms - haven't really checked further). Should we just leave
it there (maybe with a note) or remove the HTML version and only
link the PDF/PS versions?

Regards,
Simon
-- 
+ privacy is necessary
+ using gnupg http://gnupg.org
+ public key id: 0x92FEFDB7E44C32F9

[-- Attachment #2: Type: application/pgp-signature, Size: 836 bytes --]

Re: zsh 5.0.0 released, finally

[Peter Stephenson]

On Sat, 28 Jul 2012 15:29:15 +0200
Simon Ruderich <simon@ruderich.org> wrote:
> The questions is what should we do about the HTML intro on the
> website? It's outdated (at least missing recent changes to
> intro.ms - haven't really checked further). Should we just leave
> it there (maybe with a note) or remove the HTML version and only
> link the PDF/PS versions?

It's probably worth leaving there with a note until such time as someone
gets a chance to turn intro.ms into Yodl, which shouldn't actually be
that difficult as long as we aren't strict about formatting.

The sentence at the end saying Bas is happy to get email about it good
probably do with editing out.

-- 
Peter Stephenson <p.w.stephenson@ntlworld.com>
Web page now at http://homepage.ntlworld.com/p.w.stephenson/