zsh-workers
 help / color / mirror / code / Atom feed
From: Bart Schaefer <schaefer@brasslantern.com>
To: zsh-workers@zsh.org
Subject: Re: [PATCH] _arguments: Escape colons and backslashes in $opt_args unambiguously.
Date: Wed, 7 Sep 2016 00:03:20 -0700	[thread overview]
Message-ID: <160907000320.ZM11510@torch.brasslantern.com> (raw)
In-Reply-To: <1473013592-24926-1-git-send-email-danielsh@fujitsu.shahaf.local2>

On Sep 4,  6:26pm, Daniel Shahaf wrote:
}
} Is it okay to refer to NEWS from the manual?

Are there any other examples of the manual referring directly to the
behavior of previous versions?

It's not the kind of thing it's easy to search for, but I can't think
of any, so my inclination would be to drop your parenthetical Note:.

} In the manual I wrote "See NEWS" even though the pointed-to text is in
} README because (a) NEWS includes README by reference, (b) I doubted
} readers would follow a reference to README in that context.

I doubt readers will follow a NEWS reference either.  If this is
important enough to reference -- which I don't think it is -- then
it's important enough to say it here, not cross-reference somewhere
outside of the regular documentation tree, and certainly it shouldn't
require going to NEWS, finding nothing, and then having to realize
it might be in README.

} +ambiguity: if the -x option took two arguments (as in
} +    _arguments : -x:foo:${action}:bar:$action
} +), it would be impossible to tell from $opt_args whether the command-line
} +was '-x foo\:bar' or '-x foo\\ bar'.

Is this example correct?  Isn't the actual ambiguity between
[[[ -x foo\:bar ]]] (one arg) and [[[ -x foo bar ]]] (two args)?  If
I'm wrong, what is it about your explanation that confused me?

There's probably still an ambiguity between [[[ -x foo bar ]]] and
[[[ -x foo -x bar ]]] ...


  reply	other threads:[~2016-09-07  7:03 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-09-04 18:26 Daniel Shahaf
2016-09-07  7:03 ` Bart Schaefer [this message]
2016-09-07 22:07   ` Daniel Shahaf
2016-09-08  0:13     ` Bart Schaefer
2016-09-08 11:01       ` Daniel Shahaf
2016-09-08 15:49         ` Bart Schaefer

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=160907000320.ZM11510@torch.brasslantern.com \
    --to=schaefer@brasslantern.com \
    --cc=zsh-workers@zsh.org \
    /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).