git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] Drop deprecated commands from git(7) and update deprecation notices

From
Junio C Hamano <gitster@pobox.com>
Date
Nov 8, 2007, 21:01 UTC
Message-ID
<7vzlxo1mga.fsf@gitster.siamese.dyndns.org>
In-Reply-To
<20071108160114.GB20988@diku.dk>
Thanks.

But lost-found is merely deprecated but not removed yet, so I think it should be kept in the list cmd-list.perl generates.

We may want a mechanism to mark it deprecated in the list as well, though. Perhaps ...

---
 Documentation/cmd-list.perl |   16 ++++++++++------
 1 files changed, 10 insertions(+), 6 deletions(-)
diff --git a/Documentation/cmd-list.perl b/Documentation/cmd-list.perl
index 8d21d42..0066064 100755
--- a/Documentation/cmd-list.perl
+++ b/Documentation/cmd-list.perl
@@ -3,7 +3,8 @@
 use File::Compare qw(compare);
 
 sub format_one {
-	my ($out, $name) = @_;
+	my ($out, $nameattr) = @_;
+	my ($name, $attr) = @$nameattr;
 	my ($state, $description);
 	$state = 0;
 	open I, '<', "$name.txt" or die "No such file $name.txt";
@@ -26,8 +27,11 @@ sub format_one {
 		die "No description found in $name.txt";
 	}
 	if (my ($verify_name, $text) = ($description =~ /^($name) - (.*)/)) {
-		print $out "gitlink:$name\[1\]::\n";
-		print $out "\t$text.\n\n";
+		print $out "gitlink:$name\[1\]::\n\t";
+		if ($attr) {
+			print $out "($attr) ";
+		}
+		print $out "$text.\n\n";
 	}
 	else {
 		die "Description does not match $name: $description";
@@ -39,8 +43,8 @@ while (<DATA>) {
 	next if /^#/;
 
 	chomp;
-	my ($name, $cat) = /^(\S+)\s+(.*)$/;
-	push @{$cmds{$cat}}, $name;
+	my ($name, $cat, $attr) = /^(\S+)\s+(.*?)(?:\s+(.*))?$/;
+	push @{$cmds{$cat}}, [$name, $attr];
 }
 
 for my $cat (qw(ancillaryinterrogators
@@ -126,7 +130,7 @@ git-instaweb                            ancillaryinterrogators
 gitk                                    mainporcelain
 git-local-fetch                         synchingrepositories
 git-log                                 mainporcelain
-git-lost-found                          ancillarymanipulators
+git-lost-found                          ancillarymanipulators	deprecated
 git-ls-files                            plumbinginterrogators
 git-ls-remote                           plumbinginterrogators
 git-ls-tree                             plumbinginterrogators
Previous: Jonas FonsecaNext: Jonas Fonseca
Message 8 of 22 in “Deprecate git-lost-found”
  1. Deprecate git-lost-foundJohannes Schindelin, Nov 7, 2007
  2. Junio C HamanoNov 8, 2007
  3. Johannes SchindelinNov 8, 2007
  4. Deprecate git-lost-foundJohannes Schindelin, Nov 8, 2007
  5. Remove deprecated commands from command list and update manpagesJonas Fonseca, Nov 8, 2007
  6. Andreas EricssonNov 8, 2007
  7. Drop deprecated commands from git(7) and update deprecation noticesJonas Fonseca, Nov 8, 2007
  8. Junio C HamanoNov 8, 2007
  9. Remove non-existing commands from git(7) and delete their manpagesJonas Fonseca, Nov 9, 2007
  10. 1/3 Documentation: lost-found is now deprecated.Junio C Hamano, Nov 9, 2007
  11. Jonas FonsecaNov 9, 2007
  12. Junio C HamanoNov 9, 2007
  13. 3/3 Documentation: remove documentation for removed tools.Junio C Hamano, Nov 9, 2007
  14. Documentation: Fix references to deprecated commandsJonas Fonseca, Nov 12, 2007
  15. Jonas FonsecaNov 12, 2007
  16. Junio C HamanoNov 12, 2007
  17. Jonas FonsecaNov 12, 2007
  18. J. Bruce FieldsNov 19, 2007
  19. Jonas FonsecaNov 19, 2007
  20. 2/3 Make check-docs target detect removed commandsJunio C Hamano, Nov 9, 2007
  21. Johannes SchindelinNov 8, 2007
  22. Johannes SchindelinNov 8, 2007

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.