1
  
2
  
3
  
4
  
5
  
6
  
7
  
8
  
9
  
10
  
11
  
12
  
13
  
14
  
15
  
16
  
17
  
18
  
19
  
20
  
21
  
22
  
23
  
24
  
25
  
26
  
27
  
28
  
29
  
30
  
31
  
32
  
33
  
34
  
35
  
36
  
37
  
38
  
39
  
40
  
41
  
42
  
43
  
44
  
45
  
46
  
47
  
48
  
49
  
50
  
51
  
52
  
53
  
54
  
55
  
56
  
57
  
58
  
59
  
60
  
61
  
62
  
63
  
64
  
65
  
66
  
67
  
68
  
69
  
70
  
71
  
72
  
73
  
74
  
75
  
76
  
77
  
78
  
79
  
80
  
81
  
82
  
83
  
84
  
85
  
86
  
87
  
88
  
89
  
90
  
91
  
92
  
93
  
94
  
95
  
// The Manual Tag 
// 
// Fredrik Noring 
// 
 
constant cvs_version = "$Id: manual.pike,v 1.1 1998/03/07 21:45:01 noring Exp $"; 
constant thread_safe=1; 
 
#include <module.h> 
inherit "module"; 
inherit "roxenlib"; 
 
static private int loaded; 
 
static private string doc() 
{ 
  return !loaded?"":replace(Stdio.read_bytes("modules/tags/doc/manual")||"", 
                            ({ "{", "}" }), ({ "&lt;", "&gt;" })); 
} 
 
array file_finder(string entry, int lvl) 
{ 
  array files = ({}), fs = file_stat(entry); 
  if(!fs || lvl > 500) 
    return files; 
  switch(fs[1]) { 
  case -2: 
  case -3: 
    foreach(get_dir(entry)||({}), string dir) 
      files += file_finder(combine_path(entry, dir), ++lvl); 
    break; 
  default: 
    files = ({ entry }); 
  } 
  return files; 
} 
 
array module_files() 
{ 
  array files = ({}); 
  foreach(roxen->query("ModuleDirs"), string dir) 
    files += file_finder(dir, 0); 
  return files; 
} 
 
string read_manual(string file) 
{ 
  return !loaded?"":replace(Stdio.read_bytes(file)||"<b>File not found.</b>", 
                            ({ "{", "}" }), ({ "&lt;", "&gt;" })); 
} 
 
string tag_manual(string tag_name, mapping args, object id, 
                  object file, mapping defines) 
{ 
  array a = glob("*manual.html", module_files()); 
  mapping files = ([]); 
  foreach(a, string m) 
    sscanf((m/"/")[-1], "%s.manual.html", files[m]); 
  mapping manuals = mkmapping(values(files), indices(files)); 
 
  if(!sizeof(args) || args["help"]) 
    return "<h3>Manual</h3>This tag is the manual librarian.<p>"; 
 
  if(args["list-manuals"]) 
    return (sizeof(manuals)?sort(indices(manuals))*"<br>": 
            "<b>No manuals found.</b>"); 
 
  string man = indices(args)[0]; 
  if(sizeof(man) && manuals[man]) 
    return read_manual(manuals[man]); 
  return ("<b>Manual ``"+man+"'' not found.</b> " 
          "See <tt>&lt;manual help&gt</tt> for more information.<p>"); 
} 
 
array register_module() 
{ 
  return ({ 
    MODULE_PARSER, 
      "Manual tag", 
      "This tag is the manual librarian.<p>" 
      "See <tt>&lt;manual help&gt</tt> for more information.\n\n<p>"+doc(), 
      0, 1 }); 
} 
 
void start(int num, object configuration) 
{ 
  loaded = 1; 
} 
 
mapping query_tag_callers() 
{ 
  return ([ "manual":tag_manual, ]); 
}