installing zsh questions

installing zsh questions

[Francisco Borges]

Hello!

Two possibly very silly questions about installing zsh locally:
(BTW I'm running Debian "stable")

1. To make help files for run-help I used:

% man -m /usr/local/man zshall | colcrt - | \
  perl ~/sys/zsh/zsh-4.3.1/Util/helpfiles

But this created files like:

A
On
By
But
No
[etc]

it seems that most files starting with upper case could be deleted, but
there are things like LBUFFER, which is arguably a valid help file.

Have I done something wrong or everybody just deletes all files starting
with uppercase? (in which case the question is, why the perl script
won't do that directly?).



2. There are executable scripts in Functions/Misc, however 'make
   install' is installing them as non-executable files. I used:

configure --prefix=/usr/local/stow/zsh-4.3.1 --enable-function-subdirs \
	  --enable-site-fndir --enable-zsh-mem

What am I missing here?


Thanks a lot!
-- 
Francisco.

Re: installing zsh questions

[William Scott]

>
> 1. To make help files for run-help I used:
>
> % man -m /usr/local/man zshall | colcrt - | \
>  perl ~/sys/zsh/zsh-4.3.1/Util/helpfiles
>
> But this created files like:
>
> A
> On
> By

This happens to me too on OS X and ubuntu (debian), so I think it is 
platform-independent.  I too wouldn't mind getting rid of it, as 
occasionally you get a weird suprise.

>
> 2. There are executable scripts in Functions/Misc, however 'make
>   install' is installing them as non-executable files. I used:

Functions in general aren't executable shell scripts (although they often 
can be used as such).  Typically $fpath != $path.

Re: installing zsh questions

[Peter Stephenson]

Francisco Borges wrote:
> Hello!
> 
> Two possibly very silly questions about installing zsh locally:
> (BTW I'm running Debian "stable")
> 
> 1. To make help files for run-help I used:
> 
> % man -m /usr/local/man zshall | colcrt - | \
>   perl ~/sys/zsh/zsh-4.3.1/Util/helpfiles
> 
> But this created files like:
> 
> A
> On
> By
> But
> No
> [etc]

I don't quite understand how this ever worked...  the exit condition
when parsing zshall doesn't appear to be in the right place.  It
may have been caused by a knock-on effect of another change.  The
following seems to do the right thing, anyway.  The change to the
position of the test is the fix to the problem you're noticing; the
change to the test itself is explained by the comment.

> 2. There are executable scripts in Functions/Misc, however 'make
>    install' is installing them as non-executable files.

I don't think you're missing anything, we are.  As the files are
functions, they don't *need* to be executable; presumably people have
been adding those that *can* be run stand-alone to the archive as
executable files, but no one's ever bothered to make the installer spot
this.

Index: Util/helpfiles
===================================================================
RCS file: /cvsroot/zsh/zsh/Util/helpfiles,v
retrieving revision 1.3
diff -u -r1.3 helpfiles
--- Util/helpfiles	30 May 2001 16:08:16 -0000	1.3
+++ Util/helpfiles	13 Mar 2006 18:50:33 -0000
@@ -107,7 +107,12 @@
     undef($undented);
     if (/^\s*$/ || ($undented = (/^(\s*)/  && length($1) < $indent))) {
 	$undented && &doprint($_);
-	while (defined($_ = <>) && /(^\w)|(^\s*$)/) { 
+	while (defined($_ = <>) && /(^\w)|(^\s*$)/) {
+	    # NAME is the start of the next section when in zshall.
+	    # (Historical note: we used to exit on the page header,
+	    # but text from the old section can continue to the
+	    # new page).
+	    last BUILTINS if /^\s*NAME\s*$/;
 	    last BUILTINS if /^STARTUP\/SHUTDOWN FILES/;
 	    last if /^zsh.*\s\d$/; # GNU nroff -man end-of-page marker
 	}
@@ -121,11 +126,6 @@
 		} while (defined($_) && /^\s*$/);
 	    }
 	}
-	# In zshall, the zshcompctl manual page comes after the
-	# builtins for 3.0, and zshzle comes after it for 3.1.
-	if (/ZSH(COMPCTL|ZLE)\(1\).*ZSH(COMPCTL|ZLE)\(1\)/) {
-	    last BUILTINS;
-	}
 	if (/^(\s*)/ && length($1) < $indent) {
 	    # This may be just a bug on the SGI, or maybe something
 	    # more sinister (don\'t laugh, this is nroff).

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


To access the latest news from CSR copy this link into a web browser:  http://www.csr.com/email_sig.php