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.
doc.texi sample.tmpl.texi devel.texi debug.texi installation.texi \
bibliography.texi localsettings.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 $<
pintos.html: $(TEXIS) texi2html
./texi2html -toc_file=$@ -split=chapter -nosec_nav -nomenu -init_file pintos-t2h.init $<
dvips $< -o $@
pintos.pdf: $(TEXIS)
dvips $< -o $@
pintos.pdf: $(TEXIS)
%.texi: %
sed < $< > $@ 's/\([{}@]\)/\@\1/g;'
%.texi: %
sed < $< > $@ 's/\([{}@]\)/\@\1/g;'
The worst offenders are intentionally not included in the Pintos C
library:
The worst offenders are intentionally not included in the Pintos C
library:
@item strcpy
When used carelessly this function can overflow the buffer reserved
for its output string. Use @func{strlcpy} instead. Refer to
@item strcpy
When used carelessly this function can overflow the buffer reserved
for its output string. Use @func{strlcpy} instead. Refer to
#############################################################
# value substitution before macro expansion, so that
# it works in macro arguments
#############################################################
# 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
#############################################################
# macro substitution
$after = '';
}
$args =~ s|\\\\|\\|g;
$after = '';
}
$args =~ s|\\\\|\\|g;
$args =~ s|\\}|}|g;
if (@{$macros->{$name}->{Args}} > 1)
{
$args =~ s|\\}|}|g;
if (@{$macros->{$name}->{Args}} > 1)
{
- while (/\@(x|px|info|)ref{([^{}]+)(}?)/)
+ while (/\@(x|px|info|)ref\{([^{}]+)(}?)/)
{
# note: Texinfo may accept other characters
($type, $nodes, $full) = ($1, $2, $3);
{
# note: Texinfo may accept other characters
($type, $nodes, $full) = ($1, $2, $3);
my $ret;
$level--; # here we start at 0
my $ret;
$level--; # here we start at 0
- if ($name =~ /^appendix/ || defined(@appendix_sec_num))
+ if ($name =~ /^appendix/ || @appendix_sec_num)
- if (defined(@appendix_sec_num))
{
&incr_sec_num($level, @appendix_sec_num);
}
{
&incr_sec_num($level, @appendix_sec_num);
}
- if (defined(@normal_sec_num))
{
&incr_sec_num($level, @normal_sec_num);
}
{
&incr_sec_num($level, @normal_sec_num);
}