Make docs compile again

With newer versions oF packages such as texinfo and Perl, the
documentation no longer compiled. Fixed various issues, and
removed dvi and ps from default output formats, since software
to generate them is becoming less widely available.

diff --git a/doc/Makefile b/doc/Makefile
index ed8bb234bfa95d51333abe10d515facc47b588b0..0a01cc3ac8a26e27d0e94b895409716adb73d3dc 100644 (file)
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -3,7 +3,7 @@ filesys.texi license.texi reference.texi 44bsd.texi standards.texi      \
 doc.texi sample.tmpl.texi devel.texi debug.texi installation.texi      \
 bibliography.texi localsettings.texi
 
-all: pintos.html pintos.info pintos.dvi pintos.ps pintos.pdf
+all: pintos.html pintos.info pintos.pdf
 
 pintos.html: $(TEXIS) texi2html
        ./texi2html -toc_file=$@ -split=chapter -nosec_nav -nomenu -init_file pintos-t2h.init $<
@@ -21,7 +21,7 @@ pintos.ps: pintos.dvi
        dvips $< -o $@
 
 pintos.pdf: $(TEXIS)
-       texi2pdf $< -o $@
+       pdftex $< -o $@
 
 %.texi: %
        sed < $< > $@ 's/\([{}@]\)/\@\1/g;'

diff --git a/doc/standards.texi b/doc/standards.texi
index 8e4b3703432025bb5191ef4ccfca24ec503647c5..7d30a4b4cfbe1c218a6390f752c4fb16ff484364 100644 (file)
--- a/doc/standards.texi
+++ b/doc/standards.texi
@@ -151,7 +151,7 @@ A few of the string functions declared in the standard
 The worst offenders are intentionally not included in the Pintos C
 library:
 
-@table @func
+@table @code
 @item strcpy
 When used carelessly this function can overflow the buffer reserved
 for its output string.  Use @func{strlcpy} instead.  Refer to

diff --git a/doc/texi2html b/doc/texi2html
index 16ecd4a890aa76f0bc0239a19b7c295c04f62662..30416a6d212d393ccb2848aafae08f7a870ef07d 100755 (executable)
--- a/doc/texi2html
+++ b/doc/texi2html
@@ -3443,7 +3443,7 @@ sub pass1
         #############################################################
         # value substitution before macro expansion, so that
         # it works in macro arguments
-        s/\@value{($VARRE)}/$value{$1}/eg;
+        s/\@value\{($VARRE)}/$value{$1}/eg;
 
         #############################################################
         # macro substitution
@@ -3512,7 +3512,7 @@ sub pass1
                     $after = '';
                 }
                 $args =~ s|\\\\|\\|g;
-                $args =~ s|\\{|{|g;
+                $args =~ s|\\\{|{|g;
                                 $args =~ s|\\}|}|g;
                 if (@{$macros->{$name}->{Args}} > 1)
                 {
@@ -4920,7 +4920,7 @@ sub pass2
         #
         # xref
         #
-        while (/\@(x|px|info|)ref{([^{}]+)(}?)/)
+        while (/\@(x|px|info|)ref\{([^{}]+)(}?)/)
         {
             # note: Texinfo may accept other characters
             ($type, $nodes, $full) = ($1, $2, $3);
@@ -5644,10 +5644,10 @@ sub update_sec_num
     my $ret;
 
     $level--;                   # here we start at 0
-    if ($name =~ /^appendix/ || defined(@appendix_sec_num))
+    if ($name =~ /^appendix/ || @appendix_sec_num)
     {
         # appendix style
-        if (defined(@appendix_sec_num))
+        if (@appendix_sec_num)
         {
             &incr_sec_num($level, @appendix_sec_num);
         }
@@ -5660,7 +5660,7 @@ sub update_sec_num
     else
     {
         # normal style
-        if (defined(@normal_sec_num))
+        if (@normal_sec_num)
         {
             &incr_sec_num($level, @normal_sec_num);
         }