zsh-workers
 help / color / mirror / code / Atom feed
From: Oliver Kiddle <okiddle@yahoo.co.uk>
To: "Daniel Shahaf" <d.s@daniel.shahaf.name>
Cc: "Eitan Adler" <lists@eitanadler.com>, zsh-workers@zsh.org
Subject: Re: [PATCH] _git: add completion for git-version
Date: Mon, 20 Jan 2020 00:09:23 +0100	[thread overview]
Message-ID: <62021-1579475363.693409@694T.IZIu.-Z_U> (raw)
In-Reply-To: <8049d524-b7ad-4f45-982e-ddf313b7958b@www.fastmail.com>

Daniel Shahaf wrote:
> This subcommand is undocumented (except one mention in the release
> notes); is it a public API?

Features being undocumented hasn't necessarily stopped us from
including them in completion in the past. I don't think there's any
established policy on this and it can depend on specific cases. In
some cases you would want completion to understand but not offer
the undocumented match (like ! in _arguments specs). This particular
patch seems reasonable to me as-is.

> «git --version --build-options» also works, but doesn't seem to be
> documented, either.

The output of git --version -h or git version -h mentions it. I'd say
that counts even if the man page omits to mention it.

Oliver

  reply	other threads:[~2020-01-19 23:10 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-01-19 21:31 Eitan Adler
2020-01-19 22:13 ` Daniel Shahaf
2020-01-19 23:09   ` Oliver Kiddle [this message]
2020-01-19 23:31     ` Daniel Shahaf
2020-01-20  2:00   ` Eitan Adler

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=62021-1579475363.693409@694T.IZIu.-Z_U \
    --to=okiddle@yahoo.co.uk \
    --cc=d.s@daniel.shahaf.name \
    --cc=lists@eitanadler.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).