ZSH-3.0 web page prototype

ZSH-3.0 web page prototype

[Mark Borges]

I'm developing a prototype (very much a work in progress) for zsh-3.0
documentation at the URL,

  http://www.mal.com/zsh3/

In an attempt to keep robots (and only robots) at bay, I've restricted
access to this development directory. To gain access, the username is
`zsh-workers' and the password is `falstad'. Hmm, I wonder if there
are robots that parse mail archives looking for passwords :-).

In particular, the zsh.texi (v2.1.1, as distributed with 3.0-pre3)
documentation translated to html via texi2html is now in

  http://www.mal.com/zsh3/Doc/

(there is also a link from the old test URL).

I'm toying with the idea of having a frames version available, but it
pretty much sucks right now. A crude ugly version of the documentation
is in http://www.mal.com/zsh3/Doc/index-frame.shtml. But I'm thinking
of a three-frame window, with indices along the top, chapters along
the left, and the documentation itself in the main window, something
like:

        --------------------------------------------------------
        |         |   Indices go here                           |
        |Chapter  |---------------------------------------------|
        |Names    |                                             |
        |Here     |                                             |
        |         |                                             |
        |         |    main                                     |
        |         |        doc                                  |
        |         |           here                              |
        |         |                                             |
        |         |                                             |
        |-------------------------------------------------------|

Anyway, all comments/suggestions are welcome, but my immediate concern
is the documentation and integrating it back into the FAQ (which still
refers to the old manual right now).

-- 
  -mb-

Re: ZSH-3.0 web page prototype

[Zefram]

>I'm developing a prototype (very much a work in progress) for zsh-3.0
>documentation at the URL,
>
>  http://www.mal.com/zsh3/

pfalstad's old introduction to zsh is in very serious need of
updating.  (E.g., in the first section -- globbing -- <> is used for
numerical globbing, but many of the glob qualifiers aren't mentioned.)
This is one of the things that would be good to get done for version
3.

>I'm toying with the idea of having a frames version available, but it

Not a good idea, IMO.  Frames are, by their nature, a proprietary
standard, and the only implementation sucks raw eggs through a very
thin straw.  I see that you've got something checking for Netscape at
the front-end; consequently I can't check how the HTML actually looks
without frames.  (I modified Lynx to send the same User-Agent string as
Netscape -- just how are you identifying it?)  Assuming you didn't put
the filter there just for the fun of it, I must conclude that the
frames data causes problems with standard-conforming viewers.

-zefram