ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/gvpe/doc/pod2texi
Revision: 1.5
Committed: Sat Jan 22 17:39:07 2005 UTC (19 years, 4 months ago) by pcg
Branch: MAIN
Changes since 1.4: +157 -97 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 pcg 1.4 #!/usr/bin/perl
2 pcg 1.1
3 pcg 1.3 use Pod::Tree;
4    
5 pcg 1.1 sub escape_texi($) {
6     local $_ = shift;
7     s/([\@\{\}])/\@$1/g;
8     s/\n+/ /g;
9     $_;
10     }
11    
12 pcg 1.3 sub example {
13     my $text = $_[0];
14     $text =~ s/\n+$//;
15 pcg 1.4 $text =~ s/([\@\{\}])/\@$1/g;
16 pcg 1.5
17     "\n\n\@example\n"
18     . $text
19     . "\n\@end example\n\n";
20     }
21    
22     my @nodes; # nodelist
23     my @ctx; # curstack
24    
25     sub out {
26     $ctx[-1]{out} .= join "", @_;
27 pcg 1.3 }
28    
29 pcg 1.5 sub parse_pod {
30     my ($data) = @_;
31     local $out;
32    
33     my $pod = new Pod::Tree;
34     $pod->load_string($data);
35    
36     my $walker; $walker = sub {
37     my $n = $_[0];
38     if ($n->is_code) {
39     # nop
40     } elsif ($n->is_link) {
41     my $target = $n->get_target;
42     my $page = $target->get_page;
43     my $section = $target->get_section;
44    
45     $walker->($_) for @{$n->get_children};
46     } elsif ($n->is_text) {
47     out escape_texi $n->get_text;
48     } elsif ($n->is_verbatim) {
49     out example $n->get_text;
50     } elsif ($n->is_sequence) {
51     if ($n->get_letter eq "C") {
52     out "\@t{";
53     $walker->($_) for @{$n->get_children};
54     out "}";
55     } elsif ($n->get_letter eq "B") {
56     out "\@strong{";
57     $walker->($_) for @{$n->get_children};
58     out "}";
59     } elsif ($n->get_letter eq "I" or $n->get_letter eq "F") {
60     out "\@emph{";
61     $walker->($_) for @{$n->get_children};
62     out "}";
63     } else {
64     # S would mean to use nbsp
65     $walker->($_) for @{$n->get_children};
66     }
67     } elsif ($n->is_command) {
68     if ($n->is_c_head1) {
69     out "\n\@section ";
70     $walker->($_) for @{$n->get_children};
71     out "\n";
72     } elsif ($n->is_c_head2) {
73     out "\n\n\@subsection ";
74     $walker->($_) for @{$n->get_children};
75     out "\n";
76     } else {
77     # nop?
78     }
79     } elsif ($n->is_ordinary) {
80     $walker->($_) for @{$n->get_children};
81     out "\@refill\n";
82     } elsif ($n->is_root) {
83     $walker->($_) for @{$n->get_children};
84     } elsif ($n->is_list) {
85     out "\n\n\@itemize\n";
86     $walker->($_) for @{$n->get_children};
87     out "\@end itemize\n\n";
88     } elsif ($n->is_item) {
89     out "\n\n\@item\n";
90     out "\@b{";
91     $walker->($_) for @{$n->get_children};
92     out "}\n\n";
93     $walker->($_) for @{$n->get_siblings};
94     } elsif ($n->is_for) {
95     my $text = $n->get_text;
96    
97     if ($n->get_command eq "begin") {
98     if ($n->{brackets}[0] =~ / header/) {
99     $header = $text;
100     } elsif ($n->{brackets}[0] =~ / footer/) {
101     $footer = $text;
102 pcg 1.3 } else {
103 pcg 1.5 out $text;
104 pcg 1.3 }
105    
106 pcg 1.5 } elsif ($text =~ /^menu-begin/) {
107     out "\n\@menu\n";
108    
109     push @ctx, {}; # dummy node
110    
111     } elsif ($text =~ /^menu-item (.*?)::\s+(.*)/) {
112     my ($name, $desc) = ($1, $2);
113    
114     push @{ $ctx[-2]{menu} }, [$name, $desc];
115     $ctx[-2]{width} = length $name if $ctx[-2]{width} < length $name;
116    
117     my $ctx = {
118     name => $name,
119     up => $ctx[-2]{name},
120     };
121     push @nodes, $ctx;
122     $ctx[-1] = $ctx;
123    
124     } elsif ($text =~ /^menu-end/) {
125     pop @ctx;
126    
127     for (@{ $ctx[-1]{menu} }) {
128     out sprintf "* %-*s %s\n", $ctx[-1]{width} + 2, "$_->[0]::", $_->[1];
129     }
130    
131     out "\@end menu\n";
132    
133     } elsif ($text =~ /^include (\S+) (.*)/) {
134     my ($type, $path) = ($1, $2);
135    
136     open my $x, "<$path" or die "$path: $!";
137     my $data = do { local $/; <$x> };
138    
139     if ($type eq "pod") {
140     out parse_pod ($data);
141     } elsif ($type eq "text") {
142     out $data;
143     } elsif ($type eq "example") {
144     out example $data;
145     }
146    
147     } else {
148     die "UNKNOWN for command <$text>\n";
149     }
150    
151     } else {
152     die "UNKNOWN NODE $_[0]{type}\n";
153     $walker->($_) for @{$n->get_children};
154 pcg 1.3 }
155 pcg 1.5 };
156    
157     $walker->($pod->get_root);
158 pcg 1.1 }
159    
160 pcg 1.5 @ctx = @nodes = {
161     up => "(dir)",
162     name => "Top",
163     };
164    
165     parse_pod do { local $/; <> };
166    
167     print $header;
168    
169     for (0 .. $#nodes) {
170     my $node = $nodes[$_];
171     my $prev = $_ > 0 ? $nodes[$_-1] : undef;
172     my $next = $nodes[$_+1];
173    
174     print "\@node $node->{name},$next->{name},$prev->{name},$node->{up}\n\n",
175     "\@chapter $node->{name}\n",
176     "$node->{out}\n\n";
177     }
178    
179     print $footer;
180