Documentation: lost-found is now deprecated.

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" and "git tar-tree" as deprecated.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Junio C Hamano
2007-11-08 17:21:48 -08:00
parent c238dad407
commit 0bf15e7438

View File

@ -3,7 +3,8 @@
use File::Compare qw(compare); use File::Compare qw(compare);
sub format_one { sub format_one {
my ($out, $name) = @_; my ($out, $nameattr) = @_;
my ($name, $attr) = @$nameattr;
my ($state, $description); my ($state, $description);
$state = 0; $state = 0;
open I, '<', "$name.txt" or die "No such file $name.txt"; 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"; die "No description found in $name.txt";
} }
if (my ($verify_name, $text) = ($description =~ /^($name) - (.*)/)) { if (my ($verify_name, $text) = ($description =~ /^($name) - (.*)/)) {
print $out "gitlink:$name\[1\]::\n"; print $out "gitlink:$name\[1\]::\n\t";
print $out "\t$text.\n\n"; if ($attr) {
print $out "($attr) ";
}
print $out "$text.\n\n";
} }
else { else {
die "Description does not match $name: $description"; die "Description does not match $name: $description";
@ -39,8 +43,8 @@ while (<DATA>) {
next if /^#/; next if /^#/;
chomp; chomp;
my ($name, $cat) = /^(\S+)\s+(.*)$/; my ($name, $cat, $attr) = /^(\S+)\s+(.*?)(?:\s+(.*))?$/;
push @{$cmds{$cat}}, $name; push @{$cmds{$cat}}, [$name, $attr];
} }
for my $cat (qw(ancillaryinterrogators for my $cat (qw(ancillaryinterrogators
@ -126,7 +130,7 @@ git-instaweb ancillaryinterrogators
gitk mainporcelain gitk mainporcelain
git-local-fetch synchingrepositories git-local-fetch synchingrepositories
git-log mainporcelain git-log mainporcelain
git-lost-found ancillarymanipulators git-lost-found ancillarymanipulators deprecated
git-ls-files plumbinginterrogators git-ls-files plumbinginterrogators
git-ls-remote plumbinginterrogators git-ls-remote plumbinginterrogators
git-ls-tree plumbinginterrogators git-ls-tree plumbinginterrogators
@ -187,7 +191,7 @@ git-submodule mainporcelain
git-svn foreignscminterface git-svn foreignscminterface
git-symbolic-ref plumbingmanipulators git-symbolic-ref plumbingmanipulators
git-tag mainporcelain git-tag mainporcelain
git-tar-tree plumbinginterrogators git-tar-tree plumbinginterrogators deprecated
git-unpack-file plumbinginterrogators git-unpack-file plumbinginterrogators
git-unpack-objects plumbingmanipulators git-unpack-objects plumbingmanipulators
git-update-index plumbingmanipulators git-update-index plumbingmanipulators