From: Peter Stephenson <p.w.stephenson@ntlworld.com>
To: zsh-workers@sunsite.dk
Subject: Re: problems in zshcompctl.1, zshcontrib.1, zshmodules.1
Date: Fri, 05 Jan 2007 20:46:26 +0000 [thread overview]
Message-ID: <200701052046.l05KkQI8018388@pwslaptop.csr.com> (raw)
In-Reply-To: Message from esr@thyrsus.com of "Mon, 01 Jan 2007 19:04:55 EST." <200701020004.l0204tp2028017@snark.thyrsus.com>
esr@thyrsus.com wrote:
> Problems with zshcompctl.1:
>
> 1. List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
> This confuses doclifter, and may also mess up stricter troff
> interpreters like Xman, Rosetta, and TkMan.
I would guess it's complaining about the nofill() instructions, but it's
not clear... I've rewritten it to be closer to other command descriptions.
> Problems with zshcontrib.1:
>
> 1. List syntax error. This means .IP, .TP or .RS/.RE markup is garbled.
> This confuses doclifter, and may also mess up stricter troff
> interpreters like Xman, Rosetta, and TkMan.
This was an item()(...) formatted so as to get indented paragraphs with
no other mark up; I couldn't find another way of doing that in Yodl.
I've simply removed the extra formatting.
> Problems with zshmodules.1:
>
> 1. Unbalanced .RS or .RE macro
>
> 2. Unclosed .RS, appears to be a broken attempt to express list structure.
This doesn't seem to be happening with yodl 1.31.18. I gave up on more
recent versions in frustration.
Index: Doc/Zsh/compctl.yo
===================================================================
RCS file: /cvsroot/zsh/zsh/Doc/Zsh/compctl.yo,v
retrieving revision 1.7
diff -u -r1.7 compctl.yo
--- Doc/Zsh/compctl.yo 24 Apr 2005 18:38:03 -0000 1.7
+++ Doc/Zsh/compctl.yo 5 Jan 2007 20:42:19 -0000
@@ -559,15 +559,19 @@
list of flags is used even if the current list produced matches.
texinode(Extended Completion)(Example)(Alternative Completion)(Completion Using compctl)
+
+Additional options are available that restrict completion to some part
+of the command line; this is referred to as `extended completion'.
+
sect(Extended Completion)
startlist()
-list(nofill(tt(compctl) [ tt(-CDT) ] var(options) \
-tt(-x) var(pattern) var(options) tt(-) ... tt(-)tt(-)
- [ var(command) ... ]))
-list(nofill(tt(compctl) [ tt(-CDT) ] var(options) \
-[ tt(-x) var(pattern) var(options) tt(-) ... tt(-)tt(-) ]
- [ tt(PLUS()) var(options) [ tt(-x) ... tt(-)tt(-) ] ... [tt(PLUS())] ] \
-[ var(command) ... ]))
+list(tt(compctl) [ tt(-CDT) ] var(options) \
+tt(-x) var(pattern) var(options) tt(-) ... tt(-)tt(-))
+list( [ var(command) ... ])
+list(tt(compctl) [ tt(-CDT) ] var(options) \
+[ tt(-x) var(pattern) var(options) tt(-) ... tt(-)tt(-) ])
+list( [ tt(PLUS()) var(options) [ tt(-x) ... tt(-)tt(-) ] ... \
+[tt(PLUS())] ] [ var(command) ... ])
endlist()
The form with `tt(-x)' specifies extended completion for the
Index: Doc/Zsh/contrib.yo
===================================================================
RCS file: /cvsroot/zsh/zsh/Doc/Zsh/contrib.yo,v
retrieving revision 1.65
diff -u -r1.65 contrib.yo
--- Doc/Zsh/contrib.yo 15 Dec 2006 11:44:29 -0000 1.65
+++ Doc/Zsh/contrib.yo 5 Jan 2007 20:42:21 -0000
@@ -1624,8 +1624,6 @@
should be checked if attempting to execute a file by extension
tt(.)var(ext) does not have the expected effect.
-startitem()
-item()(
The command `tt(alias -s) var(ext)' should show
`tt(ps=zsh-mime-handler)'. If it shows something else, another suffix
alias was already installed and was not overwritten. If it shows
@@ -1633,8 +1631,7 @@
handler was found in the tt(.mime.types) and tt(mailcap) combination for
tt(.ext) files. In that case, appropriate handling should be added to
tt(~/.mime.types) and tt(mailcap).
-)
-item()(
+
If the extension is handled by tt(zsh-mime-handler) but the file is
not opened correctly, either the handler defined for the type is
incorrect, or the flags associated with it are in appropriate. Running
@@ -1648,8 +1645,6 @@
example(text/html; /usr/bin/lynx '%s'; needsterminal)
)
-enditem()
-)
findex(pick-web-browser)
item(tt(pick-web-browser))(
This function is separate from the two MIME functions described above
--
Peter Stephenson <p.w.stephenson@ntlworld.com>
Web page now at http://homepage.ntlworld.com/p.w.stephenson/
prev parent reply other threads:[~2007-01-05 20:46 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2007-01-02 0:04 esr
2007-01-05 20:46 ` Peter Stephenson [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=200701052046.l05KkQI8018388@pwslaptop.csr.com \
--to=p.w.stephenson@ntlworld.com \
--cc=zsh-workers@sunsite.dk \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.vuxu.org/mirror/zsh/
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).