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

[PATCH 1/3] Documentation: lost-found is now deprecated.

From
Junio C Hamano <gitster@pobox.com>
Date
Nov 9, 2007, 01:21 UTC
Message-ID
<7v7iksz00j.fsf_-_@gitster.siamese.dyndns.org>
In-Reply-To
<20071109002001.GB5082@diku.dk>

This makes it possible to mark commands that are deprecated in the command list of the primary manual page git(7), and uses it to mark "git lost-found" as deprecated.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
---
 * Here is what I have been preparing for queuing.
 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
-- 
1.5.3.5.1622.g41d10
Previous: Jonas FonsecaNext: Jonas Fonseca
Message 10 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.