On Fri, 21 Jun 1996, Bart Schaefer wrote: > On Jun 20, 3:03pm, Mark Borges wrote: > } Subject: Re: zsh-2.6-beta21 released > } > } I've applied this patch and re-generated the html files via > } texi2html-1.50. The URL is still > } > } http://www.mal.com/zsh/Doc/test/ > } > } where zsh.texi.gz is version 2.03. > > I think maybe it should be clearer in the documents that 2.03 is the > version number of the document and not the version of zsh to which it > refers. `Edition 2.0.3' on the TOC page is confusing. OK. 'Edition 2.0.3' -> 'Document Edition 2.0.3'. > For the rest of these comments, I don't know which need to change the > man pages, the FAQ, zsh.texi, and/or all of them; but they're all from > reading the HTML at the above URL. > > I've scattered semi-related thoughts and commentary throughout, usually > prefixed with "Aside:". > > > Intro section: > > hasn't been a usable address for Paul since almost two > years ago. He's now . OK. This is updated. > Spell checking still hasn't happened ... "defauly"? That particular mistake was corrected in 2.0.1, is not in 2.0.2 (in the beta21 dist), so I've no idea why that should still be there if Mark has updated his HTML from 2.0.3. Mark ? > Shell Grammar section: > Spell checking again ... "anexternal" --> "an external". Again, Mark needs to update/fix HTML ???? > Further, the whole section could benefit from some vertical white space > between defined terms. Looks like it's there in the source but gets > squashed out when displayed. I suppose its a texi2html problem (some > strategic
need to be output). Yes, the info and printed tex are formatted correctly, so I guess the problem is with texi2html. > The paragraph on Comments still refers to HISTCHARS; it's now histchars. Fixed. > texi2html is still having problems with pairs of single quotes (''), > rendering that as a double quote ("). Having just d/l'd texi2html, the solution to this one would seem to be to run it with the '-expandinfo' option. > Expansion section: > I'd love it if there were more hrefs, e.g. from every reference to an > option name to the description of that option, or from a builtin's name > to its description. E.g., in the sentence: > The PUSHD_MINUS option exchanges the effects of ~+ and ~- > where they are followed by a number. > It'd be great to be able to click on PUSHD_MINUS. I'll give this some thought when I get home this evening. Clive. -- C Messer. Epos Systems. UK. | | "I pressed her thigh and death smiled." | Jim Morrison.