CVS shishi/doc

[shishi-commit]

Update of /home/cvs/shishi/doc
In directory dopio:/tmp/cvs-serv11187

Modified Files:
        gdoc 
Log Message:
Improve man pages, from libidn.


--- /home/cvs/shishi/doc/gdoc   2004/10/28 11:43:51     1.8
+++ /home/cvs/shishi/doc/gdoc   2004/11/21 18:04:50     1.9
@@ -161,10 +161,10 @@
 $blankline_sgml = "</para><para>\n";
 
 # these are pretty rough
-%highlights_man = ( "\\s*" .$type_constant . "\\s*", "\\n.I \\\"\$1\\\"\\n",
-                   $type_func . "\\s*", "\\n.B \\\"\$1\\\"\\n",
-                   $type_struct . "\\s*", "\\n.I \\\"\$1\\\"\\n",
-                   $type_param."([\.\, ]*)\n?", "\\n.I \\\"\$1\$2\\\"\\n" );
+%highlights_man = ( $type_constant, "\\\\fB\$1\\\\fP",
+                   $type_func, "\\\\fB\$1\\\\fP",
+                   $type_struct, "\\\\fB\$1\\\\fP",
+                   $type_param, "\\\\fI\$1\\\\fP" );
 $blankline_man = "";
 
 # text-mode
@@ -594,11 +594,14 @@
     my ($parameter, $section);
     my $count;
 
+    print ".\\\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.\n";
     print ".TH \"$args{'function'}\" 3 \"$args{'sourceversion'}\" \"". 
$args{'module'} . "\" \"". $args{'module'} . "\"\n";
 
     print ".SH NAME\n";
 
-    print $args{'function'}."\n";
+    print $args{'function'};
+    print " \\- " . $args{'purpose'} if ($args{'purpose'});
+    print "\n";
 
     print ".SH SYNOPSIS\n";
     print ".B #include <". $args{'include'} . ">\n"
@@ -812,7 +815,7 @@
            if (/$doc_func/o) {
                $function = $1;
                $state = 2;
-               if (/-(.*)/) {
+               if (/-\s*(.*)/) {
                    $function_purpose = $1;
                } else {
                    $function_purpose = "";