X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=cmd%2Fhelp.pl;h=cc9eee3a1cf3d32e58d3b090212c373b0614d619;hb=eac4538f1f78b3d014539dc548fc6322e8337429;hp=60eef05943eb133654f0b802583c2b613bee3405;hpb=2546ef0cfaaca39e65985e414258071a636979af;p=spider.git diff --git a/cmd/help.pl b/cmd/help.pl index 60eef059..cc9eee3a 100644 --- a/cmd/help.pl +++ b/cmd/help.pl @@ -2,18 +2,120 @@ # the help subsystem # # It is a very simple system in that you type in 'help ' and it -# looks for a file called .hlp in either the local_cmd directory +# looks for a file called command.hlp in either the local_cmd directory # or the cmd directory (in that order). # -# if you just type in 'help' by itself you get what is in 'help.hlp'. -# # Copyright (c) 1998 - Dirk Koopman G1TLH # -# $Id$ +# # my ($self, $line) = @_; my @out; +# this is naff but it will work for now +my $lang = $self->lang; +$lang = 'en' if !$lang; + +# each help file contains lines that looks like:- +# +# === 0^*^Description +# text +# text +# +# === 0^help^Description +# text +# text +# text +# +# The fields are:- privilege level, full command name, short description +# + +#$DB::single = 1; + + +my $defh = new IO::File; +unless ($defh->open("$main::localcmd/Commands_en.hlp")) { + unless($defh->open("$main::cmd/Commands_en.hlp")) { + return (1, $self->msg('helpe1')); + } +} + +my $h; +if ($lang ne 'en') { + $h = new IO::File; + unless ($h->open("$main::localcmd/Commands_$lang.hlp")) { + unless($h->open("$main::cmd/Commands_$lang.hlp")) { + undef $h; + } + } +} + +my $in; + +#$line =~ s/[^\w\/]//g; +#$line =~ s/\//\.\*\//g; + +$line =~ s{[^\w/]}{}g; +$line =~ s{/}{.*/}g; +$line =~ s/^\s+//g; +$line =~ s/[\s\r]+$//g; +$line = "help" if $line =~ /^\s*$/; + +# sort out aliases +my $alias = CmdAlias::get_hlp($line); +$line = $alias if $alias; + +# non english help (if available) +if ($h) { + my $state = 0; + foreach $in (<$h>) { + next if $in =~ /^\#/; + chomp $in; + $in =~ s/\r$//; + if ($in =~ /^===/) { + last if $state == 2; # come out on next command + $in =~ s/=== //; + my ($priv, $cmd, $desc) = split /\^/, $in; + next if $priv > $self->priv; # ignore subcommands that are of no concern + next unless $cmd =~ /^$line/i; + push @out, "$cmd $desc" unless $cmd =~ /-$/o; + $state = 1; + next; + } + if ($state > 0) { + push @out, " $in"; + $state = 2; + } + } + $h->close; + + # return if some help was given, otherwise continue to english help + return (1, @out) if @out && $state == 2; +} + +# standard 'english' help +my $state = 0; +foreach $in (<$defh>) { + next if $in =~ /^\#/; + chomp $in; + if ($in =~ /^===/) { + last if $state == 2; # come out on next command + $in =~ s/=== //; + my ($priv, $cmd, $desc) = split /\^/, $in; + next if $priv > $self->priv; # ignore subcommands that are of no concern + next unless $cmd =~ /^$line/i; + push @out, "$cmd $desc" unless $cmd =~ /-$/o; + $state = 1; + next; + } + if ($state > 0) { + push @out, " $in"; + $state = 2; + } +} +$defh->close; +push @out, $self->msg('helpe2', $line) if @out == 0; +return (1, @out);