Jerry/bird
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Formatting of progdoc works in both HTML and LaTeX. The LaTeX output

Browse source 
still has somewhat weird spacing, but it will be hopefully easy
to fix.
This commit is contained in:
Martin Mares 2000-05-31 14:24:21 +00:00
parent d1660fd3f3
commit fcdddff5f3
6 changed files with 51 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
doc/kernel-doc
View file

@ -524,9 +524,7 @@ sub output_bird {
my %args = %{$_[0]}; my %args = %{$_[0]};
my ($parameter, $section); my ($parameter, $section);
my $count; my $count;
print "<sect2>Function\n"; print "<function><p><type>".$args{'functiontype'}."</type>\n";
print "<p><type>".$args{'functiontype'}."</type>\n";
print "<funcdef>".$args{'function'}."</funcdef>\n"; print "<funcdef>".$args{'function'}."</funcdef>\n";
print "("; print "(";
$count = 0; $count = 0;
@ -539,7 +537,7 @@ sub output_bird {
} }
print ")\n"; print ")\n";
print "<sect3>Arguments\n"; print "<funcsect>Arguments\n";
print "<p><descrip>\n"; print "<p><descrip>\n";
foreach $parameter (@{$args{'parameterlist'}}) { foreach $parameter (@{$args{'parameterlist'}}) {
print "<tagp><type>".$args{'parametertypes'}{$parameter}."</type> <param>".$parameter."</param></tagp>\n"; print "<tagp><type>".$args{'parametertypes'}{$parameter}."</type> <param>".$parameter."</param></tagp>\n";
@ -551,7 +549,7 @@ sub output_bird {
print "<p>\n"; print "<p>\n";
output_highlight($args{'sections'}{$section}); output_highlight($args{'sections'}{$section});
} }
print "<hrule>\n"; print "</function>\n";
} }
# output in birddoc # output in birddoc

2
doc/prog-foot.sgml Normal file
View file

@ -0,0 +1,2 @@
</article>

2
doc/prog-intro.sgml
View file

@ -137,7 +137,7 @@ script created using GNU Autoconf.
<p>The documentation is generated using <file/SGMLtools/ with our own DTD <p>The documentation is generated using <file/SGMLtools/ with our own DTD
and mapping rules. The printed form of the documentation is first converted and mapping rules. The printed form of the documentation is first converted
from SGML to <LaTeX> and then processed by <LaTeX> and <file/dvips/ to from SGML to &latex; and then processed by &tex; and <file/dvips/ to
produce a PostScript file. produce a PostScript file.
<p>The comments from C sources which form a part of the programmer's <p>The comments from C sources which form a part of the programmer's

6
doc/sbase/dist/birddoc/html/mapping vendored
View file

@ -182,6 +182,12 @@
<funcdef> "<B>" <funcdef> "<B>"
</funcdef> "</B>" </funcdef> "</B>"
<function> "<HR><H3>Function</H3>\n"
</function> "\n"
<funcsect> "<H3>"
</funcsect> "</H3>\n"
% url support by HG % url support by HG
<url> + "<@@url>[URL]\n" <url> + "<@@url>[URL]\n"

29
doc/sbase/dist/birddoc/latex2e/mapping vendored
View file

@ -190,6 +190,9 @@
<tag> + "\\item\[{\\ttfamily " <tag> + "\\item\[{\\ttfamily "
</tag> "}\] \\mbox{}\n\n" </tag> "}\] \\mbox{}\n\n"
<tagp> + "\\item\[ "
</tagp> "\] \\mbox{}\n\n"
<cite> "\\cite{[ID]" <cite> "\\cite{[ID]"
</cite> "}" </cite> "}"
@ -250,6 +253,32 @@
<cf> "{\\ttfamily " <cf> "{\\ttfamily "
</cf> "}" </cf> "}"
<const> "{\\tt "
</const> "}"
<func> "{\\it "
</func> "\\/}"
<struct> "{\\tt "
</struct> "}"
<param> "{\\it "
</param> "}"
<type> "{\\rm "
</type> "}"
<funcdef> "{\\it "
</funcdef> "\\/}"
<function> "\\bigbreak\\hrule\\nobreak\\bigskip\\nobreak\\leftline{\\bf Function}\\nobreak\\smallskip\\nobreak{\\parskip=0pt "
</function> "}\n\n"
<funcsect> "\n\\medbreak\\leftline{\\bf "
</funcsect> "}\\nobreak "
<hrule> "\\hrule"
% Added by mdw % Added by mdw
<cparam> "\\cparam{" <cparam> "\\cparam{"
</cparam> "}" </cparam> "}"

12
doc/sbase/dtd/birddoc.dtd
View file

@ -12,7 +12,12 @@ anywhere else. <pavel@ucw.cz>
Tom Gordon. Tom Gordon.
$Log$ $Log$
Revision 1.2 2000-05-31 11:28:52 mj Revision 1.3 2000-05-31 14:24:21 mj
Formatting of progdoc works in both HTML and LaTeX. The LaTeX output
still has somewhat weird spacing, but it will be hopefully easy
to fix.
Revision 1.2 2000/05/31 11:28:52 mj
Added tags for markup of programmer's documentation. Added tags for markup of programmer's documentation.
Revision 1.1 2000/05/29 12:05:21 mj Revision 1.1 2000/05/29 12:05:21 mj
@ -108,7 +113,7 @@ anywhere else. <pavel@ucw.cz>
<!entity % sectpar <!entity % sectpar
" %par; | figure | tabular | table | %mathpar; | " %par; | figure | tabular | table | %mathpar; |
%thrm; | %litprog; "> %thrm; | %litprog; | function ">
<!element birddoc o o <!element birddoc o o
(sect | chapt | article | report | (sect | chapt | article | report |
book | letter | telefax | slides | notes | manpage ) > book | letter | telefax | slides | notes | manpage ) >
@ -172,6 +177,9 @@ anywhere else. <pavel@ucw.cz>
<!element type - - (%inline)> <!element type - - (%inline)>
<!element funcdef - - (%inline)> <!element funcdef - - (%inline)>
<!element function - - (%inline | p | funcsect)*>
<!element funcsect - o (%inline)>
<!entity ftag '<f>' -- formula begin -- > <!entity ftag '<f>' -- formula begin -- >
<!entity qendtag '</sq>'> <!entity qendtag '</sq>'>