ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/ext/help.ext
(Generate patch)

Comparing deliantra/server/ext/help.ext (file contents):
Revision 1.2 by root, Wed Apr 18 17:32:06 2007 UTC vs.
Revision 1.16 by root, Tue Sep 23 05:01:41 2008 UTC

1#! perl 1#! perl
2 2
3our $TOPIC; 3our $TOPIC;
4 4
5our $HELP_CHANNEL = {
6 id => "help",
7 title => "Help",
8 reply => "help ",
9 tooltip => "Online Help",
10};
11
5sub load_topics($) { 12sub load_topics($$) {
6 my ($path) = @_; 13 my ($type, $path) = @_;
7 14
8 my $paragraphs = cf::pod::load_pod "$PODDIR/$path.pod" 15 my $paragraphs = cf::pod::load_pod "$PODDIR/$path.pod"
9 or die "unable to load $path"; 16 or die "unable to load $path";
10 17
11 my @topics; 18 my @topics;
12 my $level = 1e9; 19 my $level = 1e9;
13 20
14 for my $par (@$paragraphs) { 21 for my $par (@$paragraphs) {
15 Coro::cede; 22 cf::cede_to_tick;
16 if ($par->{type} eq "head2") { 23 if ($par->{type} eq "head2") {
17 if ($par->{markup} =~ /^(\S+)/) { 24 if ($par->{markup} =~ /^(\S+)/) {
18 push @topics, $1 => [$par]; 25 push @topics, $1 => [$type => $par];
19 $level = $par->{level}; 26 $level = $par->{level};
20 } 27 }
21 } elsif ($par->{level} > $level) { 28 } elsif ($par->{level} > $level) {
22 push @{ $topics[-1] }, $par; 29 push @{ $topics[-1] }, $par;
23 } 30 }
… …
25 32
26 @topics 33 @topics
27} 34}
28 35
29sub reload() { 36sub reload() {
37 my $guard = cf::lock_acquire "ext::help::loading";
38
39 local $Coro::current->{desc} = "help loader";
40
30 $TOPIC = { 41 $TOPIC = {
31 load_topics "dmcommand_help", 42 (load_topics "DM Commands" => "dmcommand_help"),
32 load_topics "emote_help", 43 (load_topics "Emotes" => "emote_help"),
33 load_topics "command_help", 44 (load_topics "Commands" => "command_help"),
34 load_topics "generic_help", 45 (load_topics "Generic Help Topics" => "generic_help"),
35 }; 46 };
47
48 ()
36} 49}
37 50
38cf::sync_job { 51cf::post_init {
39 my $guard = cf::lock_acquire "ext::help::loading";
40 cf::async_ext { 52 cf::async {
41 reload; 53 reload;
42 undef $guard;
43 }; 54 };
44}; 55};
45 56
46cf::register_command xhelp => sub { 57cf::register_command help => sub {
47 my ($pl, $topic) = @_; 58 my ($pl, $topic) = @_;
48 59
49 if (cf::lock_active "ext::help::loading") { 60 if (cf::lock_active "ext::help::loading") {
50 $pl->reply (undef, "help files are being loaded currently, try again in a few seconds"); 61 $pl->send_msg ($HELP_CHANNEL => "help files are being loaded currently, try again in a few seconds.", cf::NDI_REPLY | cf::NDI_CLEAR);
51 return; 62 return;
52 } 63 }
64
65 $topic = $1 if $topic =~ /(\S+)/;
66
67 if (!length $topic) {
68 # sort..
69
70 my %topics;
71 while (my ($k, $v) = each %$TOPIC) {
72 push @{$topics{$v->[0]}}, $k;
73 }
74
75 my $res;
76 while (my ($k, $v) = each %topics) {
77 $res .= "T<$k:>\n\n" . (join " ", sort @$v) . "\n\n";
78 }
79
80 $pl->send_msg ($HELP_CHANNEL => $res, cf::NDI_REPLY | cf::NDI_CLEAR);
81
82 } elsif (my $item = $TOPIC->{$topic}) {
83 my ($type, @pars) = @$item;
84 $pl->send_msg ($HELP_CHANNEL => (cf::pod::as_cfpod \@pars), cf::NDI_REPLY | cf::NDI_CLEAR);
85
86 } else {
87 $pl->send_msg ($HELP_CHANNEL => "'$topic' no such help topic, try just 'help' to get a list of topics.", cf::NDI_REPLY);
88 }
53}; 89};
90

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines