0
0
mirror of https://gitlab.nic.cz/labs/bird.git synced 2024-12-22 09:41:54 +00:00

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.
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

View File

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

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

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

View File

@ -137,7 +137,7 @@ script created using GNU Autoconf.
<p>The documentation is generated using <file/SGMLtools/ with our own DTD
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.
<p>The comments from C sources which form a part of the programmer's

View File

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

View File

@ -190,6 +190,9 @@
<tag> + "\\item\[{\\ttfamily "
</tag> "}\] \\mbox{}\n\n"
<tagp> + "\\item\[ "
</tagp> "\] \\mbox{}\n\n"
<cite> "\\cite{[ID]"
</cite> "}"
@ -250,6 +253,32 @@
<cf> "{\\ttfamily "
</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
<cparam> "\\cparam{"
</cparam> "}"

View File

@ -12,7 +12,12 @@ anywhere else. <pavel@ucw.cz>
Tom Gordon.
$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.
Revision 1.1 2000/05/29 12:05:21 mj
@ -108,7 +113,7 @@ anywhere else. <pavel@ucw.cz>
<!entity % sectpar
" %par; | figure | tabular | table | %mathpar; |
%thrm; | %litprog; ">
%thrm; | %litprog; | function ">
<!element birddoc o o
(sect | chapt | article | report |
book | letter | telefax | slides | notes | manpage ) >
@ -172,6 +177,9 @@ anywhere else. <pavel@ucw.cz>
<!element type - - (%inline)>
<!element funcdef - - (%inline)>
<!element function - - (%inline | p | funcsect)*>
<!element funcsect - o (%inline)>
<!entity ftag '<f>' -- formula begin -- >
<!entity qendtag '</sq>'>