zsh-workers
 help / color / mirror / code / Atom feed
From: "Daniel Shahaf" <d.s@daniel.shahaf.name>
To: zsh-workers@zsh.org
Subject: Re: PATCH: update completions for procps 3.3.16
Date: Mon, 08 Feb 2021 07:55:15 +0000	[thread overview]
Message-ID: <e4d94817-a53e-468d-bfcd-7b973fd6171d@www.fastmail.com> (raw)
In-Reply-To: <27939-1612662514.721483@P16v.HIcB.BuEO>

Oliver Kiddle wrote on Sun, 07 Feb 2021 01:48 +00:00:
> I'm not keen on tracking these versions in comments in the completion
> files themself because updating the comment everytime there's a new
> release that doesn't add options would get silly.

I don't see the problem.  If you review procps 3.3.17 and find that it
_doesn't_ add new options, that'd be useful information to share with
other maintainers of the procps completion, so as to avoid duplication
of work.

Right there at the top of the file seems like the best place for the
version number datum, because that way there is no atomicity problem
when updating the completion.  Recording that datum in the log message,
as this patch does, means there's no way to update the datum without
making a dummy change to the file (Git's data model can't represent
"Commit X touched ./foo but didn't change it").

The usual argument against churn is that any change risks causing
a regression or disrupting future git-blame(1) or git-bisect(1) work.
These concerns don't seem to apply to version number comments.

All that said, you're doing the work so it's your decision.

Cheers,

Daniel


      reply	other threads:[~2021-02-08  7:56 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-02-07  1:48 Oliver Kiddle
2021-02-08  7:55 ` Daniel Shahaf [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=e4d94817-a53e-468d-bfcd-7b973fd6171d@www.fastmail.com \
    --to=d.s@daniel.shahaf.name \
    --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).