From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from euclid.skiles.gatech.edu (list@euclid.skiles.gatech.edu [130.207.146.50]) by melb.werple.net.au (8.7.5/8.7.3/2) with ESMTP id WAA19101 for ; Fri, 21 Jun 1996 22:47:44 +1000 (EST) Received: (from list@localhost) by euclid.skiles.gatech.edu (8.7.3/8.7.3) id IAA28391; Fri, 21 Jun 1996 08:33:26 -0400 (EDT) Resent-Date: Fri, 21 Jun 1996 08:33:26 -0400 (EDT) Date: Fri, 21 Jun 1996 13:30:30 +0100 (BST) From: Clive Messer Reply-To: Clive Messer To: schaefer@nbn.com cc: Mark Borges , zsh-workers@math.gatech.edu Subject: Re: zsh.texi commentary (actually, HTML pages commentary) In-Reply-To: <960621003054.ZM3580@candle.brasslantern.com> Message-ID: MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="-1734436770-1166405389-835360230=:30067" Resent-Message-ID: <"Ye5Yl3.0.Xx6.MQfon"@euclid> Resent-From: zsh-workers@math.gatech.edu X-Mailing-List: archive/latest/1399 X-Loop: zsh-workers@math.gatech.edu Precedence: list Resent-Sender: zsh-workers-request@math.gatech.edu This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. Send mail to mime@docserver.cac.washington.edu for more info. ---1734436770-1166405389-835360230=:30067 Content-Type: TEXT/PLAIN; charset=US-ASCII 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. ---1734436770-1166405389-835360230=:30067 Content-Type: TEXT/PLAIN; charset=US-ASCII; name="zsh.texi.diff.2.0.3-4" Content-Transfer-Encoding: BASE64 Content-ID: Content-Description: zsh.texi.diff.2.0.3-4 LS0tIHpzaC50ZXhpLTIuMC4zCVRodSBKdW4gMjAgMDA6MzA6MzUgMTk5Ng0K KysrIHpzaC50ZXhpCUZyaSBKdW4gMjEgMTM6MjY6MjAgMTk5Ng0KQEAgLTEw LDEzICsxMCwxMyBAQA0KIEBhZm91cnBhcGVyDQogQGVuZCBpZnRleA0KIA0K LUBzZXQgRURJVElPTiAyLjAuMw0KK0BzZXQgRURJVElPTiAyLjAuNA0KIEBz ZXQgVkVSU0lPTiAyLjYuMjENCi1Ac2V0IFVQREFURUQgMjAgSnVuZSAxOTk2 DQorQHNldCBVUERBVEVEIDIxIEp1bmUgMTk5Ng0KIA0KIEBpZmluZm8NCiBA bm9pbmRlbnQNCi1FZGl0aW9uIEB2YWx1ZXtFRElUSU9OfSwgbGFzdCB1cGRh dGVkIEB2YWx1ZXtVUERBVEVEfSwNCitEb2N1bWVudCBFZGl0aW9uIEB2YWx1 ZXtFRElUSU9OfSwgbGFzdCB1cGRhdGVkIEB2YWx1ZXtVUERBVEVEfSwNCiBv ZiBAY2l0ZXtUaGUgWiBTaGVsbCBHdWlkZX0sIGZvciB6c2gsIFZlcnNpb24g QHZhbHVle1ZFUlNJT059Lg0KIA0KIFRoaXMgaXMgYSB0ZXhpbmZvIHZlcnNp b24gb2YgdGhlIG1hbiBwYWdlIGZvciB0aGUgWiBTaGVsbCwgb3JpZ2luYWxs eSBieSANCkBAIC0yNywxMyArMjcsMTMgQEANCiANCiBAdGl0bGVwYWdlDQog QHRpdGxlIFRoZSBaIFNoZWxsDQotQHN1YnRpdGxlIEVkaXRpb24gQHZhbHVl e0VESVRJT059IA0KK0BzdWJ0aXRsZSBEb2N1bWVudCBFZGl0aW9uIEB2YWx1 ZXtFRElUSU9OfSANCiBAc3VidGl0bGUgQHZhbHVle1VQREFURUR9DQogQGF1 dGhvciBPcmlnaW5hbGx5IGJ5IFBhdWwgRmFsc3RhZA0KIEBwYWdlDQogQHZz a2lwIDBwdCBwbHVzIDFmaWxsbA0KIEBub2luZGVudA0KLUVkaXRpb24gQHZh bHVle0VESVRJT059LCBsYXN0IHVwZGF0ZWQgQHZhbHVle1VQREFURUR9LA0K K0RvY3VtZW50IEVkaXRpb24gQHZhbHVle0VESVRJT059LCBsYXN0IHVwZGF0 ZWQgQHZhbHVle1VQREFURUR9LA0KIG9mIEBjaXRle1RoZSBaIFNoZWxsIEd1 aWRlfSwgZm9yIHpzaCwgVmVyc2lvbiBAdmFsdWV7VkVSU0lPTn0uDQogDQog VGhpcyBpcyBhIHRleGluZm8gdmVyc2lvbiBvZiB0aGUgbWFuIHBhZ2UgZm9y IHRoZSBaIFNoZWxsLCBvcmlnaW5hbGx5IGJ5IA0KQEAgLTE2OSw3ICsxNjks NyBAQA0KIEBjaW5kZXggYXV0aG9yDQogDQogQG5vaW5kZW50DQotWnNoIHdh cyBvcmlnaW5hbGx5IHdyaXR0ZW4gYnkgUGF1bCBGYWxzdGFkLCBAY29kZXtw ZkBAei1jb2RlLmNvbX0uDQorWnNoIHdhcyBvcmlnaW5hbGx5IHdyaXR0ZW4g YnkgUGF1bCBGYWxzdGFkLCBAY29kZXtwZkBAc29mdHdhcmUuY29tfS4NCiBQ cm9ncmFtbWFibGUgY29tcGxldGlvbiB3YXMgaW1wbGVtZW50ZWQgYnkgU3Zl biBXaXNjaG5vd3NreSwNCiBAY29kZXtvYmVyb25AQGNzLnR1LWJlcmxpbi5k ZX0gYW5kIFBldGVyIFN0ZXBoZW5zb24sDQogQGNvZGV7UC5TdGVwaGVuc29u QEBzd2Fuc2VhLmFjLnVrfS4gIFJpY2hhcmQgQ29sZW1hbiwNCkBAIC02NzAs OCArNjcwLDggQEANCiBJbiBub24taW50ZXJhY3RpdmUgc2hlbGxzLCBvciBp biBpbnRlcmFjdGl2ZSBzaGVsbHMgd2l0aCB0aGUNCiBAY29kZXtJTlRFUkFD VElWRV9DT01NRU5UU30gb3B0aW9uIHNldCwgYSB3b3JkIGJlZ2lubmluZyB3 aXRoIHRoZSB0aGlyZA0KIEBwaW5kZXggSU5URVJBQ1RJVkVfQ09NTUVOVFMs IHVzZSBvZg0KLWNoYXJhY3RlciBvZiB0aGUgQGNvZGV7SElTVENIQVJTfSBw YXJhbWV0ZXIgKEBjb2RleyN9IGJ5IGRlZmF1bHQpIGNhdXNlcw0KLUB2aW5k ZXggSElTVENIQVJTLCB1c2Ugb2YNCitjaGFyYWN0ZXIgb2YgdGhlIEBjb2Rl e2hpc3RjaGFyc30gcGFyYW1ldGVyIChAY29kZXsjfSBieSBkZWZhdWx0KSBj YXVzZXMNCitAdmluZGV4IGhpc3RjaGFycywgdXNlIG9mDQogdGhhdCB3b3Jk IGFuZCBhbGwgdGhlIGZvbGxvd2luZyBjaGFyYWN0ZXJzIHVwIHRvIGEgbmV3 bGluZSB0byBiZQ0KIGlnbm9yZWQuDQogDQpAQCAtNzA3LDEwICs3MDcsMTAg QEANCiBwcmVjZWRpbmcgaXQgd2l0aCBhIEBjb2Rle1x9LiAgQGNvZGV7XH0g Zm9sbG93ZWQgYnkgYSBuZXdsaW5lIGlzDQogaWdub3JlZC4gIEFsbCBjaGFy YWN0ZXJzIGVuY2xvc2VkIGJldHdlZW4gYSBwYWlyIG9mIHNpbmdsZSBxdW90 ZXMNCiBAaWZpbmZvDQotKEBjb2Rle0AnQCd9KSBhcmUgcXVvdGVkLCBleGNl cHQgdGhlIGZpcnN0IGNoYXJhY3RlciBvZiBAY29kZXtISVNUQ0hBUlN9DQor KEBjb2Rle0AnQCd9KSBhcmUgcXVvdGVkLCBleGNlcHQgdGhlIGZpcnN0IGNo YXJhY3RlciBvZiBAY29kZXtoaXN0Y2hhcnN9DQogQGVuZCBpZmluZm8NCiBA aWZ0ZXgNCi0oQGNvZGV7Jyd9KSBhcmUgcXVvdGVkLCBleGNlcHQgdGhlIGZp cnN0IGNoYXJhY3RlciBvZiBAY29kZXtISVNUQ0hBUlN9DQorKEBjb2Rleycn fSkgYXJlIHF1b3RlZCwgZXhjZXB0IHRoZSBmaXJzdCBjaGFyYWN0ZXIgb2Yg QGNvZGV7aGlzdGNoYXJzfQ0KIEBlbmQgaWZ0ZXgNCiAoQGNvZGV7IX0gYnkg ZGVmYXVsdCkuICBBIHNpbmdsZSBxdW90ZSBjYW5ub3QgYXBwZWFyIHdpdGhp biBzaW5nbGUNCiBxdW90ZXMuICBJbnNpZGUgZG91YmxlIHF1b3RlcyAoQGNv ZGV7IiJ9KSwgcGFyYW1ldGVyIGFuZCBjb21tYW5kDQpAQCAtNjg4MSwzICs2 ODgxLDYgQEANCiBlZy4gIi1mIiB0byBAc2FtcCwgcmF0aGVyIHRoYW4gQGNv ZGUuDQogdjIuMC4yLiBKdW5lIDEzdGggMTk5Ni4gU2V2ZXJhbCBmaXhlcyB0 byBQcm9ncmFtbWFibGUgQ29tcGxldGlvbi4gDQogdjIuMC4zLiBKdW5lIDIw dGggMTk5Ni4gVXBkYXRlZCB0byBpbmNsdWRlIGNoYW5nZXMgZnJvbSAyLjYu MjAgdG8gMi42LjIxLg0KK3YyLjAuNC4gSnVuZSAyMXN0IDE5OTYuIENoYW5n ZWQgb2NjdXJhbmNlcyBvZiBISVNUQ0hBUlMgdG8gaGlzdGNoYXJzLg0KK0No YW5nZWQgbWFpbCBhZGRyZXNzIGZvciBQYXVsIEZhbHN0YWQgdG8gcGZAc29m dHdhcmUuY29tLg0KKydFZGl0aW9uJyAtPiAnRG9jdW1lbnQgRWRpdGlvbicg dG8gc2F2ZSBjb25mdXNpb24gd2l0aCB6c2ggdmVyc2lvbi4NCg== ---1734436770-1166405389-835360230=:30067--