deprecate git-annex status w/o runtime warning

As far as I can see, git-annex status was added to support direct mode, and
like other things added for that, it ought to be deprecated.

Behavior is similar to git status --short, though not identical in a few
cases eg renamed files.

I think datalad does not use this command, although it might have in the
past. Could not find any use of it in the current datalad code.

A deprecation warning at runtime would be the next step, probably will wait
and do that for all the deprecated commands together (except findref).
This commit is contained in:
Joey Hess 2023-02-28 16:34:31 -04:00
parent 3bf2d98e9c
commit 9c3c4c1712
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
4 changed files with 5 additions and 4 deletions

View file

@ -2,6 +2,8 @@ git-annex (10.20230228) UNRELEASED; urgency=medium
* Using git-annex view in an adjusted branch, or git-annex adjust in a
view branch, will enter an adjusted view branch.
* status: This command is deprecated because it was only needed in direct
mode; git status --short is very similar.
-- Joey Hess <id@joeyh.name> Mon, 27 Feb 2023 12:31:14 -0400

View file

@ -15,7 +15,7 @@ cmd :: Command
cmd = notBareRepo $ noCommit $ noMessages $
withAnnexOptions [jsonOptions] $
command "status" SectionCommon
"show the working tree status"
"show the working tree status (deprecated)"
paramPaths (seek <$$> optParser)
data StatusOptions = StatusOptions

View file

@ -1,6 +1,6 @@
# NAME
git-annex status - show the working tree status
git-annex status - show the working tree status (deprecated)
# SYNOPSIS

View file

@ -92,8 +92,7 @@ content from the key-value store.
* `status [path ...]`
Similar to `git status --short`, displays the status of the files in the
working tree.
Show the working tree status. (deprecated)
See [[git-annex-status]](1) for details.