From fcdddff5f3f5c9f2a15377a9dd08f105a3b696a0 Mon Sep 17 00:00:00 2001
From: Martin Mares <mj@ucw.cz>
Date: Wed, 31 May 2000 14:24:21 +0000
Subject: 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.

---
 doc/kernel-doc                         |  8 +++-----
 doc/prog-foot.sgml                     |  2 ++
 doc/prog-intro.sgml                    |  2 +-
 doc/sbase/dist/birddoc/html/mapping    |  6 ++++++
 doc/sbase/dist/birddoc/latex2e/mapping | 29 +++++++++++++++++++++++++++++
 doc/sbase/dtd/birddoc.dtd              | 12 ++++++++++--
 6 files changed, 51 insertions(+), 8 deletions(-)
 create mode 100644 doc/prog-foot.sgml

(limited to 'doc')

diff --git a/doc/kernel-doc b/doc/kernel-doc
index cb28d30..07d1262 100755
--- a/doc/kernel-doc
+++ b/doc/kernel-doc
@@ -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
diff --git a/doc/prog-foot.sgml b/doc/prog-foot.sgml
new file mode 100644
index 0000000..c847722
--- /dev/null
+++ b/doc/prog-foot.sgml
@@ -0,0 +1,2 @@
+
+</article>
diff --git a/doc/prog-intro.sgml b/doc/prog-intro.sgml
index 18637fe..e4affaf 100644
--- a/doc/prog-intro.sgml
+++ b/doc/prog-intro.sgml
@@ -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
diff --git a/doc/sbase/dist/birddoc/html/mapping b/doc/sbase/dist/birddoc/html/mapping
index e703fb4..9d05a76 100644
--- a/doc/sbase/dist/birddoc/html/mapping
+++ b/doc/sbase/dist/birddoc/html/mapping
@@ -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"
diff --git a/doc/sbase/dist/birddoc/latex2e/mapping b/doc/sbase/dist/birddoc/latex2e/mapping
index e12ef7d..2875c6d 100644
--- a/doc/sbase/dist/birddoc/latex2e/mapping
+++ b/doc/sbase/dist/birddoc/latex2e/mapping
@@ -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>		"}"
diff --git a/doc/sbase/dtd/birddoc.dtd b/doc/sbase/dtd/birddoc.dtd
index 4e818ab..f7fbcc6 100644
--- a/doc/sbase/dtd/birddoc.dtd
+++ b/doc/sbase/dtd/birddoc.dtd
@@ -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>'>
 
-- 
cgit v1.2.3