forked from Imagelibrary/rtems
2011-12-06 Joel Sherrill <joel.sherrill@oarcorp.com>
PR 1793/doc * Makefile.am, configure.ac, bmenu/bmenu2.c: Convert from texi2www to texi2html. * texi2www/ChangeLog, texi2www/Makefile.am, texi2www/dir-arrow.gif, texi2www/missing-arrow.gif, texi2www/next-arrow.gif, texi2www/prev-arrow.gif, texi2www/texi2dvi, texi2www/texi2www, texi2www/texi2www.texi, texi2www/up-arrow.gif: Removed.
This commit is contained in:
Joel Sherrill
@@ -1,3 +1,13 @@
|
|||||||
|
2011-12-06 Joel Sherrill <joel.sherrill@oarcorp.com>
|
||||||
|
|
||||||
|
PR 1793/doc
|
||||||
|
* Makefile.am, configure.ac, bmenu/bmenu2.c: Convert from texi2www to
|
||||||
|
texi2html.
|
||||||
|
* texi2www/ChangeLog, texi2www/Makefile.am, texi2www/dir-arrow.gif,
|
||||||
|
texi2www/missing-arrow.gif, texi2www/next-arrow.gif,
|
||||||
|
texi2www/prev-arrow.gif, texi2www/texi2dvi, texi2www/texi2www,
|
||||||
|
texi2www/texi2www.texi, texi2www/up-arrow.gif: Removed.
|
||||||
|
|
||||||
2011-02-02 Ralf Corsépius <ralf.corsepius@rtems.org>
|
2011-02-02 Ralf Corsépius <ralf.corsepius@rtems.org>
|
||||||
|
|
||||||
* configure.ac: Require autoconf-2.68, automake-1.11.1.
|
* configure.ac: Require autoconf-2.68, automake-1.11.1.
|
||||||
|
|||||||
@@ -3,4 +3,5 @@ ACLOCAL_AMFLAGS = -I ../../aclocal
|
|||||||
|
|
||||||
EXTRA_DIST = word-replace2
|
EXTRA_DIST = word-replace2
|
||||||
|
|
||||||
SUBDIRS = bmenu texi2www
|
SUBDIRS = bmenu
|
||||||
|
#texi2www
|
||||||
|
|||||||
@@ -12,7 +12,7 @@
|
|||||||
* + previous of the first node
|
* + previous of the first node
|
||||||
* + next of the last node
|
* + next of the last node
|
||||||
*
|
*
|
||||||
* COPYRIGHT (c) 1988-2002.
|
* COPYRIGHT (c) 1989-2011.
|
||||||
* On-Line Applications Research Corporation (OAR).
|
* On-Line Applications Research Corporation (OAR).
|
||||||
* All rights reserved.
|
* All rights reserved.
|
||||||
*
|
*
|
||||||
@@ -777,7 +777,7 @@ void BuildTexinfoNodes( void )
|
|||||||
|
|
||||||
if ( menu_items == 0 ) {
|
if ( menu_items == 0 ) {
|
||||||
new_line = AllocateLine();
|
new_line = AllocateLine();
|
||||||
strcpy( new_line->Contents, "@ifinfo" );
|
strcpy( new_line->Contents, "" ); /* "@ifinfo" ); */
|
||||||
_Chain_Insert( menu_insert_point->Node.previous, &new_line->Node );
|
_Chain_Insert( menu_insert_point->Node.previous, &new_line->Node );
|
||||||
|
|
||||||
new_line = AllocateLine();
|
new_line = AllocateLine();
|
||||||
@@ -808,7 +808,7 @@ continue_menu_loop:
|
|||||||
_Chain_Insert( menu_insert_point->Node.previous, &new_line->Node );
|
_Chain_Insert( menu_insert_point->Node.previous, &new_line->Node );
|
||||||
|
|
||||||
new_line = AllocateLine();
|
new_line = AllocateLine();
|
||||||
strcpy( new_line->Contents, "@end ifinfo" );
|
strcpy( new_line->Contents, "" ); /* "@end ifinfo" ); */
|
||||||
_Chain_Insert( menu_insert_point->Node.previous, &new_line->Node );
|
_Chain_Insert( menu_insert_point->Node.previous, &new_line->Node );
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -21,8 +21,8 @@ dnl Checks for typedefs, structures, and compiler characteristics.
|
|||||||
dnl Checks for library functions.
|
dnl Checks for library functions.
|
||||||
AC_CHECK_FUNCS(strdup strstr)
|
AC_CHECK_FUNCS(strdup strstr)
|
||||||
|
|
||||||
|
# texi2www/Makefile
|
||||||
AC_CONFIG_FILES([Makefile
|
AC_CONFIG_FILES([Makefile
|
||||||
bmenu/Makefile
|
bmenu/Makefile
|
||||||
texi2www/Makefile
|
|
||||||
])
|
])
|
||||||
AC_OUTPUT
|
AC_OUTPUT
|
||||||
|
|||||||
@@ -1,27 +0,0 @@
|
|||||||
2006-01-20 Ralf Corsepius <ralf.corsepius@rtems.org>
|
|
||||||
|
|
||||||
* texi2www: Add provisory support for @image.
|
|
||||||
|
|
||||||
2003-12-12 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
|
|
||||||
|
|
||||||
* Makefile.am: Cosmetics.
|
|
||||||
|
|
||||||
2003-09-22 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
|
|
||||||
|
|
||||||
* Makefile.am: Merger from rtems-4-6-branch.
|
|
||||||
|
|
||||||
2003-05-21 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
|
|
||||||
|
|
||||||
* texi2www: Add support for @ifnottex.
|
|
||||||
|
|
||||||
2002-03-27 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
|
|
||||||
|
|
||||||
* Makefile.am: Remove AUTOMAKE_OPTIONS.
|
|
||||||
|
|
||||||
2002-01-18 Ralf Corsepius <corsepiu@faw.uni-ulm.de>
|
|
||||||
|
|
||||||
* Makefile.am: require automake-1.5.
|
|
||||||
|
|
||||||
2000-08-10 Joel Sherrill <joel@OARcorp.com>
|
|
||||||
|
|
||||||
* ChangeLog: New file.
|
|
||||||
@@ -1,17 +0,0 @@
|
|||||||
#
|
|
||||||
# COPYRIGHT (c) 1988-2002.
|
|
||||||
# On-Line Applications Research Corporation (OAR).
|
|
||||||
# All rights reserved.
|
|
||||||
#
|
|
||||||
# $Id$
|
|
||||||
#
|
|
||||||
|
|
||||||
noinst_SCRIPTS = texi2www texi2dvi
|
|
||||||
|
|
||||||
EXTRA_DIST = $(noinst_SCRIPTS) dir-arrow.gif prev-arrow.gif \
|
|
||||||
missing-arrow.gif up-arrow.gif next-arrow.gif texi2www.texi
|
|
||||||
|
|
||||||
PROJECT = texi2www
|
|
||||||
|
|
||||||
# TEXINFO_TEX = $(top_srcdir)/../texinfo/texinfo.tex
|
|
||||||
# info_TEXINFOS = texi2www.texi
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 2.5 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 166 B |
Binary file not shown.
|
Before Width: | Height: | Size: 275 B |
Binary file not shown.
|
Before Width: | Height: | Size: 279 B |
@@ -1,218 +0,0 @@
|
|||||||
#!/usr/bin/perl
|
|
||||||
#
|
|
||||||
# $Id$
|
|
||||||
#
|
|
||||||
|
|
||||||
$version = <<END_VERSION;
|
|
||||||
Jan 2 1996
|
|
||||||
END_VERSION
|
|
||||||
|
|
||||||
$copyright = <<END_COPYRIGHT;
|
|
||||||
texi2dvi - converts texinfo to dvi
|
|
||||||
Copyright (C) 1996 Tim Singletary
|
|
||||||
|
|
||||||
This program is freely distributable under the terms of the GNU
|
|
||||||
GENERAL PUBLIC LICENSE. In particular, modified versions of this
|
|
||||||
program must retain this copyright notice and must remain freely
|
|
||||||
distributable.
|
|
||||||
END_COPYRIGHT
|
|
||||||
|
|
||||||
$usage = <<END_USAGE;
|
|
||||||
Usage: texi2dvi [option ...] texinfo_file ...
|
|
||||||
-k (-nocleanup) -- don't ``rm -f'' the intermediate files.
|
|
||||||
-v (-verbose) -- print additional output.
|
|
||||||
-copyright -- print the copyright and die.
|
|
||||||
-version -- print the version and die.
|
|
||||||
Generates a .dvi file from each texinfo (.texi or .texinfo) file.
|
|
||||||
Understands texi2www extensions (\@gif, etc.).
|
|
||||||
END_USAGE
|
|
||||||
|
|
||||||
unless ($tex = $ENV{TEX}) {$tex = tex;}
|
|
||||||
unless ($texindex = $ENV{TEXINDEX}) {$texindex = texindex;}
|
|
||||||
$texinputs = $ENV{TEXINPUTS};
|
|
||||||
|
|
||||||
$cleanup = 1;
|
|
||||||
while ($ARGV[0] =~ /^-/) {
|
|
||||||
$_ = shift;
|
|
||||||
if (/-k$/ || /-nocleanup/) {$cleanup = 0; next;}
|
|
||||||
if (/-v$/ || /-verbose/) {$verbose = 1; next;}
|
|
||||||
if (/-d$/ || /-vv$/ || /-debug/) {$verbose = 2; next;}
|
|
||||||
if (/-copyright/) {die $copyright;}
|
|
||||||
if (/-version/) {die $version;}
|
|
||||||
die $usage;
|
|
||||||
}
|
|
||||||
|
|
||||||
$font_prefix = "xx";
|
|
||||||
while (&prefix_in_use($font_prefix)) {
|
|
||||||
++$font_prefix;
|
|
||||||
if (length($font_prefix) > 2) {
|
|
||||||
$font_prefix = "aa";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
$unique_base = "_" . $$ . "a-";
|
|
||||||
while (&prefix_in_use($unique_base)) {++$unique_base;}
|
|
||||||
|
|
||||||
print "Generated files will begin with \`$unique_base\'\n" if $verbose;
|
|
||||||
|
|
||||||
$arg_index = 'a';
|
|
||||||
foreach $raw_texi (@ARGV) {
|
|
||||||
$base = $unique_base . $arg_index;
|
|
||||||
++$arg_index;
|
|
||||||
|
|
||||||
# $tawtexifile is a texinfo file; suffix must be either `.texi' or
|
|
||||||
# `.texinfo'. If arg is in a different directory, adjust
|
|
||||||
# TEXINPUTS environment variable to include that (and the current)
|
|
||||||
# directory.
|
|
||||||
unless ($raw_texi =~ /(.*).texi(nfo)?$/) {
|
|
||||||
print "skipping $raw_texi -- has unknown extension!\n";
|
|
||||||
next;
|
|
||||||
}
|
|
||||||
$raw_texi_base = $1;
|
|
||||||
if ($raw_texi_base =~ m|^(.*)/([^/]*)$|) {
|
|
||||||
$raw_texi_base = $2;
|
|
||||||
$ENV{TEXINPUTS} = ".:$1:$texinputs";
|
|
||||||
} else {
|
|
||||||
$ENV{TEXINPUTS} = ".:$texinputs";
|
|
||||||
}
|
|
||||||
|
|
||||||
unless (-r $raw_texi) {
|
|
||||||
print "skipping $raw_texi -- not readable or doesn't exist!\n";
|
|
||||||
next;
|
|
||||||
}
|
|
||||||
|
|
||||||
# Preprocesses the $rawtexifile (because of @gif{} and other extensions)
|
|
||||||
$processed_texi = "$base.texi";
|
|
||||||
print "Preprocessing $raw_texi into $processed_texi:\n" if $verbose;
|
|
||||||
&preprocess_texinfo($raw_texi,$processed_texi,$base);
|
|
||||||
|
|
||||||
print "$tex $processed_texi\n" if $verbose;
|
|
||||||
if (system("$tex $processed_texi") == 0) {
|
|
||||||
|
|
||||||
# @possible_index_file = <$base.??>; only works for the
|
|
||||||
# first value of $base ... so,
|
|
||||||
opendir(DIR,".") || die "Couldn't read current directory -- $!\n";
|
|
||||||
@possible_index_files = ();
|
|
||||||
while ($_ = readdir(DIR)) {
|
|
||||||
if (/^$base\...$/) {
|
|
||||||
push(@possible_index_files,$_);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
closedir(DIR);
|
|
||||||
|
|
||||||
@index_files = ();
|
|
||||||
foreach $possible_index_file (@possible_index_files) {
|
|
||||||
print "DEBUG: possible_index_file $possible_index_file\n"
|
|
||||||
if ($verbose > 1);
|
|
||||||
next unless (-s $possible_index_file);
|
|
||||||
push(@index_files,$possible_index_file);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (@index_files > 0) {
|
|
||||||
$texindex_cmd = "$texindex " . join(' ',@index_files);
|
|
||||||
print "$texindex_cmd\n" if $verbose;
|
|
||||||
if (system($texindex_cmd) == 0) {
|
|
||||||
print "$tex $processed_texi\n" if $verbose;
|
|
||||||
system("$tex $processed_texi");
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# At this point, $base.dvi should exist -- rename it
|
|
||||||
# to $raw_texi_base.dvi
|
|
||||||
if (-e "$base.dvi") {
|
|
||||||
rename("$base.dvi","$raw_texi_base.dvi")
|
|
||||||
|| die "rename $base.dvi $raw_texi_base.dvi -- $!\n";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if ($cleanup) {unlink(<$base*>);}
|
|
||||||
|
|
||||||
sub preprocess_texinfo
|
|
||||||
{
|
|
||||||
local ($infile,$outfile,$b) = @_;
|
|
||||||
|
|
||||||
open(IN,"<$infile") || die "Couldn't open $infile -- $!\n";
|
|
||||||
open(OUT,">$outfile") || die "Couldn't open $outfile -- $!\n";
|
|
||||||
|
|
||||||
$gif_index = 'a';
|
|
||||||
while (<IN>) {
|
|
||||||
|
|
||||||
# @gif{gif} or @gif{html_gif, tex_gif}
|
|
||||||
if (/(.*)\@gif\{([^{]*)\}(.*)/) {
|
|
||||||
$prefix = $1;
|
|
||||||
$arg = $2;
|
|
||||||
$suffix = $3;
|
|
||||||
print OUT "$prefix\n" if $prefix;
|
|
||||||
|
|
||||||
while (1) {
|
|
||||||
$gif_base = $b . $gif_index;
|
|
||||||
last unless (-e $gif_base . ".gif");
|
|
||||||
++$gif_index;
|
|
||||||
}
|
|
||||||
|
|
||||||
$gif_file = '';
|
|
||||||
if ($arg =~ /.*,(..*\.gif)/) {
|
|
||||||
$gif_file = $1;
|
|
||||||
$font_base = $gif_file;
|
|
||||||
} else {
|
|
||||||
$font_base = $arg;
|
|
||||||
$gif_file = $gif_base . ".gif";
|
|
||||||
print "Scaling $arg into $gif_file:\n" if $verbose;
|
|
||||||
$scale_cmd = "giftopnm $arg | pnmscale 2 | pnmnlfilt 2 1 "
|
|
||||||
. "| ppmquant 255 | ppmtogif > $gif_file";
|
|
||||||
print "$scale_cmd\n" if $verbose;
|
|
||||||
if (system($scale_cmd) != 0) {
|
|
||||||
print "$scale_cmd failed\n";
|
|
||||||
$gif_file = '';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if ($gif_file =~ /.*\.gif/) {
|
|
||||||
|
|
||||||
|
|
||||||
$font_base =~ s|.*/||;
|
|
||||||
$font_base =~ s|\..*||;
|
|
||||||
|
|
||||||
# $font_base, due to bm2font requirements, can't be more
|
|
||||||
# than six characters long and must consist entirely of
|
|
||||||
# lower case letters.
|
|
||||||
$font_base =~ s/[^a-z]//g;
|
|
||||||
$font_base = $font_prefix . substr($font_base,0,5);
|
|
||||||
while (&prefix_in_use($font_base)) {++$font_base;}
|
|
||||||
|
|
||||||
$bm2font_cmd = "bm2font -f$font_base $gif_file";
|
|
||||||
print "$bm2font_cmd\n" if $verbose;
|
|
||||||
if (system($bm2font_cmd) != 0) {
|
|
||||||
print "$bm2font_cmd failed\n";
|
|
||||||
} else {
|
|
||||||
print OUT "\@tex\n";
|
|
||||||
print OUT "\\input $font_base.tex\n";
|
|
||||||
print OUT "\\set$font_base\n";
|
|
||||||
print OUT "\@end tex\n";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
print OUT "$suffix \n" if $suffix;
|
|
||||||
} else {
|
|
||||||
print OUT "$_";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
close OUT;
|
|
||||||
close IN;
|
|
||||||
}
|
|
||||||
|
|
||||||
sub prefix_in_use
|
|
||||||
{
|
|
||||||
local ($p) = @_;
|
|
||||||
|
|
||||||
# Returns true or false; returns true if any file in the current
|
|
||||||
# directory begins with $p. This function is here because
|
|
||||||
# `<$p*>' only works for the first value of $p!
|
|
||||||
|
|
||||||
opendir(DIR,".") || die "Couldn't read current directory -- $!\n";
|
|
||||||
while ($_ = readdir(DIR)) {
|
|
||||||
last if /^$p/;
|
|
||||||
}
|
|
||||||
closedir(DIR);
|
|
||||||
$rc = /^$p/;
|
|
||||||
}
|
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -1,708 +0,0 @@
|
|||||||
\input texinfo @c -*-texinfo-*-
|
|
||||||
|
|
||||||
@comment %**start of header
|
|
||||||
@setfilename texi2www
|
|
||||||
@settitle texi2www user's guide
|
|
||||||
@setcontentsaftertitlepage
|
|
||||||
@comment %**end of header
|
|
||||||
|
|
||||||
@finalout
|
|
||||||
|
|
||||||
@titlepage
|
|
||||||
@title texi2www
|
|
||||||
@author Tim Singletary
|
|
||||||
@end titlepage
|
|
||||||
|
|
||||||
@iftex
|
|
||||||
@everyfooting @| Jan 2 1996
|
|
||||||
@end iftex
|
|
||||||
|
|
||||||
@comment ******************************************************** TOP
|
|
||||||
@node Top,,,(dir)
|
|
||||||
@ifhtml
|
|
||||||
This document describes @var{texi2www}, a utility for converting
|
|
||||||
texinfo to HTML.
|
|
||||||
|
|
||||||
This document provides a pretty good example of @var{texi2www}'s texinfo
|
|
||||||
to HTML conversion. @href{Click here,,,texi2wwwdoc.texi.txt} to view
|
|
||||||
the texinfo source to this document.
|
|
||||||
@end ifhtml
|
|
||||||
|
|
||||||
@menu
|
|
||||||
* Overview:: What is texi2www? texinfo? HTML? mosaic? WWW?
|
|
||||||
* Real life:: A real-life example using texi2www
|
|
||||||
* Invocation:: Command line args, etc.
|
|
||||||
* Extensions:: @@ commands not in GNU texinfo
|
|
||||||
* Known Bugs:: Oops!
|
|
||||||
* Demo:: What various things look like
|
|
||||||
|
|
||||||
* texi2dvi::
|
|
||||||
|
|
||||||
* Index::
|
|
||||||
@end menu
|
|
||||||
|
|
||||||
@ifhtml
|
|
||||||
@today{}.
|
|
||||||
@end ifhtml
|
|
||||||
|
|
||||||
|
|
||||||
@comment **************************************************** CHAPTER
|
|
||||||
@node Overview
|
|
||||||
@unnumbered Overview
|
|
||||||
@cindex What is HTML
|
|
||||||
@cindex What is texinfo
|
|
||||||
@cindex What is mosaic
|
|
||||||
@cindex texi2html
|
|
||||||
@cindex info2html
|
|
||||||
@cindex Other texinfo to HTML converters
|
|
||||||
|
|
||||||
@var{Texi2www} converts texinfo to HTML:
|
|
||||||
|
|
||||||
@table @asis
|
|
||||||
@item
|
|
||||||
@table @asis
|
|
||||||
@item texinfo
|
|
||||||
A documentation system that uses a single source file to produce both
|
|
||||||
on-line documentation and printed output. For details see
|
|
||||||
@ref{Top,the Texinfo User's Guide,Overview,texinfo,The Texinfo User's Guide}.
|
|
||||||
@item HTML
|
|
||||||
@href{HyperText Markup Language,,,
|
|
||||||
http://www.ncsa.uiuc.edu/General/Internet/WWW/HTMLPrimer.html}
|
|
||||||
used in World Wide Web documents. Programs like mosaic
|
|
||||||
understand HTML.
|
|
||||||
@end table
|
|
||||||
@end table
|
|
||||||
|
|
||||||
Texinfo's on-line documentation viewers (emacs, info, xinfo, etc.) are
|
|
||||||
quite limited when compared to mosaic. Mosaic supports multiple fonts,
|
|
||||||
variable width fonts, embedded images, and hypertext links to anywhere
|
|
||||||
(not just to other texinfo documents). In addition, mosaic keeps a
|
|
||||||
history of nodes visited and can easily go back to previously visited
|
|
||||||
nodes.
|
|
||||||
|
|
||||||
@var{Texinfo} converts @var{texinfo} directly to @var{HTML} without
|
|
||||||
going through an intermediate @var{info} conversion.
|
|
||||||
|
|
||||||
Other @var{texinfo} to @var{HTML} converters include:
|
|
||||||
|
|
||||||
@table @asis
|
|
||||||
@item
|
|
||||||
@href{@var{http://wwwcn.cern.ch/dci/texi2html/},,,
|
|
||||||
http://wwwcn.cern.ch/dci/texi2html/}; and
|
|
||||||
@item
|
|
||||||
@href{@var{http://www.ericsson.nl/info2www/info2www.html},,,
|
|
||||||
http://www.ericsson.nl/info2www/info2www.html}
|
|
||||||
@end table
|
|
||||||
|
|
||||||
Texi2html is very good, but is different from texi2www in several respects,
|
|
||||||
including:
|
|
||||||
|
|
||||||
@itemize
|
|
||||||
@item Texi2www processes @@ifinfo blocks, whereas texi2html processes
|
|
||||||
@@iftex blocks.
|
|
||||||
@item Texi2www always generates menus, whereas menu generation is
|
|
||||||
optional in texi2html.
|
|
||||||
@item Texi2www generates a seperate document for each node, wherease
|
|
||||||
texi2html can combine several nodes into one document.
|
|
||||||
@item Texi2www adds @href{@code{@@ifhtml} blocks,ifhtml blocks},
|
|
||||||
@href{@code{@@html} blocks,html blocks}, and @href{@code{@@href@{@}},
|
|
||||||
href}. Texi2html has @code{@@ifhtml} blocks, but they work like
|
|
||||||
texi2www's @code{@@html} blocks.
|
|
||||||
@item Texi2www uses icons for the prev, up, and next links; texi2html
|
|
||||||
doesn't.
|
|
||||||
@end itemize
|
|
||||||
|
|
||||||
Texi2www is written in perl and may be used and distributed under the
|
|
||||||
terms of the @href{GNU General Public License,Copying,emacs}.
|
|
||||||
|
|
||||||
Texi2www was written by
|
|
||||||
@href{Tim Singletary,,,
|
|
||||||
http://sunland.gsfc.nasa.gov/personnel/aam/singletary.html}
|
|
||||||
(@cite{tsingle@@sunland.gsfc.nasa.gov}) and is available at
|
|
||||||
@href{@var{ftp://sunland.gsfc.nasa.gov/pub/tarfiles/texi2www.tgz},,,
|
|
||||||
ftp://sunland.gsfc.nasa.gov/pub/tarfiles/texi2www.tgz}.
|
|
||||||
|
|
||||||
@comment **************************************************** CHAPTER
|
|
||||||
@node Real life
|
|
||||||
@chapter A Real Life Example
|
|
||||||
|
|
||||||
Here's how I used texi2www to set up a
|
|
||||||
@href{directory of texinfo documents,,,
|
|
||||||
http://sunland.gsfc.nasa.gov/info/dir.html}.
|
|
||||||
This discussion is the minimum I had to do to set up
|
|
||||||
@href{texinfo,,,http://sunland.gsfc.nasa.gov/info/texinfo/Top.html} and
|
|
||||||
texi2www.
|
|
||||||
First, I created the directory ``@var{$HTDOCS/info}'' (@var{$HTDOCS} is
|
|
||||||
the root directory of my web server).
|
|
||||||
|
|
||||||
Then, I copied arrow icons ``@var{missing-arrow.gif}'',
|
|
||||||
``@var{next-arrow.gif}'', ``@var{prev-arrow.gif}'', and
|
|
||||||
``@var{up-arrow.gif}'' into ``@var{$HTDOCS/info}''.
|
|
||||||
(I obtained my icons from
|
|
||||||
@cite{Rutgers University Network Services} at
|
|
||||||
@href{http://ns2.rutgers.edu/doc-images/buttons,,,
|
|
||||||
http://ns2.rutgers.edu/doc-images/buttons}.)
|
|
||||||
|
|
||||||
Next, I created subdirectories ``@var{$HTDOCS/info/texinfo}'' and
|
|
||||||
``@var{$HTDOCS/info/texi2wwwdoc}''.
|
|
||||||
(I determined the names of these subdirectories by examining the
|
|
||||||
``@var{@@setfilename}'' line in the texinfo files.
|
|
||||||
files; @var{texi2wwwdoc.texi} contains the line
|
|
||||||
``@var{@@setfilename texi2wwwdoc.info}'' and @var{texinfo.texi} contains
|
|
||||||
``@var{@@setfilename texinfo.info}''.
|
|
||||||
|
|
||||||
Next, I copied the texinfo files into the appropriate directories. This
|
|
||||||
step isn't strictly required, but I think its a good idea since it makes
|
|
||||||
it simple to keep track of which texinfo files generated which set of
|
|
||||||
html documents.
|
|
||||||
|
|
||||||
Then I generated the html documents. I used the commands:
|
|
||||||
@example
|
|
||||||
> cd $HTDOCS/info/texinfo
|
|
||||||
> texi2www texinfo.texi
|
|
||||||
Normal completion.
|
|
||||||
> cd ../texi2wwwdoc
|
|
||||||
> texi2www texi2wwwdoc.texi
|
|
||||||
Normal completion.
|
|
||||||
@end example
|
|
||||||
Examing these directories shows that a bunch of @var{.html} files got
|
|
||||||
generated, including, in each directory, ``@var{Top.html}''.
|
|
||||||
|
|
||||||
Finally, I created a table of contents file
|
|
||||||
``@var{$HTDOCS/info/dir.html}''. The first version of that file looked
|
|
||||||
like:
|
|
||||||
|
|
||||||
@example
|
|
||||||
<HTML>
|
|
||||||
<HEAD><TITLE>info directory table of contents</TITLE></HEAD>
|
|
||||||
<BODY>
|
|
||||||
<MENU>
|
|
||||||
<LI><A HREF="texinfo/Top.html">texinfo</A>
|
|
||||||
GNU texinfo version 3.1
|
|
||||||
<LI><A HREF="texi2wwwdoc/Top.html">texi2www</A>
|
|
||||||
Converts texinfo to html
|
|
||||||
</MENU>
|
|
||||||
</BODY></HTML>
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@comment **************************************************** CHAPTER
|
|
||||||
@node Invocation
|
|
||||||
@chapter Invocation
|
|
||||||
@cindex Command line options
|
|
||||||
@cindex Obtaining gif files
|
|
||||||
|
|
||||||
@unnumberedsec Synopsys
|
|
||||||
|
|
||||||
@code{texi2www [options] texinfo-file}
|
|
||||||
|
|
||||||
@unnumberedsec Options
|
|
||||||
@table @asis
|
|
||||||
|
|
||||||
@item @code{-dir} @var{path}
|
|
||||||
Specifies the path to the directory where the
|
|
||||||
generated files get placed. If not specified, the current
|
|
||||||
directory is assumed.
|
|
||||||
|
|
||||||
@item @code{-footer} @var{file}
|
|
||||||
Specifies a file whose contents get
|
|
||||||
appended at the bottom of each generated HTML file. Typically
|
|
||||||
looks something like:
|
|
||||||
|
|
||||||
@example
|
|
||||||
<HR>
|
|
||||||
<P>Back to our <A HREF="../../homepage.html">home page</A>.</P>
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@item @code{-icons} @var{path}
|
|
||||||
Specifies the path (relative to the directory where the generated
|
|
||||||
files get placed) to the arrow files. If not specified, @file{..}
|
|
||||||
is assumed. The names of the arrow
|
|
||||||
files are @file{up_arrow.gif}, @file{left_arrow.gif},
|
|
||||||
@file{right_arrow.gif}, and @file{missing_arrow.gif}
|
|
||||||
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@unnumberedsec Directory structure
|
|
||||||
|
|
||||||
Texi2www will generate a set of HTML files from each texinfo document;
|
|
||||||
each set of HTML files must go in a seperate directory (why? one reason
|
|
||||||
is because each set includes a file named @code{Top.html}!).
|
|
||||||
|
|
||||||
These directories should be subdirectories of the same base directory.
|
|
||||||
Assume the base directory is @code{$TEXIBASE}. Then HTML files for
|
|
||||||
emacs go in directory @code{$TEXIBASE/emacs}, HTML files for texinfo go
|
|
||||||
in @code{$TEXIBASE/texinfo}, etc, where the name of the subdirectory is
|
|
||||||
the same as the name of the info file (so cross references between
|
|
||||||
documents will work).
|
|
||||||
|
|
||||||
In addition to the subdirectories of HTML files, @code{$TEXIBASE}
|
|
||||||
contains a file @code{dir.html} and the four arrow gif files
|
|
||||||
@code{up_arrow.gif}, @code{left_arrow.gif}, @code{right_arrow.gif}, and
|
|
||||||
@code{missing_arrow.gif}.
|
|
||||||
|
|
||||||
@code{$TEXIBASE/dir.html} is typically just a menu of links to the
|
|
||||||
subdirectories and can be as simple as
|
|
||||||
|
|
||||||
@example
|
|
||||||
<HTML><HEAD><TITLE>dir</TITLE></HEAD>
|
|
||||||
<BODY>
|
|
||||||
<MENU>
|
|
||||||
<LI><A HREF="emacs/Top.html">emacs</A>
|
|
||||||
<LI><A HREF="texinfo/Top.html">texinfo</A>
|
|
||||||
</MENU>
|
|
||||||
</BODY></HTML>
|
|
||||||
@end example
|
|
||||||
|
|
||||||
(@code{$TEXIBASE/dir.html} is not generated via texi2www and must be
|
|
||||||
created by hand).
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@comment **************************************************** CHAPTER
|
|
||||||
@node Extensions
|
|
||||||
@chapter Extensions
|
|
||||||
@ifhtml
|
|
||||||
Texi2www understands the following extensions to pure texinfo:
|
|
||||||
@end ifhtml
|
|
||||||
@menu
|
|
||||||
* ifhtml blocks:: @code{@@ifhtml} and @code{@@end ifhtml}
|
|
||||||
* html blocks:: @code{@@html} and @code{@@end html}
|
|
||||||
* href:: @code{@@href@{text,node,file,URL@}}
|
|
||||||
* gif:: @code{@@gif@{gif-file@}}
|
|
||||||
@end menu
|
|
||||||
|
|
||||||
@comment ******************************************************* NODE
|
|
||||||
@comment Top -> Extensions ->
|
|
||||||
@node ifhtml blocks
|
|
||||||
@section @code{@@ifhtml} and @code{@@end ifhtml}
|
|
||||||
@cindex Conditional HTML blocks
|
|
||||||
|
|
||||||
@var{@@ifhtml} blocks are similar to @var{@@ifinfo} and @var{@@iftex}
|
|
||||||
blocks. Lines between @var{@@ifhtml} and @var{@@end ifhtml} get
|
|
||||||
processed when generating the hypertext manual but get ignored when
|
|
||||||
generating the printed manual.
|
|
||||||
|
|
||||||
@var{texinfo.tex} (in @var{/usr/local/lib/tex/macros} on my machine)
|
|
||||||
needs to be modified in order to use @@ifhtml. I inserted
|
|
||||||
@example
|
|
||||||
\def\ifhtml@{\doignore@{ifhtml@}@}
|
|
||||||
@end example
|
|
||||||
after the @code{\def\ifinfo@{\doignore@{ifinfo@}@}} line (line
|
|
||||||
596 ???).
|
|
||||||
|
|
||||||
In most cases, it is better to use @var{@@ifinfo} than @var{@@ifhtml}.
|
|
||||||
|
|
||||||
@comment ******************************************************* NODE
|
|
||||||
@node html blocks
|
|
||||||
@section @code{@@html} and @code{@@end html}
|
|
||||||
@cindex Pure HTML blocks
|
|
||||||
|
|
||||||
@var{@@html} blocks are similar to @var{@@tex} blocks; @var{@@html}
|
|
||||||
blocks only get processed when generating HTML and lines within
|
|
||||||
@var{@@html} blocks may contain HTML commands.
|
|
||||||
|
|
||||||
@ifhtml
|
|
||||||
For example,
|
|
||||||
|
|
||||||
@example
|
|
||||||
@@html
|
|
||||||
produces <EM><EM></EM> in HTML is like @@var@{@@@@var@} in texinfo.
|
|
||||||
@@end html
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@html
|
|
||||||
produces <EM><EM></EM> in HTML is like @var{@@var} in texinfo.
|
|
||||||
@end html
|
|
||||||
@end ifhtml
|
|
||||||
|
|
||||||
@var{texinfo.tex} (in @var{/usr/local/lib/tex/macros} on my machine)
|
|
||||||
needs to be modified in order to use @@ifhtml. I inserted
|
|
||||||
@example
|
|
||||||
\def\html@{\doignore@{html@}@}
|
|
||||||
@end example
|
|
||||||
after the @code{\def\ifinfo@{\doignore@{ifinfo@}@}} line (line
|
|
||||||
596 ???).
|
|
||||||
|
|
||||||
@comment ******************************************************* NODE
|
|
||||||
@node href
|
|
||||||
@section @code{@@href@{text,node,file,URL@}}
|
|
||||||
|
|
||||||
Use @code{@@href@{text,node,file,URL@}} when you want a hypertext link in an
|
|
||||||
HTML document and plain text everywhere else.
|
|
||||||
|
|
||||||
@var{Text} is the text you want displayed in the document.
|
|
||||||
@var{Node},@var{file}, and @var{URL} indicate what @var{text} is linked to.
|
|
||||||
@var{Node} and @var{file} are a normal texinfo style node reference;
|
|
||||||
@var{URL} is a HTML URL.
|
|
||||||
One of @var{node} or @var{URL} must be specified (if both are specified,
|
|
||||||
@var{URL} is used).
|
|
||||||
|
|
||||||
The @href{texinfo source used to create this
|
|
||||||
document,,,texi2wwwdoc.texi.txt} contains numerous examples of how
|
|
||||||
@@href might be used.
|
|
||||||
|
|
||||||
@var{texinfo.tex} (in @var{/usr/local/lib/tex/macros} on my machine)
|
|
||||||
needs to be modified in order to use @@href@{@}. All I did was insert
|
|
||||||
@example
|
|
||||||
\def\href#1{\hrefX[#1,,,]}
|
|
||||||
\def\hrefX[#1,#2,#3,#4]{#1}
|
|
||||||
@end example
|
|
||||||
before the @code{\def\pxref} line (line 3497 ???).
|
|
||||||
|
|
||||||
@comment ******************************************************* NODE
|
|
||||||
@node gif
|
|
||||||
@section @code{@@gif@{@var{pict.gif}@}}
|
|
||||||
|
|
||||||
This extension provides a method for inserting a gif file in both the
|
|
||||||
html and printed document. For example, here are my arrow icons:
|
|
||||||
@*
|
|
||||||
prev: @gif{prev-arrow.gif},
|
|
||||||
up: @gif{up-arrow.gif},
|
|
||||||
and next: @gif{next-arrow.gif}
|
|
||||||
|
|
||||||
@subsection @code{@@gif@{@}} and @var{texi2www}
|
|
||||||
|
|
||||||
@var{texi2www} copies @var{pict.gif} to the destination directory.
|
|
||||||
|
|
||||||
@subsection @code{@@gif@{@}} and @var{texi2dvi}
|
|
||||||
|
|
||||||
@href{@var{texi2dvi},texi2dvi} converts @var{pict.gif} to a font and
|
|
||||||
uses this font to insert the picture in the document. This conversion
|
|
||||||
to a font requires that the pbmplus and bm2font utilities be installed on
|
|
||||||
your system:
|
|
||||||
|
|
||||||
@table @asis
|
|
||||||
@item pbmplus
|
|
||||||
A suite of utilities for manipulating images. @var{texi2dvi} uses
|
|
||||||
@var{giftopnm}, @var{pnmscale}, @var{pnmnlfilt}, @var{ppmquant},
|
|
||||||
and @var{ppmtogif}. These utilities can be obtained from
|
|
||||||
@href{@code{
|
|
||||||
<ftp://ftp.x.org/contrib/utilities/netpbm-1mar1994.tar.gz>},,,
|
|
||||||
ftp://ftp.x.org/contrib/utilities/netpbm-1mar1994.tar.gz}.
|
|
||||||
|
|
||||||
|
|
||||||
@item bm2font
|
|
||||||
@var{bm2font} converts a bitmap images (including ``@code{.gif}''
|
|
||||||
images) to a font that can be used in a @TeX{} document.
|
|
||||||
@var{bm2font} can be obtained from
|
|
||||||
@href{@code{<ftp://ftp.shsu.edu/tex-archive/graphics/bm2font.tar.gz>},,,
|
|
||||||
ftp://ftp.shsu.edu/tex-archive/graphics/bm2font.tar.gz}.
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@comment **************************************************** CHAPTER
|
|
||||||
@node Known Bugs
|
|
||||||
@chapter Known Bugs
|
|
||||||
|
|
||||||
@enumerate
|
|
||||||
|
|
||||||
@item The @href{@code{@@center},titlefont center sp,texinfo} command
|
|
||||||
doesn't work since HTML doesn't support centering yet.
|
|
||||||
|
|
||||||
@item The @href{@code{@@noindent},noindent,texinfo} and
|
|
||||||
@href{@code{@@exdent},exdent,texinfo} commands don't work since
|
|
||||||
HTML doesn't include any facility to control indentation.
|
|
||||||
|
|
||||||
@item Mark specifications in the @href{@code{@@itemize},itemize,texinfo}
|
|
||||||
command are ignored since HTML doesn't include any facility to
|
|
||||||
specify the tag in itemized lists.
|
|
||||||
|
|
||||||
@item The @href{emacs texinfo files need to be tweaked,
|
|
||||||
problems with emacs} to work with @var{texi2www}.
|
|
||||||
|
|
||||||
@item One @href{@code{@@gif},gif} command is allowed per line.
|
|
||||||
|
|
||||||
@end enumerate
|
|
||||||
|
|
||||||
@unnumberedsec Fixed Bugs
|
|
||||||
|
|
||||||
@enumerate
|
|
||||||
|
|
||||||
@item Previous versions didn't handle nested tables correctly. The
|
|
||||||
@@item following an inner @@table would be drawn in the wrong
|
|
||||||
font. @var{(tsingle, Jan 2 1996)}
|
|
||||||
|
|
||||||
@item Previous versions didn't capitalize
|
|
||||||
@href{@code{@@sc@{@}},Smallcaps,texinfo} text. (There's still
|
|
||||||
the problem of HTML not supporting true smallcaps, however).
|
|
||||||
@var{(tsingle, Sep 6 1995)}
|
|
||||||
|
|
||||||
@item Previous versions of @var{texi2www} didn't correctly index
|
|
||||||
@href{@code{@@ftable} and @code{@@vtable},ftable vtable,texinfo}
|
|
||||||
items; this bug has been fixed! @var{(tsingle, Aug 17 1995)}
|
|
||||||
|
|
||||||
@end enumerate
|
|
||||||
|
|
||||||
@node problems with emacs
|
|
||||||
@section emacs.texi @result{} HTML problems
|
|
||||||
|
|
||||||
The file @var{man/commands.texi} distributed with GNU Emacs version
|
|
||||||
version 19.25 contains, near the top of the file:
|
|
||||||
|
|
||||||
@example
|
|
||||||
@@c See file emacs.texi for copying conditions.
|
|
||||||
@@iftex
|
|
||||||
@@chapter Characters, Keys and Commands
|
|
||||||
|
|
||||||
This chapter explains the character set used by Emacs for input commands
|
|
||||||
and for the contents of files, and also explains the concepts of
|
|
||||||
@@dfn@{keys@} and @@dfn@{commands@} which are necessary for understanding how
|
|
||||||
your keyboard input is understood by Emacs.
|
|
||||||
@@end iftex
|
|
||||||
@@node User Input, Keys, Screen, Top
|
|
||||||
@@section Keyboard Input
|
|
||||||
@end example
|
|
||||||
|
|
||||||
Texi2www doesn't see the @@chapter since it's inside an @@iftex block;
|
|
||||||
this confuses texi2www's chapter numbering. My fix was to change this
|
|
||||||
section to:
|
|
||||||
|
|
||||||
@example
|
|
||||||
@@c See file emacs.texi for copying conditions.
|
|
||||||
@@node User Input, Keys, Screen, Top
|
|
||||||
@@chapter Characters, Keys and Commands
|
|
||||||
@@iftex
|
|
||||||
|
|
||||||
This chapter explains the character set used by Emacs for input commands
|
|
||||||
and for the contents of files, and also explains the concepts of
|
|
||||||
@@dfn@{keys@} and @@dfn@{commands@} which are necessary for understanding how
|
|
||||||
your keyboard input is understood by Emacs.
|
|
||||||
@@end iftex
|
|
||||||
@@section Keyboard Input
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@var{killing.texi}, @var{misc.texi}, and @var{trouble.texi} have similar
|
|
||||||
problems.
|
|
||||||
|
|
||||||
@comment **************************************************** CHAPTER
|
|
||||||
@node Demo
|
|
||||||
@appendix Sample output
|
|
||||||
|
|
||||||
This document itself is a pretty good example of what texi2www supports
|
|
||||||
and produces. Following are some examples to really make things clear;
|
|
||||||
to fully appreciate these examples compare the source and printed output
|
|
||||||
to your html viewer.
|
|
||||||
|
|
||||||
@menu
|
|
||||||
* Fonts:: @@var@{@}, etc.
|
|
||||||
* Glyphs:: @@result@{@}, etc.
|
|
||||||
* Blocks:: @@example ... @@end example, etc.
|
|
||||||
* Tables and Lists:: @@table .. @@end table, etc.
|
|
||||||
@end menu
|
|
||||||
|
|
||||||
@comment **************************************************** SECTION
|
|
||||||
@node Fonts
|
|
||||||
@unnumberedsec Text markup
|
|
||||||
|
|
||||||
Texi2www supports:
|
|
||||||
|
|
||||||
@table @asis
|
|
||||||
|
|
||||||
@item @@b@{@var{bold text}@} @result{} @b{bold text}
|
|
||||||
Here is @b{some text} in the @@b font.
|
|
||||||
|
|
||||||
@item @@cite@{@var{reference}@} @result{} @cite{reference}
|
|
||||||
Indicate the name of a book.
|
|
||||||
Here is @cite{some text} in the @@cite font.
|
|
||||||
|
|
||||||
@item @@code@{@var{sample-code}@} @result{} @code{sample-code}
|
|
||||||
Indicate text that is a literal example of a piece of a program.
|
|
||||||
Here is @code{some text} in the @@code font.
|
|
||||||
|
|
||||||
@item @@dfn@{@var{term}@} @result{} @dfn{term}
|
|
||||||
Indicate the introductory or defining use of a term.
|
|
||||||
Here is @dfn{some text} in the @@dfn font.
|
|
||||||
|
|
||||||
@item @@dmn@{@var{text}@} @result{} @dmn{text}
|
|
||||||
Here is @dmn{some text} in the @@dmn font.
|
|
||||||
|
|
||||||
@item @@emph@{@var{text}@} @result{} @emph{text}
|
|
||||||
Here is @emph{some text} in the @@emph font.
|
|
||||||
|
|
||||||
@item @@file@{@var{file-name}@} @result{} @file{file-name}
|
|
||||||
Indicate the name of a file.
|
|
||||||
Here is @file{some text} in the @@file font.
|
|
||||||
|
|
||||||
@item @@i@{@var{italic text}@} @result{} @i{italic text}
|
|
||||||
Here is @i{some text} in the @@i font.
|
|
||||||
|
|
||||||
@item @@kbd@{@var{keyboard-characters}@} @result{} @kbd{keyboard-characters}
|
|
||||||
Indicate keyboard input.
|
|
||||||
Here is @kbd{some text} in the @@kbd font.
|
|
||||||
|
|
||||||
@item @@key@{@var{key-name}@} @result{} @key{key-name}
|
|
||||||
Indicate the conventional name for a key on a keyboard.
|
|
||||||
Here is @key{some text} in the @@key font.
|
|
||||||
|
|
||||||
@item @@math@{@var{ax^2+b}@} @result{} @math{ax^2+b}
|
|
||||||
Here is @r{some text} in the @@math font.
|
|
||||||
|
|
||||||
@item @@r@{@var{roman font text}@} @result{} @r{roman font text}
|
|
||||||
Here is @r{some text} in the @@r font.
|
|
||||||
|
|
||||||
@item @@samp@{@var{text}@} @result{} @samp{text}
|
|
||||||
Indicate text that is a literal example of a sequence of characters.
|
|
||||||
Here is @samp{some text} in the @@samp font.
|
|
||||||
|
|
||||||
@item @@sc@{@var{text}@} @result{} @sc{text}
|
|
||||||
Here is @sc{some text} in the @@sc font.
|
|
||||||
|
|
||||||
@item @@strong@{@var{text}@} @result{} @strong{text}
|
|
||||||
Here is @strong{some text} in the @@strong font.
|
|
||||||
|
|
||||||
@item @@t@{@var{fixed-width text}@} @result{} @t{fixed-width text}
|
|
||||||
Here is @t{some text} in the @@t font.
|
|
||||||
|
|
||||||
@item @@titlefont@{@var{text}@} @result{} @titlefont{text}
|
|
||||||
Here is @titlefont{some text} in the @@titlefont font.
|
|
||||||
|
|
||||||
@item @@var@{@var{metasyntactic-variable}@} @result{} @var{metasyntactic-variable}
|
|
||||||
Indicate a metasyntactic variable.
|
|
||||||
Here is @var{some text} in the @@var font.
|
|
||||||
|
|
||||||
@end table
|
|
||||||
|
|
||||||
|
|
||||||
@comment **************************************************** SECTION
|
|
||||||
@node Glyphs
|
|
||||||
@unnumberedsec Glyphs
|
|
||||||
|
|
||||||
@table @asis
|
|
||||||
|
|
||||||
@item @@TeX@{@} @result{} @TeX{}
|
|
||||||
@item @@bullet@{@} @result{} @bullet{}
|
|
||||||
@item @@copyright@{@} @result{} @copyright{}
|
|
||||||
@item @@dots@{@} @result{} @dots{}
|
|
||||||
@item @@equiv@{@} @result{} @equiv{}
|
|
||||||
@item @@error@{@} @result{} @error{}
|
|
||||||
@item @@expansion@{@} @result{} @expansion{}
|
|
||||||
@item @@minus@{@} @result{} @minus{}
|
|
||||||
@item @@point@{@} @result{} @point{}
|
|
||||||
@item @@print@{@} @result{} @print{}
|
|
||||||
@item @@result@{@} @result{} @result{}
|
|
||||||
@item @@today@{@} @result{} @today{}
|
|
||||||
|
|
||||||
@end table
|
|
||||||
|
|
||||||
@comment **************************************************** SECTION
|
|
||||||
@node Blocks
|
|
||||||
@unnumberedsec Blocks
|
|
||||||
|
|
||||||
@example
|
|
||||||
@cartouche
|
|
||||||
@@example
|
|
||||||
@@cartouche
|
|
||||||
Here's two lines
|
|
||||||
of text
|
|
||||||
@@end cartouche
|
|
||||||
@@end example
|
|
||||||
@end cartouche
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@display
|
|
||||||
@@display
|
|
||||||
Here's two lines
|
|
||||||
of text
|
|
||||||
@@end display
|
|
||||||
@end display
|
|
||||||
|
|
||||||
@example
|
|
||||||
@@example
|
|
||||||
Here's two lines
|
|
||||||
of text
|
|
||||||
@@end example
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@format
|
|
||||||
@@format
|
|
||||||
Here's two lines
|
|
||||||
of text
|
|
||||||
@@end format
|
|
||||||
@end format
|
|
||||||
|
|
||||||
@lisp
|
|
||||||
@@lisp
|
|
||||||
Here's two lines
|
|
||||||
of text
|
|
||||||
@@end lisp
|
|
||||||
@end lisp
|
|
||||||
|
|
||||||
@quotation
|
|
||||||
@@quotation
|
|
||||||
Here's two lines
|
|
||||||
of text
|
|
||||||
@@end quotation
|
|
||||||
@end quotation
|
|
||||||
|
|
||||||
@smallexample
|
|
||||||
@@smallexample
|
|
||||||
Here's two lines
|
|
||||||
of text
|
|
||||||
@@end smallexample
|
|
||||||
@end smallexample
|
|
||||||
|
|
||||||
@comment **************************************************** SECTION
|
|
||||||
@node Tables and Lists
|
|
||||||
@unnumberedsec Tables and Lists
|
|
||||||
|
|
||||||
@example
|
|
||||||
@@table @@code
|
|
||||||
@@item code-one
|
|
||||||
@@table @@var
|
|
||||||
@@item var-one
|
|
||||||
@@table @@samp
|
|
||||||
@@item samp-one
|
|
||||||
Hmmm.
|
|
||||||
@@item samp-two
|
|
||||||
Mmmmh.
|
|
||||||
@@end table
|
|
||||||
@@item var-two
|
|
||||||
Huh?
|
|
||||||
@@end table
|
|
||||||
@@item code-two
|
|
||||||
Duh?
|
|
||||||
@@end table
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@table @code
|
|
||||||
@item code-one
|
|
||||||
@table @var
|
|
||||||
@item var-one
|
|
||||||
@table @samp
|
|
||||||
@item samp-one
|
|
||||||
Hmmm.
|
|
||||||
@item samp-two
|
|
||||||
Mmmmh.
|
|
||||||
@end table
|
|
||||||
@item var-two
|
|
||||||
Huh?
|
|
||||||
@end table
|
|
||||||
@item code-two
|
|
||||||
Duh?
|
|
||||||
@end table
|
|
||||||
|
|
||||||
|
|
||||||
@comment **************************************************** CHAPTER
|
|
||||||
@node texi2dvi
|
|
||||||
@appendix texi2dvi & texinfo.tex
|
|
||||||
|
|
||||||
Versions of ``@code{texi2dvi}'' and ``@code{texinfo.tex}'' are included
|
|
||||||
with this package. These are compatible with the
|
|
||||||
@href{texi2www extensions,Extensions}.
|
|
||||||
|
|
||||||
@appendixsec texi2dvi
|
|
||||||
|
|
||||||
@appendixsec texinfo.tex
|
|
||||||
|
|
||||||
``@code{texinfo.tex}'' is a @TeX{} macro used during the @var{texinfo}
|
|
||||||
@result{} @var{dvi} conversion.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
@comment **************************************************** CHAPTER
|
|
||||||
@node Index
|
|
||||||
@unnumbered Index
|
|
||||||
@printindex cp
|
|
||||||
|
|
||||||
@contents
|
|
||||||
@bye
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 264 B |
Reference in New Issue
Block a user