Lines Matching full:n
209 my $blankline_xml = $local_lt . "/para" . $local_gt . $local_lt . "para" . $local_gt . "\n";
217 my $blankline_gnome = "</para><para>\n";
381 print "Usage: $0 [ -docbook | -html | -html5 | -text | -man | -list ]\n";
382 print " [ -no-doc-sections ]\n";
383 print " [ -function funcname [ -function funcname ...] ]\n";
384 print " [ -nofunction funcname [ -nofunction funcname ...] ]\n";
385 print " [ -v ]\n";
386 print " c source file(s) > outputfile\n";
387 print " -v : verbose output, more warnings & other info listed\n";
407 my $contents = join "\n", @_;
411 # print STDERR "constant section '$1' = '$contents'\n";
414 # print STDERR "parameter def '$1' = '$contents'\n";
419 # print STDERR "parameter def '...' = '$contents'\n";
424 # print STDERR "other section '$name' = '$contents'\n";
426 print STDERR "Error(${file}:$.): duplicate section name '$name'\n";
440 my $contents = join "\n", @_;
470 my $contents = join "\n",@_;
476 # confess "output_highlight got called with no args?\n";
485 # print STDERR "contents b4:$contents\n";
488 # print STDERR "contents af:$contents\n";
495 foreach $line (split "\n", $contents) {
511 print "\n";
521 print "<h3>$section</h3>\n";
522 print "<blockquote>\n";
524 print "</blockquote>\n";
533 print "<h2>enum " . $args{'enum'} . "</h2>\n";
535 print "<b>enum " . $args{'enum'} . "</b> {<br>\n";
541 print ",\n";
545 print "};<br>\n";
547 print "<h3>Constants</h3>\n";
548 print "<dl>\n";
550 print "<dt><b>" . $parameter . "</b>\n";
554 print "</dl>\n";
556 print "<hr>\n";
564 print "<h2>typedef " . $args{'typedef'} . "</h2>\n";
566 print "<b>typedef " . $args{'typedef'} . "</b>\n";
568 print "<hr>\n";
576 print "<h2>" . $args{'type'} . " " . $args{'struct'} . " - " . $args{'purpose'} . "</h2>\n";
577 print "<b>" . $args{'type'} . " " . $args{'struct'} . "</b> {<br>\n";
580 print "$parameter<br>\n";
590 print " <i>$1</i><b>$parameter</b>) <i>($2)</i>;<br>\n";
593 print " <i>$1</i> <b>$parameter</b>$2;<br>\n";
595 print " <i>$type</i> <b>$parameter</b>;<br>\n";
598 print "};<br>\n";
600 print "<h3>Members</h3>\n";
601 print "<dl>\n";
609 print "<dt><b>" . $parameter . "</b>\n";
613 print "</dl>\n";
615 print "<hr>\n";
624 print "<h2>" . $args{'function'} . " - " . $args{'purpose'} . "</h2>\n";
625 print "<i>" . $args{'functiontype'} . "</i>\n";
626 print "<b>" . $args{'function'} . "</b>\n";
639 print ",\n";
642 print ")\n";
644 print "<h3>Arguments</h3>\n";
645 print "<dl>\n";
651 print "<dt><b>" . $parameter . "</b>\n";
655 print "</dl>\n";
657 print "<hr>\n";
667 print "<h3>$section</h3>\n";
668 print "<ul>\n";
670 print "</ul>\n";
672 print "<hr>\n";
681 print "<section>\n";
682 print "<h1>$section</h1>\n";
683 print "<p>\n";
685 print "</p>\n";
686 print "</section>\n";
700 print "<h1>enum " . $args{'enum'} . "</h1>\n";
701 print "<ol class=\"code\">\n";
705 print "</li>\n";
714 print "</li>\n";
716 print "<li>};</li>\n";
717 print "</ol>\n";
719 print "<section>\n";
720 print "<h1>Constants</h1>\n";
721 print "<dl>\n";
723 print "<dt>" . $parameter . "</dt>\n";
726 print "</dd>\n";
728 print "</dl>\n";
729 print "</section>\n";
731 print "</article>\n";
743 print "<article class=\"typedef\" id=\"typedef:" . $html5id . "\">\n";
744 print "<h1>typedef " . $args{'typedef'} . "</h1>\n";
746 print "<ol class=\"code\">\n";
750 print "</li>\n";
751 print "</ol>\n";
753 print "</article>\n";
764 print "<article class=\"struct\" id=\"struct:" . $html5id . "\">\n";
765 print "<hgroup>\n";
767 print "<h2>". $args{'purpose'} . "</h2>\n";
768 print "</hgroup>\n";
769 print "<ol class=\"code\">\n";
773 print "</li>\n";
777 print "<span class=\"param\">" . $parameter ."</span>\n";
778 print "</li>\n";
801 print "</li>\n";
803 print "<li>};</li>\n";
804 print "</ol>\n";
806 print "<section>\n";
807 print "<h1>Members</h1>\n";
808 print "<dl>\n";
816 print "<dt>" . $parameter . "</dt>\n";
819 print "</dd>\n";
821 print "</dl>\n";
822 print "</section>\n";
824 print "</article>\n";
836 print "<article class=\"function\" id=\"func:". $html5id . "\">\n";
837 print "<hgroup>\n";
839 print "<h2>" . $args{'purpose'} . "</h2>\n";
840 print "</hgroup>\n";
841 print "<ol class=\"code\">\n";
864 print "</li>\n";
866 print "<li>)</li>\n";
867 print "</ol>\n";
869 print "<section>\n";
870 print "<h1>Arguments</h1>\n";
871 print "<p>\n";
872 print "<dl>\n";
878 print "<dt>" . $parameter . "</dt>\n";
881 print "</dd>\n";
883 print "</dl>\n";
884 print "</section>\n";
886 print "</article>\n";
899 print "<article class=\"doc\" id=\"doc:". $html5id . "\">\n";
900 print "<h1>$section</h1>\n";
901 print "<p>\n";
903 print "</p>\n";
905 print "</article>\n";
914 print "<refsect1>\n";
915 print "<title>$section</title>\n";
917 print "<informalexample><programlisting>\n";
920 print "<para>\n";
925 print "</programlisting></informalexample>\n";
927 print "</para>\n";
929 print "</refsect1>\n";
943 print "<refentry id=\"$id\">\n";
944 print "<refentryinfo>\n";
945 print " <title>U-BOOT</title>\n";
946 print " <productname>Bootloader Hackers Manual</productname>\n";
947 print " <date>$man_date</date>\n";
948 print "</refentryinfo>\n";
949 print "<refmeta>\n";
950 print " <refentrytitle><phrase>" . $args{'function'} . "</phrase></refentrytitle>\n";
951 print " <manvolnum>9</manvolnum>\n";
952 print " <refmiscinfo class=\"version\">" . $kernelversion . "</refmiscinfo>\n";
953 print "</refmeta>\n";
954 print "<refnamediv>\n";
955 print " <refname>" . $args{'function'} . "</refname>\n";
956 print " <refpurpose>\n";
959 print " </refpurpose>\n";
960 print "</refnamediv>\n";
962 print "<refsynopsisdiv>\n";
963 print " <title>Synopsis</title>\n";
964 print " <funcsynopsis><funcprototype>\n";
966 print "<function>" . $args{'function'} . " </function></funcdef>\n";
974 print " <paramdef>$1<parameter>$parameter</parameter>)\n";
975 print " <funcparams>$2</funcparams></paramdef>\n";
978 print " <parameter>$parameter</parameter></paramdef>\n";
982 print " <void/>\n";
984 print " </funcprototype></funcsynopsis>\n";
985 print "</refsynopsisdiv>\n";
988 print "<refsect1>\n <title>Arguments</title>\n";
990 print " <variablelist>\n";
995 print " <varlistentry>\n <term><parameter>$parameter</parameter></term>\n";
996 print " <listitem>\n <para>\n";
999 print " </para>\n </listitem>\n </varlistentry>\n";
1001 print " </variablelist>\n";
1003 print " <para>\n None\n </para>\n";
1005 print "</refsect1>\n";
1008 print "</refentry>\n\n";
1020 print "<refentry id=\"$id\">\n";
1021 print "<refentryinfo>\n";
1022 print " <title>U-BOOT</title>\n";
1023 print " <productname>Bootloader Hackers Manual</productname>\n";
1024 print " <date>$man_date</date>\n";
1025 print "</refentryinfo>\n";
1026 print "<refmeta>\n";
1027 …" <refentrytitle><phrase>" . $args{'type'} . " " . $args{'struct'} . "</phrase></refentrytitle>\n";
1028 print " <manvolnum>9</manvolnum>\n";
1029 print " <refmiscinfo class=\"version\">" . $kernelversion . "</refmiscinfo>\n";
1030 print "</refmeta>\n";
1031 print "<refnamediv>\n";
1032 print " <refname>" . $args{'type'} . " " . $args{'struct'} . "</refname>\n";
1033 print " <refpurpose>\n";
1036 print " </refpurpose>\n";
1037 print "</refnamediv>\n";
1039 print "<refsynopsisdiv>\n";
1040 print " <title>Synopsis</title>\n";
1041 print " <programlisting>\n";
1042 print $args{'type'} . " " . $args{'struct'} . " {\n";
1049 print "$prm\n";
1061 print " $1 $parameter) ($2);\n";
1064 print " $1 $parameter$2;\n";
1066 print " " . $type . " " . $parameter . ";\n";
1070 print " </programlisting>\n";
1071 print "</refsynopsisdiv>\n";
1073 print " <refsect1>\n";
1074 print " <title>Members</title>\n";
1077 print " <variablelist>\n";
1087 print " <term>$parameter</term>\n";
1088 print " <listitem><para>\n";
1090 print " </para></listitem>\n";
1091 print " </varlistentry>\n";
1093 print " </variablelist>\n";
1095 print " <para>\n None\n </para>\n";
1097 print " </refsect1>\n";
1101 print "</refentry>\n\n";
1114 print "<refentry id=\"$id\">\n";
1115 print "<refentryinfo>\n";
1116 print " <title>U-BOOT</title>\n";
1117 print " <productname>Bootloader Hackers Manual</productname>\n";
1118 print " <date>$man_date</date>\n";
1119 print "</refentryinfo>\n";
1120 print "<refmeta>\n";
1121 print " <refentrytitle><phrase>enum " . $args{'enum'} . "</phrase></refentrytitle>\n";
1122 print " <manvolnum>9</manvolnum>\n";
1123 print " <refmiscinfo class=\"version\">" . $kernelversion . "</refmiscinfo>\n";
1124 print "</refmeta>\n";
1125 print "<refnamediv>\n";
1126 print " <refname>enum " . $args{'enum'} . "</refname>\n";
1127 print " <refpurpose>\n";
1130 print " </refpurpose>\n";
1131 print "</refnamediv>\n";
1133 print "<refsynopsisdiv>\n";
1134 print " <title>Synopsis</title>\n";
1135 print " <programlisting>\n";
1136 print "enum " . $args{'enum'} . " {\n";
1144 print "\n";
1147 print " </programlisting>\n";
1148 print "</refsynopsisdiv>\n";
1150 print "<refsect1>\n";
1151 print " <title>Constants</title>\n";
1152 print " <variablelist>\n";
1158 print " <term>$parameter</term>\n";
1159 print " <listitem><para>\n";
1161 print " </para></listitem>\n";
1162 print " </varlistentry>\n";
1164 print " </variablelist>\n";
1165 print "</refsect1>\n";
1169 print "</refentry>\n\n";
1181 print "<refentry id=\"$id\">\n";
1182 print "<refentryinfo>\n";
1183 print " <title>U-BOOT</title>\n";
1184 print " <productname>Bootloader Hackers Manual</productname>\n";
1185 print " <date>$man_date</date>\n";
1186 print "</refentryinfo>\n";
1187 print "<refmeta>\n";
1188 print " <refentrytitle><phrase>typedef " . $args{'typedef'} . "</phrase></refentrytitle>\n";
1189 print " <manvolnum>9</manvolnum>\n";
1190 print "</refmeta>\n";
1191 print "<refnamediv>\n";
1192 print " <refname>typedef " . $args{'typedef'} . "</refname>\n";
1193 print " <refpurpose>\n";
1196 print " </refpurpose>\n";
1197 print "</refnamediv>\n";
1199 print "<refsynopsisdiv>\n";
1200 print " <title>Synopsis</title>\n";
1201 print " <synopsis>typedef " . $args{'typedef'} . ";</synopsis>\n";
1202 print "</refsynopsisdiv>\n";
1206 print "</refentry>\n\n";
1222 print "<refsect1>\n <title>$section</title>\n";
1225 print "<example><para>\n";
1228 print "<para>\n";
1233 print "</para></example>\n";
1238 print "\n</refsect1>\n";
1242 print "\n\n";
1255 print "<sect2>\n";
1256 print " <title id=\"$id\">" . $args{'function'} . "</title>\n";
1258 print " <funcsynopsis>\n";
1261 print "</function></funcdef>\n";
1269 print " <paramdef>$1 <parameter>$parameter</parameter>)\n";
1270 print " <funcparams>$2</funcparams></paramdef>\n";
1273 print " <parameter>$parameter</parameter></paramdef>\n";
1277 print " <void>\n";
1279 print " </funcsynopsis>\n";
1281 print " <informaltable pgwide=\"1\" frame=\"none\" role=\"params\">\n";
1282 print "<tgroup cols=\"2\">\n";
1283 print "<colspec colwidth=\"2*\">\n";
1284 print "<colspec colwidth=\"8*\">\n";
1285 print "<tbody>\n";
1290 print " <row><entry align=\"right\"><parameter>$parameter</parameter></entry>\n";
1291 print " <entry>\n";
1294 print " </entry></row>\n";
1296 print " </tbody></tgroup></informaltable>\n";
1298 print " <para>\n None\n </para>\n";
1304 print "<simplesect>\n <title>$section</title>\n";
1306 print "<example><programlisting>\n";
1310 print "<para>\n";
1313 print "</para>\n";
1315 print "</programlisting></example>\n";
1318 print " </simplesect>\n";
1321 print "</sect2>\n\n";
1331 …$args{'function'}\" 9 \"$args{'function'}\" \"$man_date\" \"Bootloader Hacker's Manual\" U-BOOT\n";
1333 print ".SH NAME\n";
1334 print $args{'function'} . " \\- " . $args{'purpose'} . "\n";
1336 print ".SH SYNOPSIS\n";
1338 print ".B \"" . $args{'functiontype'} . "\" " . $args{'function'} . "\n";
1340 print ".B \"" . $args{'function'} . "\n";
1352 print ".BI \"" . $parenth . $1 . "\" " . $parameter . " \") (" . $2 . ")" . $post . "\"\n";
1355 print ".BI \"" . $parenth . $type . "\" " . $parameter . " \"" . $post . "\"\n";
1361 print ".SH ARGUMENTS\n";
1366 print ".IP \"" . $parameter . "\" 12\n";
1370 print ".SH \"", uc $section, "\"\n";
1382 print ".TH \"$args{'module'}\" 9 \"enum $args{'enum'}\" \"$man_date\" \"API Manual\" U-BOOT\n";
1384 print ".SH NAME\n";
1385 print "enum " . $args{'enum'} . " \\- " . $args{'purpose'} . "\n";
1387 print ".SH SYNOPSIS\n";
1388 print "enum " . $args{'enum'} . " {\n";
1391 print ".br\n.BI \" $parameter\"\n";
1393 print "\n};\n";
1397 print ", \n.br\n";
1402 print ".SH Constants\n";
1407 print ".IP \"" . $parameter . "\" 12\n";
1411 print ".SH \"$section\"\n";
1422 …ule'}\" 9 \"" . $args{'type'} . " " . $args{'struct'} . "\" \"$man_date\" \"API Manual\" U-BOOT\n";
1424 print ".SH NAME\n";
1425 print $args{'type'} . " " . $args{'struct'} . " \\- " . $args{'purpose'} . "\n";
1427 print ".SH SYNOPSIS\n";
1428 print $args{'type'} . " " . $args{'struct'} . " {\n.br\n";
1432 print ".BI \"$parameter\"\n.br\n";
1442 print ".BI \" " . $1 . "\" " . $parameter . " \") (" . $2 . ")" . "\"\n;\n";
1445 print ".BI \" " . $1 . "\ \" " . $parameter . $2 . " \"" . "\"\n;\n";
1448 print ".BI \" " . $type . "\" " . $parameter . " \"" . "\"\n;\n";
1450 print "\n.br\n";
1452 print "};\n.br\n";
1454 print ".SH Members\n";
1462 print ".IP \"" . $parameter . "\" 12\n";
1466 print ".SH \"$section\"\n";
1477 print ".TH \"$args{'module'}\" 9 \"$args{'typedef'}\" \"$man_date\" \"API Manual\" U-BOOT\n";
1479 print ".SH NAME\n";
1480 print "typedef " . $args{'typedef'} . " \\- " . $args{'purpose'} . "\n";
1483 print ".SH \"$section\"\n";
1493 print ".TH \"$args{'module'}\" 9 \"$args{'module'}\" \"$man_date\" \"API Manual\" U-BOOT\n";
1496 print ".SH \"$section\"\n";
1508 print "Name:\n\n";
1509 print $args{'function'} . " - " . $args{'purpose'} . "\n";
1511 print "\nSynopsis:\n\n";
1530 print ",\n";
1533 print ");\n\n";
1537 print "Arguments:\n\n";
1542 print $parameter . "\n\t" . $args{'parameterdescs'}{$parameter_name} . "\n";
1552 print "\n";
1554 print "$section:\n\n";
1557 print "\n\n";
1565 print "Enum:\n\n";
1567 print "enum " . $args{'enum'} . " - " . $args{'purpose'} . "\n\n";
1568 print "enum " . $args{'enum'} . " {\n";
1576 print "\n";
1578 print "};\n\n";
1580 print "Constants:\n\n";
1582 print "$parameter\n\t";
1583 print $args{'parameterdescs'}{$parameter} . "\n";
1594 print "Typedef:\n\n";
1596 print "typedef " . $args{'typedef'} . " - " . $args{'purpose'} . "\n";
1605 print $args{'type'} . " " . $args{'struct'} . " - " . $args{'purpose'} . "\n\n";
1606 print $args{'type'} . " " . $args{'struct'} . " {\n";
1609 print "$parameter\n";
1620 print "\t$1 $parameter) ($2);\n";
1623 print "\t$1 $parameter$2;\n";
1625 print "\t" . $type . " " . $parameter . ";\n";
1628 print "};\n\n";
1630 print "Members:\n\n";
1638 print "$parameter\n\t";
1639 print $args{'parameterdescs'}{$parameter_name} . "\n";
1641 print "\n";
1650 print " $section:\n";
1661 print $args{'function'} . "\n";
1667 print $args{'enum'} . "\n";
1673 print $args{'typedef'} . "\n";
1680 print $args{'struct'} . "\n";
1688 print "DOC: $section\n";
1775 print STDERR "Error(${file}:$.): Cannot parse struct or union!\n";
1797 "not described in enum '$declaration_name'\n";
1814 print STDERR "Error(${file}:$.): Cannot parse enum!\n";
1842 print STDERR "Error(${file}:$.): Cannot parse typedef!\n";
1960 $parameterdescs{$param} = "anonymous\n";
1976 "described in '$declaration_name'\n";
1979 " No description found for parameter '$param'\n";
2032 "description in '$decl_name'\n";
2039 "description in '$decl_name'\n";
2064 "'$declaration_name'\n";
2141 print STDERR "Warning(${file}:$.): cannot understand function prototype: '$prototype'\n";
2205 print STDERR "Warning(${file}:$.): Unrecognized tracepoint format: \n".
2206 "$prototype\n";
2215 $prototype =~ s@[\r\n\t]+@ @gos; # strip newlines/CR's/tabs
2261 $prototype =~ s@[\r\n]+@ @gos; # strip newlines/cr's.
2280 $x =~ s@[\r\n]+@ @gos; # strip newlines/cr's.
2357 print STDERR "Error: Cannot open file $file\n";
2404 print STDERR "Warning(${file}:$.): missing initial short description on line:\n";
2422 print STDERR "Info(${file}:$.): Scanning doc for $identifier\n";
2426 " - I thought it was a doc line\n";
2435 if (($contents ne "") && ($contents ne "\n")) {
2437 print STDERR "Warning(${file}:$.): contents before sections\n";
2452 $contents .= "\n";
2457 if (($contents ne "") && ($contents ne "\n")) {
2471 # print STDERR "end of doc comment, looking for prototype\n";
2481 $contents .= "\n";
2490 $contents .= $1 . "\n";
2544 $contents .= $1 . "\n";
2550 print STDERR "Warning(${file}): no structured comments found\n";
2552 print STDERR " Was looking for '$_'.\n" for keys %function_table;
2556 print "<refentry>\n";
2557 print " <refnamediv>\n";
2558 print " <refname>\n";
2559 print " ${file}\n";
2560 print " </refname>\n";
2561 print " <refpurpose>\n";
2562 print " Document generation inconsistency\n";
2563 print " </refpurpose>\n";
2564 print " </refnamediv>\n";
2565 print " <refsect1>\n";
2566 print " <title>\n";
2567 print " Oops\n";
2568 print " </title>\n";
2569 print " <warning>\n";
2570 print " <para>\n";
2571 print " The template for this document tried to insert\n";
2572 print " the structured comment from the file\n";
2573 print " <filename>${file}</filename> at this point,\n";
2574 print " but none was found.\n";
2575 print " This dummy section is inserted to allow\n";
2576 print " generation to continue.\n";
2577 print " </para>\n";
2578 print " </warning>\n";
2579 print " </refsect1>\n";
2580 print "</refentry>\n";
2591 # print STDERR "scanning pattern:$pattern, highlight:($highlights{$pattern})\n";
2592 $dohighlight .= "\$contents =~ s:$pattern:$highlights{$pattern}:gs;\n";
2613 print STDERR "$errors errors\n";
2616 print STDERR "$warnings warnings\n";