[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Texi2html-cvs] texi2html ./ChangeLog ./NEWS ./T2h_l2h.pm ./tex...
From: |
Patrice Dumas |
Subject: |
[Texi2html-cvs] texi2html ./ChangeLog ./NEWS ./T2h_l2h.pm ./tex... |
Date: |
Sat, 25 Mar 2006 13:26:53 +0000 |
CVSROOT: /cvsroot/texi2html
Module name: texi2html
Branch:
Changes by: Patrice Dumas <address@hidden> 06/03/25 13:26:48
Modified files:
. : ChangeLog NEWS T2h_l2h.pm texi2html.init
texi2html.pl
Tests/ccvs_res : cvs_1.html cvs_10.html cvs_12.html cvs_13.html
cvs_16.html cvs_17.html cvs_18.html cvs_2.html
cvs_21.html cvs_22.html cvs_23.html cvs_3.html
cvs_4.html cvs_5.html cvs_6.html cvs_7.html
cvs_8.html cvs_9.html
Tests/floats_res: float.html
Tests/formatting_res:
_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e.html
chapter_test_refs.html
chapter_test_refs_1.html clean.html
comments.html comments_redefined.html
complex_command_in_simple_command.html
exotic_formatting.html
exotic_formatting_1.html
formats_not_closed.html formatting.html
fr_formatting.html
icons_fr_formatting.html imbrications.html
index.html local-node.html menus.html
menus_simple.html other-nodes.html
test_refs.html testkb.html
verbatim_html.html
Tests/macros_res: macros.html simple_macro.html
Tests/nodes_texinfo_res: A4-Paper.html Abstract-Objects.html
Conditional-Commands.html
Conditional-Not-Commands.html
Contents.html Conventions.html
Copyright.html
Cropmarks-and-Magnification.html
Cross-Reference-Commands.html
Cross-Reference-Parts.html
Custom-Headings.html Data-Types.html
Debugging-with-Info.html
Debugging-with-TeX.html
Def-Cmd-Template.html
Defining-Macros.html
Directory-File.html End-of-Header.html
Ending-a-File.html Error-Glyph.html
First-Node.html Fonts.html
Footnote-Commands.html
Footnote-Styles.html
Format-with-tex_002ftexindex.html
Format-with-texi2dvi.html
Formatting-Commands.html
Four-and-Five-Arguments.html
Functions-Commands.html
GNU-Free-Documentation-License.html
GNU-Sample-Texts.html
Heading-Choice.html Heading-Format.html
Images.html Indexing-Commands.html
Info-Files.html Info-Formatting.html
Installing-Dir-Entries.html
Invoking-Macros.html
Invoking-install_002dinfo.html
Invoking-makeinfo.html
Less-Cluttered-Menu-Entry.html
Lists-and-Tables.html
Macro-Details.html
Master-Menu-Parts.html
Menu-Example.html Menu-Parts.html
Menus.html Minimum.html
Multiple-Spaces.html
Multitable-Column-Widths.html
Multitable-Rows.html New-Indices.html
Node-Line-Requirements.html
Node-Menu-Illustration.html
Not-Ending-a-Sentence.html
Obtaining-TeX.html One-Argument.html
Optional-Arguments.html
Other-Info-Directories.html
Other-Info-Files.html
Other-Updating-Commands.html
Overfull-hboxes.html Point-Glyph.html
Predefined-Indices.html
Preparing-for-TeX.html Print-Glyph.html
Print-with-lpr.html
Raise_002flower-sections.html
Requirements-Summary.html
Sample-Beginning.html
Sample-Function-Definition.html
Sample-Include-File.html
Short-Sample-Texinfo-File.html
Short-Sample.html Smallcaps.html
Start-of-Header.html Tagifying.html
Texinfo-File-Header.html
Texinfo-Mode-Printing.html
Texinfo-Mode-Summary.html
Three-Arguments.html Tips.html
Top-Node-Example.html
Top-Node-Naming.html
Tree-Structuring.html
Two-Arguments.html Typed-Functions.html
Typed-Variables.html
Updating-Requirements.html
Using-Include-Files.html
Using-texinfo_002dshow_002dstructure.html
Variables-Commands.html
Within-Emacs.html Writing-a-Menu.html
Writing-a-Node.html
_002d-and-hyphenation.html alias.html
anchor.html chapter.html command.html
copying.html display.html
documentdescription.html
documentencoding.html email.html
emph-_0026-strong.html env.html
example.html exampleindent.html
exdent.html expansion.html format.html
ifset-ifclear.html inforef.html
insertcopying.html itemx.html kbd.html
key.html lisp.html
makeinfo-in-Emacs.html
makeinfo-options.html
makeinfo-top-command.html math.html
need.html noindent.html option.html
pagesizes.html paragraphindent.html
pxref.html ref.html section.html
set-value.html setchapternewpage.html
setfilename.html settitle.html
small.html subsection.html
subsubsection.html syncodeindex.html
texinfo_283.html
title-subtitle-author.html
titlefont-center-sp.html uref.html
url.html value-Example.html var.html
verb.html verbatiminclude.html w.html
xref.html
Tests/texi2html_res: texi2html.html
Tests/texinfo_res: info-stnd_10.html info-stnd_12.html
info-stnd_13.html info-stnd_2.html
info-stnd_5.html info-stnd_7.html
info-stnd_8.html texinfo_10.html
texinfo_11.html texinfo_12.html
texinfo_13.html texinfo_14.html
texinfo_15.html texinfo_16.html
texinfo_17.html texinfo_18.html
texinfo_19.html texinfo_2.html
texinfo_20.html texinfo_21.html
texinfo_23.html texinfo_24.html
texinfo_25.html texinfo_26.html
texinfo_27.html texinfo_3.html
texinfo_30.html texinfo_31.html
texinfo_4.html texinfo_5.html texinfo_6.html
texinfo_7.html texinfo_8.html texinfo_9.html
Tests/viper_monolithic_res: viper.html
Tests/viper_res: viper.html viper_0.html viper_2.html
viper_3.html viper_4.html viper_5.html
viper_6.html
Tests/xemacs_frame_res: xemacs_1.html xemacs_10.html
xemacs_11.html xemacs_12.html
xemacs_15.html xemacs_17.html
xemacs_20.html xemacs_22.html
xemacs_23.html xemacs_24.html
xemacs_25.html xemacs_28.html
xemacs_29.html xemacs_30.html
xemacs_4.html xemacs_5.html
xemacs_6.html xemacs_7.html
xemacs_9.html
Tests/xemacs_res: xemacs_1.html xemacs_10.html xemacs_11.html
xemacs_12.html xemacs_15.html xemacs_17.html
xemacs_20.html xemacs_22.html xemacs_23.html
xemacs_24.html xemacs_25.html xemacs_28.html
xemacs_29.html xemacs_30.html xemacs_4.html
xemacs_5.html xemacs_6.html xemacs_7.html
xemacs_9.html
doc : texi2html.html texi2html.texi
examples : roff.init
Log message:
* texi2html.init: handle @indent. Remove an empty line
generated by @indent and @noindent.
Add an end of line after a complex format.
* texi2html.init,texi2html.pl,examples/roff.init: add an indent
information to the paragraph command.
* doc/, NEWS: document the changes.
* T2h_l2h.pm: merge init_to_latex() into init().
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/ChangeLog.diff?tr1=1.234&tr2=1.235&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/NEWS.diff?tr1=1.48&tr2=1.49&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/T2h_l2h.pm.diff?tr1=1.1&tr2=1.2&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/texi2html.init.diff?tr1=1.95&tr2=1.96&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/texi2html.pl.diff?tr1=1.157&tr2=1.158&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_1.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_10.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_12.html.diff?tr1=1.30&tr2=1.31&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_13.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_16.html.diff?tr1=1.32&tr2=1.33&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_17.html.diff?tr1=1.27&tr2=1.28&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_18.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_2.html.diff?tr1=1.24&tr2=1.25&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_21.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_22.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_23.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_3.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_4.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_5.html.diff?tr1=1.29&tr2=1.30&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_6.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_7.html.diff?tr1=1.24&tr2=1.25&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_8.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/ccvs_res/cvs_9.html.diff?tr1=1.27&tr2=1.28&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/floats_res/float.html.diff?tr1=1.7&tr2=1.8&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e.html.diff?tr1=1.4&tr2=1.5&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/chapter_test_refs.html.diff?tr1=1.6&tr2=1.7&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/chapter_test_refs_1.html.diff?tr1=1.5&tr2=1.6&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/clean.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/comments.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/comments_redefined.html.diff?tr1=1.1&tr2=1.2&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/complex_command_in_simple_command.html.diff?tr1=1.7&tr2=1.8&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/exotic_formatting.html.diff?tr1=1.48&tr2=1.49&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/exotic_formatting_1.html.diff?tr1=1.30&tr2=1.31&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/formats_not_closed.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/formatting.html.diff?tr1=1.48&tr2=1.49&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/fr_formatting.html.diff?tr1=1.41&tr2=1.42&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/icons_fr_formatting.html.diff?tr1=1.3&tr2=1.4&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/imbrications.html.diff?tr1=1.29&tr2=1.30&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/index.html.diff?tr1=1.4&tr2=1.5&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/local-node.html.diff?tr1=1.4&tr2=1.5&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/menus.html.diff?tr1=1.3&tr2=1.4&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/menus_simple.html.diff?tr1=1.3&tr2=1.4&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/other-nodes.html.diff?tr1=1.4&tr2=1.5&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/test_refs.html.diff?tr1=1.7&tr2=1.8&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/testkb.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/formatting_res/verbatim_html.html.diff?tr1=1.35&tr2=1.36&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/macros_res/macros.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/macros_res/simple_macro.html.diff?tr1=1.24&tr2=1.25&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/A4-Paper.html.diff?tr1=1.14&tr2=1.15&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Abstract-Objects.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Conditional-Commands.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Conditional-Not-Commands.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Contents.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Conventions.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Copyright.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Cropmarks-and-Magnification.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Cross-Reference-Commands.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Cross-Reference-Parts.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Custom-Headings.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Data-Types.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Debugging-with-Info.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Debugging-with-TeX.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Def-Cmd-Template.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Defining-Macros.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Directory-File.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/End-of-Header.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Ending-a-File.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Error-Glyph.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/First-Node.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Fonts.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Footnote-Commands.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Footnote-Styles.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Format-with-tex_002ftexindex.html.diff?tr1=1.6&tr2=1.7&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Format-with-texi2dvi.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Formatting-Commands.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Four-and-Five-Arguments.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Functions-Commands.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/GNU-Free-Documentation-License.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/GNU-Sample-Texts.html.diff?tr1=1.69&tr2=1.70&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Heading-Choice.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Heading-Format.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Images.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Indexing-Commands.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Info-Files.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Info-Formatting.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Installing-Dir-Entries.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Invoking-Macros.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Invoking-install_002dinfo.html.diff?tr1=1.6&tr2=1.7&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Invoking-makeinfo.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Less-Cluttered-Menu-Entry.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Lists-and-Tables.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Macro-Details.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Master-Menu-Parts.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Menu-Example.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Menu-Parts.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Menus.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Minimum.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Multiple-Spaces.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Multitable-Column-Widths.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Multitable-Rows.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/New-Indices.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Node-Line-Requirements.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Node-Menu-Illustration.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Not-Ending-a-Sentence.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Obtaining-TeX.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/One-Argument.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Optional-Arguments.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Other-Info-Directories.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Other-Info-Files.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Other-Updating-Commands.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Overfull-hboxes.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Point-Glyph.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Predefined-Indices.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Preparing-for-TeX.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Print-Glyph.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Print-with-lpr.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Raise_002flower-sections.html.diff?tr1=1.5&tr2=1.6&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Requirements-Summary.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Sample-Beginning.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Sample-Function-Definition.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Sample-Include-File.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Short-Sample-Texinfo-File.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Short-Sample.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Smallcaps.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Start-of-Header.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Tagifying.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Texinfo-File-Header.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Printing.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Summary.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Three-Arguments.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Tips.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Top-Node-Example.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Top-Node-Naming.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Tree-Structuring.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Two-Arguments.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Typed-Functions.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Typed-Variables.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Updating-Requirements.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Using-Include-Files.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Using-texinfo_002dshow_002dstructure.html.diff?tr1=1.6&tr2=1.7&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Variables-Commands.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Within-Emacs.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Writing-a-Menu.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/Writing-a-Node.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/_002d-and-hyphenation.html.diff?tr1=1.7&tr2=1.8&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/alias.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/anchor.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/chapter.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/command.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/copying.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/display.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/documentdescription.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/documentencoding.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/email.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/emph-_0026-strong.html.diff?tr1=1.6&tr2=1.7&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/env.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/example.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/exampleindent.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/exdent.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/expansion.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/format.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/ifset-ifclear.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/inforef.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/insertcopying.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/itemx.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/kbd.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/key.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/lisp.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/makeinfo-in-Emacs.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/makeinfo-options.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/makeinfo-top-command.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/math.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/need.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/noindent.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/option.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/pagesizes.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/paragraphindent.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/pxref.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/ref.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/section.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/set-value.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/setchapternewpage.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/setfilename.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/settitle.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/small.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/subsection.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/subsubsection.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/syncodeindex.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/texinfo_283.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/title-subtitle-author.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/titlefont-center-sp.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/uref.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/url.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/value-Example.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/var.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/verb.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/verbatiminclude.html.diff?tr1=1.15&tr2=1.16&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/w.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/nodes_texinfo_res/xref.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texi2html_res/texi2html.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/info-stnd_10.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/info-stnd_12.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/info-stnd_13.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/info-stnd_2.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/info-stnd_5.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/info-stnd_7.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/info-stnd_8.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_10.html.diff?tr1=1.26&tr2=1.27&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_11.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_12.html.diff?tr1=1.29&tr2=1.30&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_13.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_14.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_15.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_16.html.diff?tr1=1.24&tr2=1.25&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_17.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_18.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_19.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_2.html.diff?tr1=1.26&tr2=1.27&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_20.html.diff?tr1=1.26&tr2=1.27&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_21.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_23.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_24.html.diff?tr1=1.74&tr2=1.75&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_25.html.diff?tr1=1.26&tr2=1.27&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_26.html.diff?tr1=1.26&tr2=1.27&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_27.html.diff?tr1=1.26&tr2=1.27&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_3.html.diff?tr1=1.27&tr2=1.28&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_30.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_31.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_4.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_5.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_6.html.diff?tr1=1.24&tr2=1.25&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_7.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_8.html.diff?tr1=1.24&tr2=1.25&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/texinfo_res/texinfo_9.html.diff?tr1=1.27&tr2=1.28&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/viper_monolithic_res/viper.html.diff?tr1=1.32&tr2=1.33&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/viper_res/viper.html.diff?tr1=1.17&tr2=1.18&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/viper_res/viper_0.html.diff?tr1=1.13&tr2=1.14&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/viper_res/viper_2.html.diff?tr1=1.24&tr2=1.25&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/viper_res/viper_3.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/viper_res/viper_4.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/viper_res/viper_5.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/viper_res/viper_6.html.diff?tr1=1.14&tr2=1.15&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_1.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_10.html.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_11.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_12.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_15.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_17.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_20.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_22.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_23.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_24.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_25.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_28.html.diff?tr1=1.18&tr2=1.19&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_29.html.diff?tr1=1.21&tr2=1.22&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_30.html.diff?tr1=1.23&tr2=1.24&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_4.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_5.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_6.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_7.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_frame_res/xemacs_9.html.diff?tr1=1.19&tr2=1.20&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_1.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_10.html.diff?tr1=1.20&tr2=1.21&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_11.html.diff?tr1=1.24&tr2=1.25&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_12.html.diff?tr1=1.26&tr2=1.27&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_15.html.diff?tr1=1.28&tr2=1.29&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_17.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_20.html.diff?tr1=1.26&tr2=1.27&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_22.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_23.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_24.html.diff?tr1=1.27&tr2=1.28&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_25.html.diff?tr1=1.29&tr2=1.30&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_28.html.diff?tr1=1.22&tr2=1.23&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_29.html.diff?tr1=1.27&tr2=1.28&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_30.html.diff?tr1=1.29&tr2=1.30&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_4.html.diff?tr1=1.26&tr2=1.27&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_5.html.diff?tr1=1.27&tr2=1.28&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_6.html.diff?tr1=1.27&tr2=1.28&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_7.html.diff?tr1=1.25&tr2=1.26&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/Tests/xemacs_res/xemacs_9.html.diff?tr1=1.24&tr2=1.25&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/doc/texi2html.html.diff?tr1=1.32&tr2=1.33&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/doc/texi2html.texi.diff?tr1=1.44&tr2=1.45&r1=text&r2=text
http://cvs.savannah.gnu.org/viewcvs/texi2html/texi2html/examples/roff.init.diff?tr1=1.10&tr2=1.11&r1=text&r2=text
Patches:
Index: texi2html/ChangeLog
diff -u texi2html/ChangeLog:1.234 texi2html/ChangeLog:1.235
--- texi2html/ChangeLog:1.234 Sat Jan 28 22:02:26 2006
+++ texi2html/ChangeLog Sat Mar 25 13:26:46 2006
@@ -1,3 +1,13 @@
+2006-03-25 Patrice Dumas <address@hidden>
+
+ * texi2html.init: handle @indent. Remove an empty line
+ generated by @indent and @noindent.
+ Add an end of line after a complex format.
+ * texi2html.init,texi2html.pl,examples/roff.init: add an indent
+ information to the paragraph command.
+ * doc/, NEWS: document the changes.
+ * T2h_l2h.pm: merge init_to_latex() into init().
+
2006-01-28 Patrice Dumas <address@hidden>
* texi2html.pl,Makefile.am,buildt2h.sh: move latex2html stuff
Index: texi2html/NEWS
diff -u texi2html/NEWS:1.48 texi2html/NEWS:1.49
--- texi2html/NEWS:1.48 Sat Jan 28 22:02:26 2006
+++ texi2html/NEWS Sat Mar 25 13:26:46 2006
@@ -5,7 +5,7 @@
* NEW FEATURES
------------
-* Handle @frenchspacing and @tie.
+* Handle @frenchspacing, @tie and @indent.
* The `examples' directory now contains an init file for Mediawiki output.
Mediawiki is the GPL'd wiki used by Wikipedia.
@@ -38,7 +38,7 @@
file names are in the hash reference $Texi2HTML::THISDOC{'filename'}
for use in init files.
-* The API for image and normal_text changed.
+* The API for image and normal_text and paragraph is changed.
* Use entities for ``, '', --- and -- if $USE_ISO is set.
Index: texi2html/T2h_l2h.pm
diff -u texi2html/T2h_l2h.pm:1.1 texi2html/T2h_l2h.pm:1.2
--- texi2html/T2h_l2h.pm:1.1 Sat Jan 28 22:02:26 2006
+++ texi2html/T2h_l2h.pm Sat Mar 25 13:26:46 2006
@@ -57,27 +57,10 @@
my $docu_ext;
my $ERROR = '***';
-sub init
-{
- $docu_name = $Texi2HTML::THISDOC{'file_base_name'};
- $docu_rdir = $Texi2HTML::THISDOC{'out_dir'};
- $docu_ext = $Texi2HTML::THISDOC{'extension'};
- $l2h_name = "${docu_name}_l2h";
- $l2h_latex_file = "$docu_rdir${l2h_name}.tex";
- $l2h_cache_file = "${docu_rdir}l2h_cache.pm";
- # destination dir -- generated images are put there, should be the same
- # as dir of enclosing html document --
- $l2h_html_file = "$docu_rdir${l2h_name}.html";
- $l2h_prefix = "${l2h_name}_";
- $debug = $Texi2HTML::THISDOC{'debug_l2h'};
- $verbose = $Texi2HTML::Config::VERBOSE;
- $status = init_to_latex();
-}
-
##########################
#
# First stage: Generation of Latex file
-# Initialize with: init_to_latex
+# Initialize with: init
# Add content with: to_latex ($text) --> HTML placeholder comment
# Finish with: finish_to_latex
#
@@ -110,22 +93,36 @@
# corresponding counter to the index in the
# html result array
-# return 1, if l2h could be initalized properly, 0 otherwise
-sub init_to_latex()
+# set $status to 1, if l2h could be initalized properly, to 0 otherwise
+sub init()
{
+ $docu_name = $Texi2HTML::THISDOC{'file_base_name'};
+ $docu_rdir = $Texi2HTML::THISDOC{'out_dir'};
+ $docu_ext = $Texi2HTML::THISDOC{'extension'};
+ $l2h_name = "${docu_name}_l2h";
+ $l2h_latex_file = "$docu_rdir${l2h_name}.tex";
+ $l2h_cache_file = "${docu_rdir}l2h_cache.pm";
+ # destination dir -- generated images are put there, should be the same
+ # as dir of enclosing html document --
+ $l2h_html_file = "$docu_rdir${l2h_name}.html";
+ $l2h_prefix = "${l2h_name}_";
+ $debug = $Texi2HTML::THISDOC{'debug_l2h'};
+ $verbose = $Texi2HTML::Config::VERBOSE;
+
unless ($Texi2HTML::Config::L2H_SKIP)
{
unless (open(L2H_LATEX, ">$l2h_latex_file"))
{
warn "$ERROR l2h: Can't open latex file '$l2h_latex_file' for
writing: $!\n";
- return 0;
+ $status = 0;
+ return;
}
warn "# l2h: use ${l2h_latex_file} as latex file\n" if ($verbose);
print L2H_LATEX $l2h_latex_preamble;
}
# open the database that holds cached text
init_cache();
- return 1;
+ $status = 1;
}
Index: texi2html/Tests/ccvs_res/cvs_1.html
diff -u texi2html/Tests/ccvs_res/cvs_1.html:1.23
texi2html/Tests/ccvs_res/cvs_1.html:1.24
--- texi2html/Tests/ccvs_res/cvs_1.html:1.23 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_1.html Sat Mar 25 13:26:47 2006
@@ -151,6 +151,7 @@
<table><tr><td> </td><td><pre class="example">http://www.cvshome.org/
http://www.loria.fr/~molli/cvs-index.html
</pre></td></tr></table>
+
<a name="IDX6"></a>
<a name="IDX7"></a>
<a name="IDX8"></a>
@@ -415,6 +416,7 @@
$ ls
CVS Makefile backend.c driver.c frontend.c parser.c
</pre></td></tr></table>
+
<p>The <tt>`CVS'</tt> directory is used internally by
<small>CVS</small>. Normally, you should not modify or remove
any of the files in it.
@@ -499,6 +501,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs commit -m "Added
an optimization pass" backend.c
</pre></td></tr></table>
+
<hr size="6">
<a name="Cleaning-up"></a>
<a name="SEC7"></a>
@@ -537,6 +540,7 @@
Are you sure you want to release (and delete) directory `tc': n
** `release' aborted by user choice.
</pre></td></tr></table>
+
<p>The <code>release</code> command checks that all your modifications have
been
committed. If history logging is enabled it also makes a note in the
history file. See section <a href="cvs_18.html#SEC178">The history file</a>.
@@ -592,6 +596,7 @@
<table><tr><td> </td><td><pre class="example">$ cd tc
$ cvs diff driver.c
</pre></td></tr></table>
+
<p>This command runs <code>diff</code> to compare the version of
<tt>`driver.c'</tt>
that you checked out with your working copy. When you see the output
you remember that you added a command line option that enabled the
@@ -608,6 +613,7 @@
You have [0] altered files in this repository.
Are you sure you want to release (and delete) directory `tc': y
</pre></td></tr></table>
+
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#SEC1" title="Beginning of this
chapter or previous chapter"> << </a>]</td>
Index: texi2html/Tests/ccvs_res/cvs_10.html
diff -u texi2html/Tests/ccvs_res/cvs_10.html:1.25
texi2html/Tests/ccvs_res/cvs_10.html:1.26
--- texi2html/Tests/ccvs_res/cvs_10.html:1.25 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_10.html Sat Mar 25 13:26:47 2006
@@ -235,6 +235,7 @@
<a name="IDX146"></a>
<table><tr><td> </td><td><pre class="example">$ cvs -n -q update
</pre></td></tr></table>
+
<p>The <samp>`-n'</samp> option means to not actually do the
update, but merely to display statuses; the <samp>`-q'</samp>
option avoids printing the name of each directory. For
@@ -450,6 +451,7 @@
new revision: 1.7; previous revision: 1.6
done
</pre></td></tr></table>
+
<p>For your protection, <small>CVS</small> will refuse to check in a
file if a conflict occurred and you have not resolved
the conflict. Currently to resolve a conflict, you
@@ -525,6 +527,7 @@
</p>
<table><tr><td> </td><td><pre class="example">[11:43:23] waiting for
bach's lock in /usr/local/cvsroot/foo
</pre></td></tr></table>
+
<a name="IDX157"></a>
<a name="IDX158"></a>
<a name="IDX159"></a>
@@ -558,7 +561,6 @@
changes, or none of them.
</p></blockquote>
-
<p>but <small>CVS</small> does <em>not</em> have this property. For
example, given the files
</p>
Index: texi2html/Tests/ccvs_res/cvs_12.html
diff -u texi2html/Tests/ccvs_res/cvs_12.html:1.30
texi2html/Tests/ccvs_res/cvs_12.html:1.31
--- texi2html/Tests/ccvs_res/cvs_12.html:1.30 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_12.html Sat Mar 25 13:26:47 2006
@@ -238,6 +238,7 @@
* $<i></i>MYBSD: src/frob.c,v 1.1 2003/05/04 09:27:45 john Exp $
*/
</pre></td></tr></table>
+
<p>Many repositories make use of a such a “local
keyword” feature. An old patch to <small>CVS</small> provided
the <code>LocalKeyword</code> feature using a <code>tag=</code>
@@ -323,6 +324,7 @@
a.out:
$<i></i>Id: samp.c,v 1.5 1993/10/19 14:57:32 ceder Exp $
</pre></td></tr></table>
+
<a name="IDX196"></a>
<p>S<small>CCS</small> is another popular revision control system.
It has a command, <code>what</code>, which is very similar to
@@ -335,6 +337,7 @@
</p>
<table><tr><td> </td><td><pre class="example">static char *id="@(#)
$<i></i>Id: ab.c,v 1.5 1993/10/19 14:57:32 ceder Exp $";
</pre></td></tr></table>
+
<hr size="6">
<a name="Avoiding-substitution"></a>
<a name="SEC101"></a>
@@ -536,6 +539,7 @@
LocalKeyword=MyBSD=CVSHeader
KeywordExpand=iMyBSD
</pre></td></tr></table>
+
<p>then only the $<i></i>MyBSD$ keyword would be expanded.
A list may be used. The this example:
</p>
@@ -544,6 +548,7 @@
LocalKeyword=MyBSD=CVSHeader
KeywordExpand=iMyBSD,Name,Date
</pre></td></tr></table>
+
<p>would allow $<i></i>MyBSD$, $<i></i>Name$, and
$<i></i>Date$ to be expanded.
</p>
@@ -553,6 +558,7 @@
<table><tr><td> </td><td><pre class="example"> # Do not expand the
non-RCS keyword CVSHeader
KeywordExpand=eCVSHeader
</pre></td></tr></table>
+
<p>This allows <small>CVS</small> to ignore the recently introduced
$<i></i>CVSHeader$ keyword and retain all of the
others. The exclusion entry could also contain the
@@ -569,6 +575,7 @@
<table><tr><td> </td><td><pre class="example"> # Do not expand any RCS
keywords
KeywordExpand=i
</pre></td></tr></table>
+
<p>this could be confusing to users that expect RCS
keywords like $<i></i>Id$ to be expanded properly,
so care should be taken to properly set user
Index: texi2html/Tests/ccvs_res/cvs_13.html
diff -u texi2html/Tests/ccvs_res/cvs_13.html:1.20
texi2html/Tests/ccvs_res/cvs_13.html:1.21
--- texi2html/Tests/ccvs_res/cvs_13.html:1.20 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_13.html Sat Mar 25 13:26:47 2006
@@ -148,6 +148,7 @@
<table><tr><td> </td><td><pre class="example">$ cd wdiff-0.04
$ cvs import -m "Import of FSF v. 0.04" fsf/wdiff FSF_DIST WDIFF_0_04
</pre></td></tr></table>
+
<p>The vendor tag is named <samp>`FSF_DIST'</samp> in the above
example, and the only release tag assigned is
<samp>`WDIFF_0_04'</samp>.
@@ -182,6 +183,7 @@
$ cd wdiff-0.05
$ cvs import -m "Import of FSF v. 0.05" fsf/wdiff FSF_DIST WDIFF_0_05
</pre></td></tr></table>
+
<p>For files that have not been modified locally, the newly created
revision becomes the head revision. If you have made local
changes, <code>import</code> will warn you that you must merge the changes
@@ -358,6 +360,7 @@
<table><tr><td> </td><td><pre class="example">$ cvs import dir RED RED_1-0
$ cvs import -b 1.1.3 dir BLUE BLUE_1-5
</pre></td></tr></table>
+
<p>Note that if your vendor tag does not match your
<samp>`-b'</samp> option, <small>CVS</small> will not detect this case! For
example,
Index: texi2html/Tests/ccvs_res/cvs_16.html
diff -u texi2html/Tests/ccvs_res/cvs_16.html:1.32
texi2html/Tests/ccvs_res/cvs_16.html:1.33
--- texi2html/Tests/ccvs_res/cvs_16.html:1.32 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_16.html Sat Mar 25 13:26:47 2006
@@ -124,6 +124,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs [ cvs_options ]
cvs_command [ command_options ] [ command_args ]
</pre></td></tr></table>
+
<dl compact="compact">
<dt> <code>cvs</code></dt>
<dd><p>The name of the <small>CVS</small> program.
@@ -551,6 +552,7 @@
<table><tr><td> </td><td><pre class="example">1972-09-24
1972-09-24 20:05
</pre></td></tr></table>
+
<p>There are a lot more ISO8601 date formats, and <small>CVS</small>
accepts many of them, but you probably don't want to
hear the <em>whole</em> long story :-).
@@ -563,6 +565,7 @@
<table><tr><td> </td><td><pre class="example">24 Sep 1972 20:05
24 Sep
</pre></td></tr></table>
+
<p>The date is interpreted as being in the
local timezone, unless a specific timezone is
specified.
@@ -586,6 +589,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs diff -D "1 hour
ago" cvs.texinfo
</pre></td></tr></table>
+
<a name="IDX226"></a>
</dd>
<dt> <code>-f</code></dt>
@@ -1423,11 +1427,13 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs checkout tc
</pre></td></tr></table>
+
<p>Get a copy of the module <samp>`tc'</samp> as it looked one day
ago:
</p>
<table><tr><td> </td><td><pre class="example">$ cvs checkout -D yesterday
tc
</pre></td></tr></table>
+
<hr size="6">
<a name="commit"></a>
<a name="SEC125"></a>
@@ -1563,6 +1569,7 @@
<table><tr><td> </td><td><pre class="example">$ cvs commit -f
<var>file</var>
$ cvs commit -r 1.8 <var>file</var>
</pre></td></tr></table>
+
<p>The <samp>`-f'</samp> option disables recursion (i.e., it
implies <samp>`-l'</samp>). To force <small>CVS</small> to commit a new
revision for all files in all subdirectories, you must
@@ -1676,6 +1683,7 @@
$ cvs update -r EXPR1
$ cvs commit
</pre></td></tr></table>
+
<p>The <code>update</code> command will make the <samp>`-r
EXPR1'</samp> option sticky on all files. Note that your
changes to the files will never be removed by the
@@ -1699,6 +1707,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs checkout -r EXPR1
whatever_module
</pre></td></tr></table>
+
<hr size="6">
<a name="diff"></a>
<a name="SEC130"></a>
@@ -2129,6 +2138,7 @@
' \
myfile
</pre></td></tr></table>
+
<p>The following command is equivalent to the above example, but it is a
little more verbose, because it spells out the default line group formats.
</p>
@@ -2147,6 +2157,7 @@
' \
myfile
</pre></td></tr></table>
+
<p>Here is a more advanced example, which outputs a diff listing with
headers containing line numbers in a “plain English” style.
</p>
@@ -2161,6 +2172,7 @@
%>' \
myfile
</pre></td></tr></table>
+
<p>To specify a line group format, use one of the options
listed below. You can specify up to four line group formats, one for
each kind of line group. You should quote <var>format</var>, because it
@@ -2327,6 +2339,7 @@
' \
myfile
</pre></td></tr></table>
+
<p>To specify a line format, use one of the following options. You should
quote <var>format</var>, since it often contains shell metacharacters.
</p>
@@ -2418,6 +2431,7 @@
--unchanged-group-format='' \
myfile
</pre></td></tr></table>
+
<hr size="6">
<a name="diff-examples"></a>
<a name="SEC134"></a>
@@ -2447,17 +2461,20 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs diff -kk -u -r 1.14
-r 1.19 backend.c
</pre></td></tr></table>
+
<p>Suppose the experimental branch EXPR1 was based on a
set of files tagged RELEASE_1_0. To see what has
happened on that branch, the following can be used:
</p>
<table><tr><td> </td><td><pre class="example">$ cvs diff -r RELEASE_1_0
-r EXPR1
</pre></td></tr></table>
+
<p>A command like this can be used to produce a context
diff between two releases:
</p>
<table><tr><td> </td><td><pre class="example">$ cvs diff -c -r
RELEASE_1_0 -r RELEASE_1_1 > diffs
</pre></td></tr></table>
+
<p>If you are maintaining ChangeLogs, a command like the following
just before you commit your changes may help you write
the ChangeLog entry. All local modifications that have
@@ -2465,6 +2482,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs diff -u | less
</pre></td></tr></table>
+
<hr size="6">
<a name="export"></a>
<a name="SEC135"></a>
@@ -2716,7 +2734,6 @@
</p></dd>
</dl>
-
<p>One of four record types may result from an update:
</p>
<dl compact="compact">
@@ -2736,7 +2753,6 @@
</p></dd>
</dl>
-
<p>One of three record types results from commit:
</p>
<dl compact="compact">
@@ -3493,6 +3509,7 @@
<table><tr><td> </td><td><pre class="example">$ cvs rdiff -c -r FOO1_2 -r
FOO1_4 tc | \
$$ Mail -s 'The patches you asked for' address@hidden
</pre></td></tr></table>
+
<p>Suppose you have made release 1.3, and forked a branch
called <samp>`R_1_3fix'</samp> for bugfixes. <samp>`R_1_3_1'</samp>
corresponds to release 1.3.1, which was made some time
@@ -3505,6 +3522,7 @@
File foo.c,v changed from revision 1.52.2.3 to 1.52.2.4
File bar.h,v changed from revision 1.29.2.1 to 1.2
</pre></td></tr></table>
+
<hr size="6">
<a name="release"></a>
<a name="SEC149"></a>
@@ -3694,6 +3712,7 @@
Are you sure you want to release (and delete) directory `tc': y
$
</pre></td></tr></table>
+
<hr size="6">
<a name="update"></a>
<a name="SEC153"></a>
Index: texi2html/Tests/ccvs_res/cvs_17.html
diff -u texi2html/Tests/ccvs_res/cvs_17.html:1.27
texi2html/Tests/ccvs_res/cvs_17.html:1.28
--- texi2html/Tests/ccvs_res/cvs_17.html:1.27 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_17.html Sat Mar 25 13:26:47 2006
@@ -69,6 +69,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs [
<var>global_options</var> ] <var>command</var> [ <var>command_options</var> ] [
<var>command_args</var> ]
</pre></td></tr></table>
+
<p>Global options:
</p>
<dl compact="compact">
@@ -167,6 +168,7 @@
-ko <i>no expansion</i>
-kb <i>no expansion, file is binary</i>
</pre></td></tr></table>
+
<p>Keywords (see section <a href="cvs_12.html#SEC99">Keyword List</a>):
</p>
<table><tr><td> </td><td><pre class="example">$<i></i>Author: joe $
@@ -185,6 +187,7 @@
Initial revision
</pre></td></tr></table>
+
<p>Commands, command options, and command arguments:
</p>
<dl compact="compact">
Index: texi2html/Tests/ccvs_res/cvs_18.html
diff -u texi2html/Tests/ccvs_res/cvs_18.html:1.25
texi2html/Tests/ccvs_res/cvs_18.html:1.26
--- texi2html/Tests/ccvs_res/cvs_18.html:1.25 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_18.html Sat Mar 25 13:26:47 2006
@@ -208,6 +208,7 @@
cvs checkout: Updating first-dir/sdir
U first-dir/sdir/sfile
</pre></td></tr></table>
+
<hr size="6">
<a name="Regular-modules"></a>
<a name="SEC160"></a>
@@ -259,6 +260,7 @@
U regmodule/sdir/sfile
$
</pre></td></tr></table>
+
<p>By explicitly specifying files in the module definition
after <var>dir</var>, you can select particular files from
directory <var>dir</var>. Here is
@@ -277,6 +279,7 @@
U regfiles/sfile
$
</pre></td></tr></table>
+
<hr size="6">
<a name="Ampersand-modules"></a>
<a name="SEC161"></a>
@@ -302,6 +305,7 @@
including <samp>`&<var>module</var>'</samp> in its definition.
</p><table><tr><td> </td><td><pre class="example"><var>mname</var> [
options ] <var>&module</var>…
</pre></td></tr></table>
+
<p>Then getting the module creates a subdirectory for each such
module, in the directory containing the module. For
example, if modules contains
@@ -323,6 +327,7 @@
ampermod/first-dir/file2
ampermod/first-dir/sdir/sfile
</pre></td></tr></table>
+
<p>There is one quirk/bug: the messages that <small>CVS</small>
prints omit the <tt>`ampermod'</tt>, and thus do not
correctly display the location to which it is checking
@@ -336,6 +341,7 @@
U first-dir/sdir/sfile
$
</pre></td></tr></table>
+
<p>Do not rely on this buggy behavior; it may get fixed in
a future release of <small>CVS</small>.
</p>
@@ -474,7 +480,6 @@
</tr></table>
<h3 class="appendixsubsec"> C.1.6 How the modules file “program
options” programs are run </h3>
-
<p>For checkout, rtag, and export, the program is server-based, and as such the
following applies:-
</p>
@@ -552,6 +557,7 @@
and value is a single-quote delimited value.
</pre></td></tr></table>
+
<p>For example, the following command imports a
directory, treating files whose name ends in
<samp>`.exe'</samp> as binary:
@@ -559,6 +565,7 @@
<table><tr><td> </td><td><pre class="example">cvs import -I ! -W
"*.exe -k 'b'" first-dir vendortag reltag
</pre></td></tr></table>
+
<hr size="6">
<a name="commit-files"></a>
<a name="SEC166"></a>
@@ -680,7 +687,6 @@
A file name or command-line template.
</li></ul>
-
<p>Blank lines are ignored. Lines that start with the
character <samp>`#'</samp> are treated as comments. Long lines
unfortunately can <em>not</em> be broken in two parts in
@@ -876,6 +882,7 @@
</p>
<table><tr><td> </td><td><pre class="example">BugId:
</pre></td></tr></table>
+
<p>The script <tt>`/usr/cvssupport/bugid.verify'</tt> is used to
evaluate the log message.
</p>
@@ -899,20 +906,24 @@
exit 1
fi
</pre></td></tr></table>
+
<p>The <tt>`verifymsg'</tt> file contains this line:
</p>
<table><tr><td> </td><td><pre class="example">^tc
/usr/cvssupport/bugid.verify
</pre></td></tr></table>
+
<p>The <tt>`rcsinfo'</tt> file contains this line:
</p>
<table><tr><td> </td><td><pre class="example">^tc
/usr/cvssupport/tc.template
</pre></td></tr></table>
+
<p>The <tt>`config'</tt> file contains this line:
</p>
<table><tr><td> </td><td><pre class="example">RereadLogAfterVerify=always
</pre></td></tr></table>
+
<hr size="6">
<a name="editinfo"></a>
<a name="SEC170"></a>
@@ -1023,6 +1034,7 @@
</p>
<table><tr><td> </td><td><pre class="example">BugId:
</pre></td></tr></table>
+
<p>The script <tt>`/usr/cvssupport/bugid.edit'</tt> is used to
edit the log message.
</p>
@@ -1045,14 +1057,17 @@
$CVSEDITOR $1
done
</pre></td></tr></table>
+
<p>The <tt>`editinfo'</tt> file contains this line:
</p>
<table><tr><td> </td><td><pre class="example">^tc
/usr/cvssupport/bugid.edit
</pre></td></tr></table>
+
<p>The <tt>`rcsinfo'</tt> file contains this line:
</p>
<table><tr><td> </td><td><pre class="example">^tc
/usr/cvssupport/tc.template
</pre></td></tr></table>
+
<hr size="6">
<a name="loginfo"></a>
<a name="SEC172"></a>
@@ -1138,6 +1153,7 @@
</p>
<table><tr><td> </td><td><pre class="example">"yoyodyne/tc
ChangeLog,1.1,1.2 Makefile,1.3,1.4 foo.c,1.12,1.13"
</pre></td></tr></table>
+
<p>As another example, <samp>`%{}'</samp> means that only the
name of the repository will be generated.
</p>
@@ -1184,6 +1200,7 @@
^CVSROOT /usr/local/bin/cvs-log /usr/adm/cvsroot-log
^prog1 Mail -s %s ceder
</pre></td></tr></table>
+
<p>The shell-script <tt>`/usr/local/bin/cvs-log'</tt> looks
like this:
</p>
@@ -1194,6 +1211,7 @@
echo;
cat) >> $1
</pre></td></tr></table>
+
<hr size="6">
<a name="Keeping-a-checked-out-copy"></a>
<a name="SEC174"></a>
@@ -1233,6 +1251,7 @@
<table><tr><td> </td><td><pre class="example">^cyclic-pages
(date; cat; (sleep 2; cd /u/www/local-docs;
cvs -q update -d) &) >> $CVSROOT/CVSROOT/updatelog 2>&1
</pre></td></tr></table>
+
<p>This will cause checkins to repository directories
starting with <code>cyclic-pages</code> to update the checked
out tree in <tt>`/u/www/local-docs'</tt>.
@@ -1353,6 +1372,7 @@
*.Z *.elc *.ln
core
</pre></td></tr></table>
+
</li><li>
The per-repository list in
<tt>`$CVSROOT/CVSROOT/cvsignore'</tt> is appended to
@@ -1434,12 +1454,14 @@
</p>
<table><tr><td> </td><td><pre class="example">ALL
$CVSROOT/CVSROOT/logcommit.pl
</pre></td></tr></table>
+
<p>To maintain <tt>`logcommit.pl'</tt> with <small>CVS</small> you would
add the following line to the <tt>`checkoutlist'</tt>
administrative file:
</p>
<table><tr><td> </td><td><pre class="example">logcommit.pl
</pre></td></tr></table>
+
<p>The format of <tt>`checkoutlist'</tt> is one line for each
file that you want to maintain using <small>CVS</small>, giving
the name of the file.
Index: texi2html/Tests/ccvs_res/cvs_2.html
diff -u texi2html/Tests/ccvs_res/cvs_2.html:1.24
texi2html/Tests/ccvs_res/cvs_2.html:1.25
--- texi2html/Tests/ccvs_res/cvs_2.html:1.24 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_2.html Sat Mar 25 13:26:47 2006
@@ -154,6 +154,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs -d /usr/local/cvsroot
checkout yoyodyne/tc
</pre></td></tr></table>
+
<a name="IDX13"></a>
<a name="IDX14"></a>
<a name="IDX15"></a>
@@ -175,6 +176,7 @@
<table><tr><td> </td><td><pre class="example">CVSROOT=/usr/local/cvsroot
export CVSROOT
</pre></td></tr></table>
+
<a name="IDX18"></a>
<a name="IDX19"></a>
<p> A repository specified with <code>-d</code> will
@@ -302,6 +304,7 @@
|
+--(other Yoyodyne software)
</pre></td></tr></table>
+
<p>With the directories are <em>history files</em> for each file
under version control. The name of the history file is
the name of the corresponding file with <samp>`,v'</samp>
@@ -327,6 +330,7 @@
+--<tt>testpgm.t,v</tt>
+--<tt>test2.t,v</tt>
</pre></td></tr></table>
+
<a name="IDX20"></a>
<a name="IDX21"></a>
<p>The history files contain, among other things, enough
@@ -898,6 +902,7 @@
</p>
<table><tr><td> </td><td><pre class="example">yoyodyne/tc
</pre></td></tr></table>
+
<p>If the particular working directory does not correspond
to a directory in the repository, then <tt>`Repository'</tt>
should contain <tt>`CVSROOT/Emptydir'</tt>.
@@ -1156,6 +1161,7 @@
diff gnu/diff
tc yoyodyne/tc
</pre></td></tr></table>
+
<p>The <tt>`modules'</tt> file is line oriented. In its
simplest form each line contains the name of the
module, whitespace, and the directory where the module
@@ -1248,6 +1254,7 @@
cvs -d server2:/root co sdir
cvs update
</pre></td></tr></table>
+
<p>The <code>cvs co</code> commands set up the working
directory, and then the <code>cvs update</code> command will
contact server2, to update the dir1/sdir subdirectory,
@@ -1313,6 +1320,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs -d /usr/local/cvsroot
init
</pre></td></tr></table>
+
<p><code>cvs init</code> is careful to never overwrite any
existing files in the repository, so no harm is done if
you run <code>cvs init</code> on an already set-up
@@ -1468,6 +1476,7 @@
</p>
<table><tr><td> </td><td><pre
class="example">[:<var>method</var>:][[<var>user</var>][:<var>password</var>address@hidden<var>hostname</var>[:[<var>port</var>]]/path/to/repository
</pre></td></tr></table>
+
<p>Specifying a password in the repository name is not recommended during
checkout, since this will cause <small>CVS</small> to store a cleartext copy
of the
password in each created directory. <code>cvs login</code> first instead
@@ -1612,6 +1621,7 @@
</p>
<table><tr><td> </td><td><pre class="example">rsh -l bach
faun.example.org 'echo $PATH'
</pre></td></tr></table>
+
<a name="IDX64"></a>
<p>Next you have to make sure that <code>rsh</code> will be able
to find the server. Make sure that the path which
@@ -1944,11 +1954,13 @@
<table><tr><td> </td><td><pre class="example">cvs auth required
pam_unix.so
cvs account required pam_unix.so
</pre></td></tr></table>
+
<p>The the equivalent <tt>`/etc/pam.d/cvs'</tt> would contain
</p>
<table><tr><td> </td><td><pre class="example">auth required
pam_unix.so
account required pam_unix.so
</pre></td></tr></table>
+
<p>Some systems require a full path to the module so that
<tt>`pam_unix.so'</tt> (Linux) would become something like
<tt>`/usr/lib/security/$ISA/pam_unix.so.1'</tt> (Sun Solaris).
@@ -2046,6 +2058,7 @@
<table><tr><td> </td><td><pre
class="example">CVSROOT=:pserver:address@hidden:2401/usr/local/cvsroot
cvs checkout someproj
</pre></td></tr></table>
+
<p>However, unless you're connecting to a public-access
repository (i.e., one where that username doesn't
require a password), you'll need to supply a password or <em>log in</em> first.
@@ -2062,6 +2075,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs -d
:pserver:bach:address@hidden:/usr/local/cvsroot login
</pre></td></tr></table>
+
<p>After you enter the password, <small>CVS</small> verifies it with
the server. If the verification succeeds, then that
combination of username, host, repository, and password
@@ -2239,6 +2253,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs -d
:gserver:faun.example.org:/usr/local/cvsroot checkout foo
</pre></td></tr></table>
+
<hr size="6">
<a name="Kerberos-authenticated"></a>
<a name="SEC34"></a>
@@ -2301,6 +2316,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs -d
:kserver:faun.example.org:/usr/local/cvsroot checkout foo
</pre></td></tr></table>
+
<p>Previous versions of <small>CVS</small> would fall back to a
connection via rsh; this version will not do so.
</p>
@@ -2348,6 +2364,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs -d
:fork:/usr/local/cvsroot checkout foo
</pre></td></tr></table>
+
<a name="IDX89"></a>
<p>As with <code>:ext:</code>, the server is called <samp>`cvs'</samp>
by default, or the value of the <code>CVS_SERVER</code>
Index: texi2html/Tests/ccvs_res/cvs_21.html
diff -u texi2html/Tests/ccvs_res/cvs_21.html:1.23
texi2html/Tests/ccvs_res/cvs_21.html:1.24
--- texi2html/Tests/ccvs_res/cvs_21.html:1.23 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_21.html Sat Mar 25 13:26:47 2006
@@ -142,7 +142,8 @@
</dd>
<dt> <code>cannot change permissions on temporary directory</code></dt>
<dd><table><tr><td> </td><td><pre class="example">Operation not permitted
-</pre></td></tr></table><p>This message has been happening in a
non-reproducible,
+</pre></td></tr></table>
+<p>This message has been happening in a non-reproducible,
occasional way when we run the client/server testsuite,
both on Red Hat Linux 3.0.3 and 4.1. We haven't been
able to figure out what causes it, nor is it known
@@ -318,6 +319,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs commit: Rebuilding
administrative file database
</pre></td></tr></table>
+
<p>If you see both messages, the database is being rebuilt
twice, which is unnecessary but harmless. If you wish
to avoid the duplication, and you have no versions of
@@ -439,7 +441,8 @@
</dd>
<dt> <code>Usage: diff3 [-exEX3 [-i | -m] [-L label1 -L label3]] file1
file2 file3</code></dt>
<dd><table><tr><td> </td><td><pre class="example">Only one of [exEX3]
allowed
-</pre></td></tr></table><p>This indicates a problem with the installation of
+</pre></td></tr></table>
+<p>This indicates a problem with the installation of
<code>diff3</code> and <code>rcsmerge</code>. Specifically
<code>rcsmerge</code> was compiled to look for GNU diff3, but
it is finding unix diff3 instead. The exact text of
@@ -482,6 +485,7 @@
vi $*
exit 0
</pre></td></tr></table>
+
</dd>
</dl>
@@ -561,6 +565,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs [pserver aborted]: bad
auth protocol start: foo
</pre></td></tr></table>
+
<p>If instead you get:
</p>
<table><tr><td> </td><td><pre class="example">Usage: cvs [cvs-options]
command [command-options-and-arguments]
@@ -590,6 +595,7 @@
</p>
<table><tr><td> </td><td><pre class="example">2401 stream tcp nowait
root /bin/echo echo hello
</pre></td></tr></table>
+
<p>After making that change and instructing inetd to
re-read its configuration file, "telnet servername
2401" should show you the text hello and then the
Index: texi2html/Tests/ccvs_res/cvs_22.html
diff -u texi2html/Tests/ccvs_res/cvs_22.html:1.18
texi2html/Tests/ccvs_res/cvs_22.html:1.19
--- texi2html/Tests/ccvs_res/cvs_22.html:1.18 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_22.html Sat Mar 25 13:26:47 2006
@@ -92,6 +92,7 @@
Dirk Koschuetzki <<tt>address@hidden</tt>>
and Michael Brown <<tt>address@hidden</tt>>.
</pre></td></tr></table>
+
<p>The list of contributors here is not comprehensive; for a more
complete list of who has contributed to this manual see
the file <tt>`doc/ChangeLog'</tt> in the <small>CVS</small> source
Index: texi2html/Tests/ccvs_res/cvs_23.html
diff -u texi2html/Tests/ccvs_res/cvs_23.html:1.20
texi2html/Tests/ccvs_res/cvs_23.html:1.21
--- texi2html/Tests/ccvs_res/cvs_23.html:1.20 Tue Aug 23 23:51:10 2005
+++ texi2html/Tests/ccvs_res/cvs_23.html Sat Mar 25 13:26:47 2006
@@ -89,6 +89,7 @@
http://ximbiot.com/
</pre></td></tr></table>
+
</li><li>
If you got <small>CVS</small> through a distributor, such as an
operating system vendor or a vendor of freeware
@@ -112,6 +113,7 @@
<table><tr><td> </td><td><pre class="example">http://www.cvshome.org
http://www.loria.fr/~molli/cvs-index.html
</pre></td></tr></table>
+
<p>If you are so inspired, increasing the information
available on the net is likely to be appreciated. For
example, before the standard <small>CVS</small> distribution
Index: texi2html/Tests/ccvs_res/cvs_3.html
diff -u texi2html/Tests/ccvs_res/cvs_3.html:1.23
texi2html/Tests/ccvs_res/cvs_3.html:1.24
--- texi2html/Tests/ccvs_res/cvs_3.html:1.23 Tue Aug 23 23:51:11 2005
+++ texi2html/Tests/ccvs_res/cvs_3.html Sat Mar 25 13:26:47 2006
@@ -144,6 +144,7 @@
<table><tr><td> </td><td><pre class="example">$ cd <var>wdir</var>
$ cvs import -m "Imported sources" yoyodyne/<var>rdir</var> yoyo
start
</pre></td></tr></table>
+
<p>Unless you supply a log message with the <samp>`-m'</samp>
flag, <small>CVS</small> starts an editor and prompts for a
message. The string <samp>`yoyo'</samp> is a <em>vendor tag</em>,
@@ -297,6 +298,7 @@
$ mkdir tc/man
$ mkdir tc/testing
</pre></td></tr></table>
+
<p>After that, you use the <code>import</code> command to create
the corresponding (empty) directory structure inside
the repository:
@@ -304,6 +306,7 @@
<table><tr><td> </td><td><pre class="example">$ cd tc
$ cvs import -m "Created directory structure"
yoyodyne/<var>dir</var> yoyo start
</pre></td></tr></table>
+
<p>Then, use <code>add</code> to add files (and new directories)
as they appear.
</p>
@@ -345,6 +348,7 @@
<table><tr><td> </td><td><pre class="example">$ cvs checkout
CVSROOT/modules
$ cd CVSROOT
</pre></td></tr></table>
+
</li><li>
Edit the file and insert a line that defines the module. See section <a
href="cvs_2.html#SEC20">The administrative files</a>, for an introduction. See
section <a href="cvs_18.html#SEC158">The modules file</a>, for a full
description of the modules file. You can use the
@@ -352,17 +356,20 @@
<table><tr><td> </td><td><pre class="example">tc yoyodyne/tc
</pre></td></tr></table>
+
</li><li>
Commit your changes to the modules file.
<table><tr><td> </td><td><pre class="example">$ cvs commit -m "Added
the tc module." modules
</pre></td></tr></table>
+
</li><li>
Release the modules module.
<table><tr><td> </td><td><pre class="example">$ cd ..
$ cvs release -d CVSROOT
-</pre></td></tr></table></li></ol>
+</pre></td></tr></table>
+</li></ol>
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
Index: texi2html/Tests/ccvs_res/cvs_4.html
diff -u texi2html/Tests/ccvs_res/cvs_4.html:1.22
texi2html/Tests/ccvs_res/cvs_4.html:1.23
--- texi2html/Tests/ccvs_res/cvs_4.html:1.22 Tue Aug 23 23:51:12 2005
+++ texi2html/Tests/ccvs_res/cvs_4.html Sat Mar 25 13:26:47 2006
@@ -127,6 +127,7 @@
! 1.1 !----! 1.2 !----! 1.3 !----! 1.4 !----! 1.5 !
+-----+ +-----+ +-----+ +-----+ +-----+
</pre></td></tr></table>
+
<p>It is also possible to end up with numbers containing
more than one period, for example <samp>`1.3.2.2'</samp>. Such
revisions represent revisions on branches
@@ -215,6 +216,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs commit -r 3.0
</pre></td></tr></table>
+
<p>Note that the number you specify with <samp>`-r'</samp> must be
larger than any existing revision number. That is, if
revision 3.0 exists, you cannot <samp>`cvs commit
@@ -264,6 +266,7 @@
rcsmap.c 5.2
rcsutil.c 5.10
</pre></td></tr></table>
+
<a name="IDX94"></a>
<a name="IDX95"></a>
<a name="IDX96"></a>
@@ -320,6 +323,7 @@
rel-0-4 (revision: 1.4)
</pre></td></tr></table>
+
<p>For a complete summary of the syntax of <code>cvs tag</code>,
including the various options, see <a href="cvs_17.html#SEC156">Quick
reference to CVS commands</a>.
</p>
@@ -373,6 +377,7 @@
\-1.5*- 1.5
1.6
</pre></td></tr></table>
+
<p>At some time in the past, the <code>*</code> versions were tagged.
You can think of the tag as a handle attached to the curve
drawn through the tagged revisions. When you pull on
@@ -392,6 +397,7 @@
1.4 1.4
1.5
</pre></td></tr></table>
+
<hr size="6">
<a name="Tagging-the-working-directory"></a>
<a name="SEC49"></a>
@@ -440,6 +446,7 @@
cvs tag: backend.c is locally modified
cvs [tag aborted]: correct the above errors first!
</pre></td></tr></table>
+
<hr size="6">
<a name="Tagging-by-date_002ftag"></a>
<a name="SEC50"></a>
@@ -499,6 +506,7 @@
</p>
<table><tr><td> </td><td><pre class="example">cvs tag -r 1.4 stable
backend.c
</pre></td></tr></table>
+
<hr size="6">
<a name="Modifying-tags"></a>
<a name="SEC51"></a>
@@ -531,7 +539,6 @@
place. Therefore, one might delete, move, or rename a
tag.
</p>
-
<p><strong>WARNING: the commands in this section are
dangerous; they permanently discard historical
information and it can be difficult or impossible to
@@ -559,7 +566,6 @@
of branch tags. In that case, any non-branch tags encountered will
trigger warnings and will not be deleted.
</p>
-
<p><strong>WARNING: Moving branch tags is very dangerous! If you think
you need the <code>-B</code> option, think again and ask your
<small>CVS</small>
administrator about it (if that isn't you). There is almost certainly
@@ -588,7 +594,6 @@
In that case, non-branch tags encountered with the given
name are ignored with a warning message.
</p>
-
<p><strong>WARNING: Moving branch tags is very dangerous! If you think you
need the <code>-B</code> option, think again and ask your <small>CVS</small>
administrator about it (if that isn't you). There is almost certainly
@@ -610,6 +615,7 @@
<table><tr><td> </td><td><pre class="example">cvs rtag -r old-name-0-4
rel-0-4 tc
cvs rtag -d old-name-0-4 tc
</pre></td></tr></table>
+
<hr size="6">
<a name="Tagging-add_002fremove"></a>
<a name="SEC52"></a>
@@ -713,6 +719,7 @@
Sticky Options: (none)
</pre></td></tr></table>
+
<a name="IDX116"></a>
<a name="IDX117"></a>
<a name="IDX118"></a>
@@ -756,6 +763,7 @@
***************
$
</pre></td></tr></table>
+
<p>However, this isn't the easiest way, if you are asking
how to undo a previous checkin (in this example, put
<tt>`file1'</tt> back to the way it was as of revision
Index: texi2html/Tests/ccvs_res/cvs_5.html
diff -u texi2html/Tests/ccvs_res/cvs_5.html:1.29
texi2html/Tests/ccvs_res/cvs_5.html:1.30
--- texi2html/Tests/ccvs_res/cvs_5.html:1.29 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/ccvs_res/cvs_5.html Sat Mar 25 13:26:47 2006
@@ -154,6 +154,7 @@
<table><tr><td> </td><td><pre class="example">$ cvs tag -b rel-1-0-patches
</pre></td></tr></table>
+
<p>This splits off a branch based on the current revisions
in the working copy, assigning that branch the name
<samp>`rel-1-0-patches'</samp>.
@@ -170,6 +171,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs rtag -b -r rel-1-0
rel-1-0-patches tc
</pre></td></tr></table>
+
<p><samp>`-r rel-1-0'</samp> says that this branch should be
rooted at the revision that
corresponds to the tag <samp>`rel-1-0'</samp>. It need not
@@ -220,6 +222,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs checkout -r
rel-1-0-patches tc
</pre></td></tr></table>
+
<p>Or, if you already have a working copy, you can switch
it to a given branch with <samp>`update -r'</samp>:
</p>
@@ -231,6 +234,7 @@
<table><tr><td> </td><td><pre class="example">$ cd tc
$ cvs update -r rel-1-0-patches
</pre></td></tr></table>
+
<p>It does not matter if the working copy was originally
on the main trunk or on some other branch – the above
command will switch it to the named branch. And
@@ -280,6 +284,7 @@
rel-0-4 (revision: 1.4)
</pre></td></tr></table>
+
<p>Don't be confused by the fact that the branch numbers
for each file are different (<samp>`1.7.2'</samp> and
<samp>`1.4.2'</samp> respectively). The branch tag is the
@@ -321,6 +326,7 @@
! 1.1 !----! 1.2 !----! 1.3 !----! 1.4 !----! 1.5 !
+-----+ +-----+ +-----+ +-----+ +-----+
</pre></td></tr></table>
+
<p>However, <small>CVS</small> is not limited to linear development. The
<em>revision tree</em> can be split into <em>branches</em>,
where each branch is a self-maintained line of
@@ -361,6 +367,7 @@
</pre></td></tr></table>
+
<p>The exact details of how the branch number is
constructed is not something you normally need to be
concerned about, but here is how it works: When
@@ -431,6 +438,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs admin
-NR4patches:1.4.2 numbers.c
</pre></td></tr></table>
+
<p>It only works if at least one revision is already
committed on the branch. Be very careful so that you
do not assign the tag to the wrong number. (There is
@@ -495,6 +503,7 @@
$ cvs commit -m "Included R1fix" # Create revision 1.5.
</pre></td></tr></table>
+
<p>A conflict can result from a merge operation. If that
happens, you should resolve it before committing the
new revision. See section <a href="cvs_10.html#SEC86">Conflicts example</a>.
@@ -509,6 +518,7 @@
<table><tr><td> </td><td><pre class="example">$ cvs checkout -j R1fix mod
$ cvs commit -m "Included R1fix"
</pre></td></tr></table>
+
<p>It should be noted that <code>update -j <var>tagname</var></code> will also
work but may
not produce the desired result. See section <a href="#SEC63">Merging can add
or remove files</a>, for more.
</p>
@@ -579,17 +589,20 @@
<table><tr><td> </td><td><pre class="example">cvs update -j 1.2.2.2 -j
R1fix m.c # Merge changes from 1.2.2.2 to the
# head of the R1fix branch
</pre></td></tr></table>
+
<p>The problem with this is that you need to specify the
1.2.2.2 revision manually. A slightly better approach
might be to use the date the last merge was done:
</p>
<table><tr><td> </td><td><pre class="example">cvs update -j
R1fix:yesterday -j R1fix m.c
</pre></td></tr></table>
+
<p>Better yet, tag the R1fix branch after every merge into
the trunk, and then use that tag for subsequent merges:
</p>
<table><tr><td> </td><td><pre class="example">cvs update -j
merged_from_R1fix_to_trunk -j R1fix m.c
</pre></td></tr></table>
+
<hr size="6">
<a name="Merging-two-revisions"></a>
<a name="SEC62"></a>
@@ -649,6 +662,7 @@
done
$
</pre></td></tr></table>
+
<hr size="6">
<a name="Merging-adds-and-removals"></a>
<a name="SEC63"></a>
@@ -686,6 +700,7 @@
cvs update -A
cvs update -jbranchtag
</pre></td></tr></table>
+
<p>After these commands are executed and a <samp>`cvs commit'</samp> is done,
file <tt>`a'</tt> will be removed and file <tt>`d'</tt> added in the main
branch.
</p>
@@ -766,6 +781,7 @@
>>>>>>> 1.1.2.1
. . .
</pre></td></tr></table>
+
<p>What happened was that the merge tried to merge the
differences between 1.1 and 1.1.2.1 into your working
directory. So, since the keyword changed from
@@ -789,6 +805,7 @@
key $<i></i>Revision$
. . .
</pre></td></tr></table>
+
<p>What is going on here is that revision 1.1 and 1.1.2.1
both expand as plain <code>Revision</code>, and therefore
merging the changes between them into the working
Index: texi2html/Tests/ccvs_res/cvs_6.html
diff -u texi2html/Tests/ccvs_res/cvs_6.html:1.22
texi2html/Tests/ccvs_res/cvs_6.html:1.23
--- texi2html/Tests/ccvs_res/cvs_6.html:1.22 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/ccvs_res/cvs_6.html Sat Mar 25 13:26:47 2006
@@ -99,6 +99,7 @@
<table><tr><td> </td><td><pre class="example">cvs update
testing/testpgm.t testing/test2.t
</pre></td></tr></table>
+
</li><li>
<samp>`cvs update testing man'</samp> updates all files in the
subdirectories
@@ -122,6 +123,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ cvs update -l #
Don't update files in subdirectories
</pre></td></tr></table>
+
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="cvs_5.html#SEC54"
title="Beginning of this chapter or previous chapter"> << </a>]</td>
Index: texi2html/Tests/ccvs_res/cvs_7.html
diff -u texi2html/Tests/ccvs_res/cvs_7.html:1.24
texi2html/Tests/ccvs_res/cvs_7.html:1.25
--- texi2html/Tests/ccvs_res/cvs_7.html:1.24 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/ccvs_res/cvs_7.html Sat Mar 25 13:26:47 2006
@@ -130,6 +130,7 @@
<table><tr><td> </td><td><pre class="example">$ cd foo
$ cvs add bar
</pre></td></tr></table>
+
<a name="IDX129"></a>
<dl>
<dt><u>Command:</u> <b>cvs add</b><i> [<code>-k</code> kflag] [<code>-m</code>
message] files …</i>
@@ -171,6 +172,7 @@
<table><tr><td> </td><td><pre class="example">$ cvs add backend.c
$ cvs commit -m "Early version. Not yet compilable." backend.c
</pre></td></tr></table>
+
<p>When you add a file it is added only on the branch
which you are working on (see section <a href="cvs_5.html#SEC54">Branching and
merging</a>). You can
later merge the additions to another branch if you want
@@ -261,6 +263,7 @@
cvs commit: Examining .
cvs commit: Committing .
</pre></td></tr></table>
+
<p>As a convenience you can remove the file and <code>cvs
remove</code> it in one step, by specifying the <samp>`-f'</samp>
option. For example, the above example could also be
@@ -275,6 +278,7 @@
cvs commit: Examining .
cvs commit: Committing .
</pre></td></tr></table>
+
<p>If you execute <code>remove</code> for a file, and then
change your mind before you commit, you can undo the
<code>remove</code> with an <code>add</code> command.
@@ -290,6 +294,7 @@
U oj.c
cvs add: oj.c, version 1.1.1.1, resurrected
</pre></td></tr></table>
+
<p>If you realize your mistake before you run the
<code>remove</code> command you can use <code>update</code> to
resurrect the file:
@@ -299,6 +304,7 @@
cvs update: warning: oj.c was lost
U oj.c
</pre></td></tr></table>
+
<p>When you remove a file it is removed only on the branch
which you are working on (see section <a href="cvs_5.html#SEC54">Branching and
merging</a>). You can
later merge the removals to another branch if you want
@@ -421,6 +427,7 @@
$ cvs add <var>new</var>
$ cvs commit -m "Renamed <var>old</var> to <var>new</var>"
<var>old</var> <var>new</var>
</pre></td></tr></table>
+
<p>This is the simplest way to move a file, it is not
error-prone, and it preserves the history of what was
done. Note that to access the history of the file you
@@ -473,7 +480,6 @@
The revision numbers are not affected.
</li></ul>
-
<p>Disadvantages:
</p>
<ul>
@@ -530,10 +536,10 @@
$ cvs tag -d <var>tag2</var> <var>new</var>
…
</pre></td></tr></table>
+
<p>By removing the tags you will be able to check out old
revisions.
</p>
-
<p>Advantages:
</p>
<ul>
@@ -549,7 +555,6 @@
The revision numbers are not affected.
</li></ul>
-
<p>Disadvantages:
</p>
<ul>
@@ -601,6 +606,7 @@
<table><tr><td> </td><td><pre class="example">$ cd
$CVSROOT/<var>parent-dir</var>
$ mv <var>old-dir</var> <var>new-dir</var>
</pre></td></tr></table>
+
</li><li>
Fix the <small>CVS</small> administrative files, if necessary (for
instance if you renamed an entire module).
Index: texi2html/Tests/ccvs_res/cvs_8.html
diff -u texi2html/Tests/ccvs_res/cvs_8.html:1.21
texi2html/Tests/ccvs_res/cvs_8.html:1.22
--- texi2html/Tests/ccvs_res/cvs_8.html:1.21 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/ccvs_res/cvs_8.html Sat Mar 25 13:26:47 2006
@@ -197,6 +197,7 @@
<table><tr><td> </td><td><pre class="example">#!/bin/sh
echo "$@" >>/home/kingdon/cvsroot/CVSROOT/taglog
</pre></td></tr></table>
+
<hr size="6">
<a name="annotate"></a>
<a name="SEC79"></a>
@@ -232,6 +233,7 @@
1.1 (mary 27-Mar-96): ssfile line 1
1.2 (joe 28-Mar-96): ssfile line 2
</pre></td></tr></table>
+
<p>The file <tt>`ssfile'</tt> currently contains two lines.
The <code>ssfile line 1</code> line was checked in by
<code>mary</code> on March 27. Then, on March 28, <code>joe</code>
Index: texi2html/Tests/ccvs_res/cvs_9.html
diff -u texi2html/Tests/ccvs_res/cvs_9.html:1.27
texi2html/Tests/ccvs_res/cvs_9.html:1.28
--- texi2html/Tests/ccvs_res/cvs_9.html:1.27 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/ccvs_res/cvs_9.html Sat Mar 25 13:26:47 2006
@@ -190,6 +190,7 @@
$ cvs add -kb -m"A test file" kotest
$ cvs ci -m"First checkin; contains a keyword" kotest
</pre></td></tr></table>
+
<p>If a file accidentally gets added without <samp>`-kb'</samp>,
one can use the <code>cvs admin</code> command to recover.
For example:
@@ -203,6 +204,7 @@
# Copy in a good copy of the file from outside CVS
$ cvs commit -m "make it binary" kotest
</pre></td></tr></table>
+
<p>When you check in the file <tt>`kotest'</tt> the file is
not preserved as a binary file, because you did not
check it in as a binary file. The <code>cvs
Index: texi2html/Tests/floats_res/float.html
diff -u texi2html/Tests/floats_res/float.html:1.7
texi2html/Tests/floats_res/float.html:1.8
--- texi2html/Tests/floats_res/float.html:1.7 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/floats_res/float.html Sat Mar 25 13:26:47 2006
@@ -85,6 +85,7 @@
An example.
</p><table><tr><td> </td><td><pre class="example">example
</pre></td></tr></table>
+
<p>An index entry
<a name="IDX1"></a>
</p>
@@ -124,6 +125,7 @@
An example.
</strong> </p><table><tr><td> </td><td><pre
class="example"><strong>example
</strong> </pre></td></tr></table>
+
<p><strong>A table.
</strong> </p><dl compact="compact">
<dt> <em>truc</em> </dt>
Index:
texi2html/Tests/formatting_res/_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e.html
diff -u
texi2html/Tests/formatting_res/_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e.html:1.4
texi2html/Tests/formatting_res/_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e.html:1.5
---
texi2html/Tests/formatting_res/_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e.html:1.4
Tue Aug 9 17:19:22 2005
+++
texi2html/Tests/formatting_res/_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e.html
Sat Mar 25 13:26:47 2006
@@ -61,6 +61,7 @@
<h3 class="node"> !_"#$%&'()*+-./;<=>?[\]^_`|~ </h3>
<table><tr><td> </td><td><pre class="example">id:
_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/formatting_res/chapter_test_refs.html
diff -u texi2html/Tests/formatting_res/chapter_test_refs.html:1.6
texi2html/Tests/formatting_res/chapter_test_refs.html:1.7
--- texi2html/Tests/formatting_res/chapter_test_refs.html:1.6 Tue Aug 9
17:19:22 2005
+++ texi2html/Tests/formatting_res/chapter_test_refs.html Sat Mar 25
13:26:47 2006
@@ -61,14 +61,17 @@
</p><table><tr><td> </td><td><pre class="example">mono :
manual.html#a-node
split: ../manual/a-node.html#a-node
</pre></td></tr></table>
+
<p><tt>:</tt> <a href="../manual/_003a.html#g_t_003a">(manual):</a>
</p><table><tr><td> </td><td><pre class="example">mono : manual.html#_003a
split: ../manual/_003a.html#_003a
</pre></td></tr></table>
+
<p><tt>Top</tt> <a href="../manual/index.html#Top">(manual)top</a><br>
</p><table><tr><td> </td><td><pre class="example">mono : manual.html#Top
split: ../manual/index.html#Top
</pre></td></tr></table>
+
<a name="SEC2"></a>
<h3 class="subheading"> Testing manual name </h3>
@@ -76,18 +79,22 @@
</p><table><tr><td> </td><td><pre class="example">mono : doc.html#node
split: ../doc/node.html#node
</pre></td></tr></table>
+
<a name="SEC3"></a>
<h3 class="subheading"> Testing local nodes </h3>
<p><tt>!_"#$%&'()*+-./;<=>?[\]^_`|~</tt> <a
href="chapter_test_refs_1.html#g_t_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e">!_"#$%&'()*+-./;<=>?[\]^_`|~</a><br>
</p><table><tr><td> </td><td><pre class="example">target:
#_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e
</pre></td></tr></table>
+
<p><tt>Top</tt> <a href="#SEC_Top">Test refs</a>
</p><table><tr><td> </td><td><pre class="example">target: #Top
</pre></td></tr></table>
+
<p><tt> local node</tt> <a href="chapter_test_refs_1.html#local-node">local
node</a>
</p><table><tr><td> </td><td><pre class="example">target: #local-node
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#SEC_Top" title="Cover (top) of
document">Top</a>]</td>
Index: texi2html/Tests/formatting_res/chapter_test_refs_1.html
diff -u texi2html/Tests/formatting_res/chapter_test_refs_1.html:1.5
texi2html/Tests/formatting_res/chapter_test_refs_1.html:1.6
--- texi2html/Tests/formatting_res/chapter_test_refs_1.html:1.5 Tue Aug 9
17:19:22 2005
+++ texi2html/Tests/formatting_res/chapter_test_refs_1.html Sat Mar 25
13:26:47 2006
@@ -62,9 +62,11 @@
<table><tr><td> </td><td><pre class="example">id: other-nodes
</pre></td></tr></table>
+
<p><tt>Top</tt> <a href="chapter_test_refs.html#SEC_Top">Test refs</a>
</p><table><tr><td> </td><td><pre class="example">target: #Top
</pre></td></tr></table>
+
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top"><a
href="#g_t_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e">•
!_"#$%&'()*+-./;<=>?[\]^_`|~</a></td><td> </td><td
align="left" valign="top">
</td></tr>
@@ -75,9 +77,11 @@
<a
name="g_t_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e"></a>
<table><tr><td> </td><td><pre class="example">id:
_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e
</pre></td></tr></table>
+
<a name="local-node"></a>
<table><tr><td> </td><td><pre class="example">id: local-node
</pre></td></tr></table>
+
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[ << ]</td>
Index: texi2html/Tests/formatting_res/clean.html
diff -u texi2html/Tests/formatting_res/clean.html:1.15
texi2html/Tests/formatting_res/clean.html:1.16
--- texi2html/Tests/formatting_res/clean.html:1.15 Mon Nov 14 11:13:58 2005
+++ texi2html/Tests/formatting_res/clean.html Sat Mar 25 13:26:47 2006
@@ -610,20 +610,28 @@
<table><tr><td> </td><td><pre class="example">e--xample some
text
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallexample">s--mallexample
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="display">d--isplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="lisp">l--isp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalllisp">s--malllisp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="format">f--ormat
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallformat">s--mallformat
</pre></td></tr></table>
+
<dl>
<dt><u>c–ategory:</u> <b>d–effn_name</b><i> a–rguments...</i>
<a name="IDX5"></a>
@@ -1029,20 +1037,28 @@
<table><tr><td> </td><td><pre class="example">e--xample some
text
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallexample">s--mallexample
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="display">d--isplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="lisp">l--isp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalllisp">s--malllisp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="format">f--ormat
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallformat">s--mallformat
</pre></td></tr></table>
+
<dl>
<dt><u>c–ategory:</u> <b>d–effn_name</b><i> a–rguments...</i>
<a name="IDX31"></a>
@@ -1448,21 +1464,29 @@
<pre class="example">
</pre><table><tr><td> </td><td><pre class="example">e--xample some
text
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smallexample">s--mallexample
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="display">d--isplay
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="lisp">l--isp
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smalllisp">s--malllisp
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="format">f--ormat
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smallformat">s--mallformat
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><dl>
<dt><u>c–ategory:</u> <b>d–effn_name</b><i> a–rguments...</i>
<a name="IDX57"></a></dt>
@@ -1666,6 +1690,7 @@
This is a very simple texi manual.
</pre>
</td></tr></table>
+
<a name="IDX79"></a>
<a name="IDX80"></a>
<a name="IDX81"></a>
@@ -1962,6 +1987,7 @@
</pre></th></tr></table>
</td></tr></table>
+
<hr size="6">
<a name="s_002d_002dection"></a>
<a name="SEC2"></a>
Index: texi2html/Tests/formatting_res/comments.html
diff -u texi2html/Tests/formatting_res/comments.html:1.20
texi2html/Tests/formatting_res/comments.html:1.21
--- texi2html/Tests/formatting_res/comments.html:1.20 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/formatting_res/comments.html Sat Mar 25 13:26:47 2006
@@ -56,11 +56,14 @@
<p>Comment at the end of the line </p>
<p>Example with comments 2 lines
</p><table><tr><td> </td><td><pre class="example">line second line
</pre></td></tr></table>
+
<p>Example with comments 1 line
</p><table><tr><td> </td><td><pre class="example">line
</pre></td></tr></table>
+
<p>No comments
</p><table><tr><td> </td><td><pre class="example">line
</pre></td></tr></table>
+
<p>The same but with oddfooting instead of comment:
Text line followed by a comment on the same line and another below Text line
after the comment followed by a comment Text line after the text line followed
by the comment.
</p>
@@ -85,6 +88,7 @@
</p>
<table><tr><td> </td><td><pre class="example"><code>example</code>
</pre></td></tr></table>
+
<a name="SEC2"></a>
<h3 class="subheading"> ignore arg </h3>
@@ -115,7 +119,6 @@
<p>@page @noindent @refill something
</p>
<p>noindent at beginning of line
-
noindent on the preceding line
noindent after space at beginning of line
page at beginning of line
Index: texi2html/Tests/formatting_res/comments_redefined.html
diff -u texi2html/Tests/formatting_res/comments_redefined.html:1.1
texi2html/Tests/formatting_res/comments_redefined.html:1.2
--- texi2html/Tests/formatting_res/comments_redefined.html:1.1 Mon Nov 14
11:13:58 2005
+++ texi2html/Tests/formatting_res/comments_redefined.html Sat Mar 25
13:26:47 2006
@@ -56,11 +56,14 @@
<p>Comment at the end of the line </p>
<p>Example with comments 2 lines
</p><table><tr><td> </td><td><pre class="example">line second line
</pre></td></tr></table>
+
<p>Example with comments 1 line
</p><table><tr><td> </td><td><pre class="example">line
</pre></td></tr></table>
+
<p>No comments
</p><table><tr><td> </td><td><pre class="example">line
</pre></td></tr></table>
+
<p>The same but with oddfooting instead of comment:
Text line followed by a comment on the same line and another below Text line
after the comment followed by a comment Text line after the text line followed
by the comment.
</p>
@@ -89,6 +92,7 @@
</p>
<table><tr><td> </td><td><pre class="example"><code>example</code>
</pre></td></tr></table>
+
<a name="SEC2"></a>
<h3 class="subheading"> ignore arg </h3>
@@ -119,7 +123,6 @@
<p>@page @noindent @refill something
</p>
<p>noindent at beginning of line
-
noindent on the preceding line
noindent after space at beginning of line
page at beginning of line
Index: texi2html/Tests/formatting_res/complex_command_in_simple_command.html
diff -u
texi2html/Tests/formatting_res/complex_command_in_simple_command.html:1.7
texi2html/Tests/formatting_res/complex_command_in_simple_command.html:1.8
--- texi2html/Tests/formatting_res/complex_command_in_simple_command.html:1.7
Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/formatting_res/complex_command_in_simple_command.html
Sat Mar 25 13:26:47 2006
@@ -73,6 +73,7 @@
</p>
<table><tr><td> </td><td><pre class="example">Example
</pre></td></tr></table>
+
<p>After example
</p>
<p>defun
@@ -144,6 +145,7 @@
</samp> </p>
<table><tr><td> </td><td><pre class="example"><samp>Example
</samp> </pre></td></tr></table>
+
<p><samp>After example
</samp> </p>
<p><samp>defun
@@ -215,6 +217,7 @@
</b> </p>
<table><tr><td> </td><td><pre class="example"><b>Example
</b> </pre></td></tr></table>
+
<p><b>After example
</b> </p>
<p><b>defun
@@ -285,6 +288,7 @@
</code> </p>
<table><tr><td> </td><td><pre class="example"><code>Example
</code> </pre></td></tr></table>
+
<p><code>After example
</code> </p>
<p><code>defun
Index: texi2html/Tests/formatting_res/exotic_formatting.html
diff -u texi2html/Tests/formatting_res/exotic_formatting.html:1.48
texi2html/Tests/formatting_res/exotic_formatting.html:1.49
--- texi2html/Tests/formatting_res/exotic_formatting.html:1.48 Mon Nov 14
11:13:58 2005
+++ texi2html/Tests/formatting_res/exotic_formatting.html Sat Mar 25
13:26:47 2006
@@ -681,20 +681,28 @@
<table><tr><td> </td><td><pre class="example">e--xample some
text
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallexample">s--mallexample
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="display">d--isplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="lisp">l--isp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalllisp">s--malllisp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="format">f--ormat
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallformat">s--mallformat
</pre></td></tr></table>
+
<table width="100%">
<tr>
<td align="left"> <b>d–effn_name</b><i> a–rguments...</i>
@@ -1353,21 +1361,29 @@
<pre class="example">
</pre><table><tr><td> </td><td><pre class="example">e--xample some
text
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smallexample">s--mallexample
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="display">d--isplay
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="lisp">l--isp
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smalllisp">s--malllisp
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="format">f--ormat
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smallformat">s--mallformat
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table width="100%">
<tr>
<td align="left"> <b>d–effn_name</b><i> a–rguments...</i>
@@ -1786,6 +1802,7 @@
This is a very simple texi manual.
</pre>
</td></tr></table>
+
<a name="IDX89"></a>
<a name="IDX90"></a>
<a name="IDX91"></a>
Index: texi2html/Tests/formatting_res/exotic_formatting_1.html
diff -u texi2html/Tests/formatting_res/exotic_formatting_1.html:1.30
texi2html/Tests/formatting_res/exotic_formatting_1.html:1.31
--- texi2html/Tests/formatting_res/exotic_formatting_1.html:1.30 Mon Nov
14 11:13:58 2005
+++ texi2html/Tests/formatting_res/exotic_formatting_1.html Sat Mar 25
13:26:47 2006
@@ -490,6 +490,7 @@
</pre></th></tr></table>
</td></tr></table>
+
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="exotic_formatting.html#SEC_Top"
title="Previous section in reading order"> < </a>]</td>
Index: texi2html/Tests/formatting_res/formats_not_closed.html
diff -u texi2html/Tests/formatting_res/formats_not_closed.html:1.17
texi2html/Tests/formatting_res/formats_not_closed.html:1.18
--- texi2html/Tests/formatting_res/formats_not_closed.html:1.17 Tue Aug 23
23:51:13 2005
+++ texi2html/Tests/formatting_res/formats_not_closed.html Sat Mar 25
13:26:47 2006
@@ -74,6 +74,7 @@
</dl>
</td></tr></table>
+
<a name="SEC1"></a>
<h2 class="section"> 1. a section </h2>
Index: texi2html/Tests/formatting_res/formatting.html
diff -u texi2html/Tests/formatting_res/formatting.html:1.48
texi2html/Tests/formatting_res/formatting.html:1.49
--- texi2html/Tests/formatting_res/formatting.html:1.48 Mon Nov 14 11:13:58 2005
+++ texi2html/Tests/formatting_res/formatting.html Sat Mar 25 13:26:47 2006
@@ -681,20 +681,28 @@
<table><tr><td> </td><td><pre class="example">e--xample some
text
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallexample">s--mallexample
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="display">d--isplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="lisp">l--isp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalllisp">s--malllisp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="format">f--ormat
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallformat">s--mallformat
</pre></td></tr></table>
+
<dl>
<dt><u>c–ategory:</u> <b>d–effn_name</b><i> a–rguments...</i>
<a name="IDX5"></a>
@@ -1218,21 +1226,29 @@
<pre class="example">
</pre><table><tr><td> </td><td><pre class="example">e--xample some
text
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smallexample">s--mallexample
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="display">d--isplay
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="lisp">l--isp
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smalllisp">s--malllisp
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="format">f--ormat
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smallformat">s--mallformat
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><dl>
<dt><u>c–ategory:</u> <b>d–effn_name</b><i> a–rguments...</i>
<a name="IDX49"></a></dt>
@@ -1516,6 +1532,7 @@
This is a very simple texi manual.
</pre>
</td></tr></table>
+
<a name="IDX89"></a>
<a name="IDX90"></a>
<a name="IDX91"></a>
@@ -1867,6 +1884,7 @@
</pre></th></tr></table>
</td></tr></table>
+
<hr size="6">
<a name="s_002d_002dect_002cion"></a>
<a name="SEC2"></a>
Index: texi2html/Tests/formatting_res/fr_formatting.html
diff -u texi2html/Tests/formatting_res/fr_formatting.html:1.41
texi2html/Tests/formatting_res/fr_formatting.html:1.42
--- texi2html/Tests/formatting_res/fr_formatting.html:1.41 Mon Nov 14
11:13:58 2005
+++ texi2html/Tests/formatting_res/fr_formatting.html Sat Mar 25 13:26:47 2006
@@ -681,20 +681,28 @@
<table><tr><td> </td><td><pre class="example">e--xample some
text
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallexample">s--mallexample
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="display">d--isplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="lisp">l--isp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalllisp">s--malllisp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="format">f--ormat
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallformat">s--mallformat
</pre></td></tr></table>
+
<dl>
<dt><u>c–ategory:</u> <b>d–effn_name</b><i> a–rguments...</i>
<a name="IDX5"></a>
@@ -1218,21 +1226,29 @@
<pre class="example">
</pre><table><tr><td> </td><td><pre class="example">e--xample some
text
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smallexample">s--mallexample
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="display">d--isplay
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="lisp">l--isp
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smalllisp">s--malllisp
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="format">f--ormat
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smallformat">s--mallformat
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><dl>
<dt><u>c–ategory:</u> <b>d–effn_name</b><i> a–rguments...</i>
<a name="IDX49"></a></dt>
@@ -1516,6 +1532,7 @@
This is a very simple texi manual.
</pre>
</td></tr></table>
+
<a name="IDX89"></a>
<a name="IDX90"></a>
<a name="IDX91"></a>
@@ -1867,6 +1884,7 @@
</pre></th></tr></table>
</td></tr></table>
+
<hr size="6">
<a name="s_002d_002dect_002cion"></a>
<a name="SEC2"></a>
Index: texi2html/Tests/formatting_res/icons_fr_formatting.html
diff -u texi2html/Tests/formatting_res/icons_fr_formatting.html:1.3
texi2html/Tests/formatting_res/icons_fr_formatting.html:1.4
--- texi2html/Tests/formatting_res/icons_fr_formatting.html:1.3 Mon Nov 14
11:13:58 2005
+++ texi2html/Tests/formatting_res/icons_fr_formatting.html Sat Mar 25
13:26:47 2006
@@ -681,20 +681,28 @@
<table><tr><td> </td><td><pre class="example">e--xample some
text
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallexample">s--mallexample
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="display">d--isplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="lisp">l--isp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smalllisp">s--malllisp
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="format">f--ormat
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="smallformat">s--mallformat
</pre></td></tr></table>
+
<dl>
<dt><u>c–ategory:</u> <b>d–effn_name</b><i> a–rguments...</i>
<a name="IDX5"></a>
@@ -1218,21 +1226,29 @@
<pre class="example">
</pre><table><tr><td> </td><td><pre class="example">e--xample some
text
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smallexample">s--mallexample
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="display">d--isplay
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smalldisplay">s--malldisplay
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="lisp">l--isp
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smalllisp">s--malllisp
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="format">f--ormat
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><table><tr><td> </td><td><pre class="smallformat">s--mallformat
-</pre></td></tr></table><pre class="example">
+</pre></td></tr></table>
+<pre class="example">
</pre><dl>
<dt><u>c–ategory:</u> <b>d–effn_name</b><i> a–rguments...</i>
<a name="IDX49"></a></dt>
@@ -1516,6 +1532,7 @@
This is a very simple texi manual.
</pre>
</td></tr></table>
+
<a name="IDX89"></a>
<a name="IDX90"></a>
<a name="IDX91"></a>
@@ -1867,6 +1884,7 @@
</pre></th></tr></table>
</td></tr></table>
+
<hr size="6">
<a name="s_002d_002dect_002cion"></a>
<a name="SEC2"></a>
Index: texi2html/Tests/formatting_res/imbrications.html
diff -u texi2html/Tests/formatting_res/imbrications.html:1.29
texi2html/Tests/formatting_res/imbrications.html:1.30
--- texi2html/Tests/formatting_res/imbrications.html:1.29 Tue Aug 23
23:51:13 2005
+++ texi2html/Tests/formatting_res/imbrications.html Sat Mar 25 13:26:47 2006
@@ -162,7 +162,8 @@
<dt> <em>line</em></dt>
<dd><p><code>in code and table
</code> </p><table><tr><td> </td><td><pre class="example"><code> in
example
-</code> </pre></td></tr></table></dd>
+</code> </pre></td></tr></table>
+</dd>
</dl>
<p><code></code>
</p>
@@ -174,6 +175,7 @@
<table><tr><td> </td><td><pre class="example">
an example
</pre></td></tr></table>
+
<a name="IDX2"></a>
<table><tr><td> </td><td><pre class="example">
@@ -220,7 +222,8 @@
and now yes---now and ``so''.
-</pre></td></tr></table><p>after example and now yes—now and
“so”.
+</pre></td></tr></table>
+<p>after example and now yes—now and “so”.
</p>
<p align="right">is the text
flushed right ?
@@ -231,14 +234,19 @@
it should be flushed
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="example">example and then text
flushed right
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="display">simple displayed text
</pre></td></tr></table>
+
<p>a display within example
</p><table><tr><td> </td><td><pre class="example">example
</pre><table><tr><td> </td><td><pre class="display">display
-</pre></td></tr></table></td></tr></table>
+</pre></td></tr></table>
+</td></tr></table>
+
<table class="cartouche" border="1"><tr><td>
<p>A cartouched text
</p></td></tr></table>
@@ -249,6 +257,7 @@
<pre class="example">A cartouched text
</pre></td></tr></table>
</td></tr></table>
+
<table><tr><td> </td><td><pre class="example">a table within example
</pre><dl compact="compact">
<dt>•<tt> item
@@ -298,6 +307,7 @@
</pre></li></ol>
<pre class="example">
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="example">deffs
</pre><dl>
<dt><u>Function:</u> <b>my def</b><i> args <var>arg</var> …</i>
@@ -333,6 +343,7 @@
</dd></dl>
<pre class="example">
</pre></td></tr></table>
+
<hr size="6">
<a name="node-menu"></a>
<a name="SEC4"></a>
Index: texi2html/Tests/formatting_res/index.html
diff -u texi2html/Tests/formatting_res/index.html:1.4
texi2html/Tests/formatting_res/index.html:1.5
--- texi2html/Tests/formatting_res/index.html:1.4 Tue Aug 9 17:19:22 2005
+++ texi2html/Tests/formatting_res/index.html Sat Mar 25 13:26:47 2006
@@ -62,14 +62,17 @@
</p><table><tr><td> </td><td><pre class="example">mono :
manual.html#a-node
split: ../manual/a-node.html#a-node
</pre></td></tr></table>
+
<p><tt>:</tt> <a href="../manual/_003a.html#g_t_003a">(manual):</a>
</p><table><tr><td> </td><td><pre class="example">mono : manual.html#_003a
split: ../manual/_003a.html#_003a
</pre></td></tr></table>
+
<p><tt>Top</tt> <a href="../manual/index.html#Top">(manual)top</a><br>
</p><table><tr><td> </td><td><pre class="example">mono : manual.html#Top
split: ../manual/index.html#Top
</pre></td></tr></table>
+
<a name="SEC2"></a>
<h3 class="subheading"> Testing manual name </h3>
@@ -77,18 +80,22 @@
</p><table><tr><td> </td><td><pre class="example">mono : doc.html#node
split: ../doc/node.html#node
</pre></td></tr></table>
+
<a name="SEC3"></a>
<h3 class="subheading"> Testing local nodes </h3>
<p><tt>!_"#$%&'()*+-./;<=>?[\]^_`|~</tt> <a
href="_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e.html#g_t_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e">!_"#$%&'()*+-./;<=>?[\]^_`|~</a><br>
</p><table><tr><td> </td><td><pre class="example">target:
#_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e
</pre></td></tr></table>
+
<p><tt>Top</tt> <a href="#SEC_Top">Test refs</a>
</p><table><tr><td> </td><td><pre class="example">target: #Top
</pre></td></tr></table>
+
<p><tt> local node</tt> <a href="local-node.html#local-node">local node</a>
</p><table><tr><td> </td><td><pre class="example">target: #local-node
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#SEC_Top" title="Cover (top) of
document">Top</a>]</td>
Index: texi2html/Tests/formatting_res/local-node.html
diff -u texi2html/Tests/formatting_res/local-node.html:1.4
texi2html/Tests/formatting_res/local-node.html:1.5
--- texi2html/Tests/formatting_res/local-node.html:1.4 Tue Aug 9 17:19:22 2005
+++ texi2html/Tests/formatting_res/local-node.html Sat Mar 25 13:26:47 2006
@@ -61,6 +61,7 @@
<h3 class="node"> local node </h3>
<table><tr><td> </td><td><pre class="example">id: local-node
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/formatting_res/menus.html
diff -u texi2html/Tests/formatting_res/menus.html:1.3
texi2html/Tests/formatting_res/menus.html:1.4
--- texi2html/Tests/formatting_res/menus.html:1.3 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/formatting_res/menus.html Sat Mar 25 13:26:47 2006
@@ -133,6 +133,7 @@
</pre></th></tr></table>
</td></tr></table>
+
<hr size="6">
<a name="s_002d_002dect_002cion"></a>
<a name="SEC2"></a>
@@ -185,7 +186,8 @@
Menu comment
<a href="manual.html#other-manual-node">• a description:(manual) other
manual node</a>. Chapter 2
-</pre></td></tr></table></table>
+</pre></td></tr></table>
+</table>
<p><a name="anchor"></a>
</p>
Index: texi2html/Tests/formatting_res/menus_simple.html
diff -u texi2html/Tests/formatting_res/menus_simple.html:1.3
texi2html/Tests/formatting_res/menus_simple.html:1.4
--- texi2html/Tests/formatting_res/menus_simple.html:1.3 Tue Aug 23
23:51:13 2005
+++ texi2html/Tests/formatting_res/menus_simple.html Sat Mar 25 13:26:47 2006
@@ -116,6 +116,7 @@
</pre></td></tr></table>
+
<hr size="6">
<a name="s_002d_002dect_002cion"></a>
<a name="SEC2"></a>
@@ -165,6 +166,7 @@
<a href="manual.html#other-manual-node">• a description:(manual) other
manual node</a>. Chapter 2
</pre></td></tr></table>
+
<p><a name="anchor"></a>
</p>
<hr size="6">
Index: texi2html/Tests/formatting_res/other-nodes.html
diff -u texi2html/Tests/formatting_res/other-nodes.html:1.4
texi2html/Tests/formatting_res/other-nodes.html:1.5
--- texi2html/Tests/formatting_res/other-nodes.html:1.4 Tue Aug 9 17:19:22 2005
+++ texi2html/Tests/formatting_res/other-nodes.html Sat Mar 25 13:26:47 2006
@@ -63,9 +63,11 @@
<table><tr><td> </td><td><pre class="example">id: other-nodes
</pre></td></tr></table>
+
<p><tt>Top</tt> <a href="index.html#SEC_Top">Test refs</a>
</p><table><tr><td> </td><td><pre class="example">target: #Top
</pre></td></tr></table>
+
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top"><a
href="_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e.html#g_t_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e">•
!_"#$%&'()*+-./;<=>?[\]^_`|~</a></td><td> </td><td
align="left" valign="top">
</td></tr>
Index: texi2html/Tests/formatting_res/test_refs.html
diff -u texi2html/Tests/formatting_res/test_refs.html:1.7
texi2html/Tests/formatting_res/test_refs.html:1.8
--- texi2html/Tests/formatting_res/test_refs.html:1.7 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/formatting_res/test_refs.html Sat Mar 25 13:26:47 2006
@@ -61,14 +61,17 @@
</p><table><tr><td> </td><td><pre class="example">mono :
manual.html#a-node
split: ../manual/a-node.html#a-node
</pre></td></tr></table>
+
<p><tt>:</tt> <a href="manual.html#g_t_003a">(manual):</a>
</p><table><tr><td> </td><td><pre class="example">mono : manual.html#_003a
split: ../manual/_003a.html#_003a
</pre></td></tr></table>
+
<p><tt>Top</tt> <a href="manual.html#Top">(manual)top</a><br>
</p><table><tr><td> </td><td><pre class="example">mono : manual.html#Top
split: ../manual/index.html#Top
</pre></td></tr></table>
+
<a name="SEC2"></a>
<h3 class="subheading"> Testing manual name </h3>
@@ -76,18 +79,22 @@
</p><table><tr><td> </td><td><pre class="example">mono : doc.html#node
split: ../doc/node.html#node
</pre></td></tr></table>
+
<a name="SEC3"></a>
<h3 class="subheading"> Testing local nodes </h3>
<p><tt>!_"#$%&'()*+-./;<=>?[\]^_`|~</tt> <a
href="#g_t_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e">!_"#$%&'()*+-./;<=>?[\]^_`|~</a><br>
</p><table><tr><td> </td><td><pre class="example">target:
#_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e
</pre></td></tr></table>
+
<p><tt>Top</tt> <a href="#SEC_Top">Test refs</a>
</p><table><tr><td> </td><td><pre class="example">target: #Top
</pre></td></tr></table>
+
<p><tt> local node</tt> <a href="#local-node">local node</a>
</p><table><tr><td> </td><td><pre class="example">target: #local-node
</pre></td></tr></table>
+
<hr size="1">
<a name="other-nodes"></a>
<a name="SEC4"></a>
@@ -111,9 +118,11 @@
<table><tr><td> </td><td><pre class="example">id: other-nodes
</pre></td></tr></table>
+
<p><tt>Top</tt> <a href="#SEC_Top">Test refs</a>
</p><table><tr><td> </td><td><pre class="example">target: #Top
</pre></td></tr></table>
+
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top"><a
href="#g_t_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e">•
!_"#$%&'()*+-./;<=>?[\]^_`|~</a></td><td> </td><td
align="left" valign="top">
</td></tr>
@@ -124,9 +133,11 @@
<a
name="g_t_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e"></a>
<table><tr><td> </td><td><pre class="example">id:
_0021_005f_0022_0023_0024_0025_0026_0027_0028_0029_002a_002b_002d_002e_002f_003b_003c_003d_003e_003f_005b_005c_005d_005e_005f_0060_007c_007e
</pre></td></tr></table>
+
<a name="local-node"></a>
<table><tr><td> </td><td><pre class="example">id: local-node
</pre></td></tr></table>
+
<hr size="6">
<a name="SEC_About"></a>
<table cellpadding="1" cellspacing="1" border="0">
Index: texi2html/Tests/formatting_res/testkb.html
diff -u texi2html/Tests/formatting_res/testkb.html:1.15
texi2html/Tests/formatting_res/testkb.html:1.16
--- texi2html/Tests/formatting_res/testkb.html:1.15 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/formatting_res/testkb.html Sat Mar 25 13:26:47 2006
@@ -163,7 +163,8 @@
Das ist ein Beispiel in HTML
Das ist ein Beispiel in HTML
Das ist ein Beispiel in HTML
-</pre></td></tr></table><br>
+</pre></td></tr></table>
+<br>
<p>Hier muß in HTML eine Tabelle erzeugt werden. Hier ist das ok.
Beschreibung zu deffn. Hier muß in HTML eine Tabelle erzeugt
werden. Hier ist das ok. Beschreibung zu deffn.
Index: texi2html/Tests/formatting_res/verbatim_html.html
diff -u texi2html/Tests/formatting_res/verbatim_html.html:1.35
texi2html/Tests/formatting_res/verbatim_html.html:1.36
--- texi2html/Tests/formatting_res/verbatim_html.html:1.35 Fri Jan 27
16:42:56 2006
+++ texi2html/Tests/formatting_res/verbatim_html.html Sat Mar 25 13:26:47 2006
@@ -87,7 +87,8 @@
<dl compact="compact">
<dt> <em>ref</em></dt>
<dd><table><tr><td> </td><td><pre class="example">example
-</pre></td></tr></table></dd>
+</pre></td></tr></table>
+</dd>
</dl>
@end table
@@ -191,6 +192,7 @@
<p>A sc: <small>IEEE</small>, and another one in example:
</p><table><tr><td> </td><td><pre class="example">AEEI
</pre></td></tr></table>
+
<p>ignore bidule ignore
</p>
<p>Ignore is the same than @html.
@@ -380,6 +382,7 @@
the example
before end example </pre></td></tr></table>
+
<p>after end example
</p>
@@ -406,7 +409,8 @@
An example
-</pre></td></tr></table><hr size="1">
+</pre></td></tr></table>
+<hr size="1">
<a name="SEC_Contents"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#SEC_Top" title="Cover (top) of
document">Top</a>]</td>
Index: texi2html/Tests/macros_res/macros.html
diff -u texi2html/Tests/macros_res/macros.html:1.23
texi2html/Tests/macros_res/macros.html:1.24
--- texi2html/Tests/macros_res/macros.html:1.23 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/macros_res/macros.html Sat Mar 25 13:26:47 2006
@@ -113,6 +113,7 @@
/arg/
</pre></td></tr></table>
+
<hr size="6">
<a name="SEC_Contents"></a>
<table cellpadding="1" cellspacing="1" border="0">
Index: texi2html/Tests/macros_res/simple_macro.html
diff -u texi2html/Tests/macros_res/simple_macro.html:1.24
texi2html/Tests/macros_res/simple_macro.html:1.25
--- texi2html/Tests/macros_res/simple_macro.html:1.24 Tue Aug 23 23:51:13 2005
+++ texi2html/Tests/macros_res/simple_macro.html Sat Mar 25 13:26:47 2006
@@ -80,11 +80,13 @@
result: @emph{\arg1\} protected \\ -> \\arg1\\ @emp{\arg2\}
@end macro
</pre></td></tr></table>
+
<p>before macro after end macro
</p>
<p>Calling (normal)
</p><table><tr><td> </td><td><pre class="example">the @macro1 {
@samp{f\irst arg}, second arg } after macro
-</pre></td></tr></table><p>==================================
+</pre></td></tr></table>
+<p>==================================
</p>
<p>the result: <em><samp>`first arg'</samp></em> protected \ -> \arg1\
<em>second arg </em> after macro
</p>
@@ -96,7 +98,8 @@
</p>
<p>Calling (one arg)
</p><table><tr><td> </td><td><pre class="example">@macro1 { @samp{f\irst
arg}}
-</pre></td></tr></table><p>==================================
+</pre></td></tr></table>
+<p>==================================
</p>
<p>result: <em><samp>`first arg'</samp></em> protected \ -> \arg1\ <em></em>
</p>
@@ -108,7 +111,8 @@
</p>
<p>Calling (no args)
</p><table><tr><td> </td><td><pre class="example">@macro1 @samp{f\irst
arg}, second arg
-</pre></td></tr></table><p>==================================
+</pre></td></tr></table>
+<p>==================================
</p>
<p>result: <em></em> protected \ -> \arg1\ <em></em> <samp>`f\irst
arg'</samp>, second arg
</p>
@@ -120,7 +124,8 @@
</p>
<p>Calling (three args)
</p><table><tr><td> </td><td><pre class="example">@macro1 { @samp{f\irst
arg}, second arg, third arg}
-</pre></td></tr></table><p>==================================
+</pre></td></tr></table>
+<p>==================================
</p>
<p>result: <em><samp>`first arg'</samp></em> protected \ -> \arg1\
<em>second arg</em>
</p>
@@ -139,9 +144,11 @@
@end macro
</pre></td></tr></table>
+
<p>Calling
</p><table><tr><td> </td><td><pre class="example">@macro2 { arg, comma \,
}
-</pre></td></tr></table><p>==================================
+</pre></td></tr></table>
+<p>==================================
</p>
<p>we get arg, comma , and another arg, comma ,
and another one on another line arg, comma ,
@@ -159,7 +166,8 @@
</p>
<p>Calling
</p><table><tr><td> </td><td><pre class="example">@macro2 arg, comma \,
-</pre></td></tr></table><p>==================================
+</pre></td></tr></table>
+<p>==================================
</p>
<p>we get arg, comma \, and another arg, comma \,
and another one on another line arg, comma \,
@@ -204,7 +212,8 @@
</p>
<p>Calling macro1 with value
</p><table><tr><td> </td><td><pre class="example">@macro1 { arg1
@value{comma} arg2 }
-</pre></td></tr></table><p>=======================================
+</pre></td></tr></table>
+<p>=======================================
</p>
<p>result: <em>arg1 , arg2 </em> protected \ -> \arg1\ <em></em>
</p>
@@ -228,6 +237,7 @@
@end macro
</pre></td></tr></table>
+
<p>==================================
</p>
<p>result: <em>\\arg\ </em>
@@ -247,6 +257,7 @@
@end macro
</pre></td></tr></table>
+
<p>==================================
</p>
<p>result: <em>macro_arg1</em> the \the thearg \thearg with value \thearg
Index: texi2html/Tests/nodes_texinfo_res/A4-Paper.html
diff -u texi2html/Tests/nodes_texinfo_res/A4-Paper.html:1.14
texi2html/Tests/nodes_texinfo_res/A4-Paper.html:1.15
--- texi2html/Tests/nodes_texinfo_res/A4-Paper.html:1.14 Mon Nov 14
11:13:58 2005
+++ texi2html/Tests/nodes_texinfo_res/A4-Paper.html Sat Mar 25 13:26:47 2006
@@ -93,6 +93,7 @@
@afourpaper
@c %**end of header
</pre></td></tr></table>
+
<p>See section <a href="Format-with-texi2dvi.html#SEC247">Format with
<code>texi2dvi</code></a>, and <a
href="Preparing-for-TeX.html#SEC253">Preparing for TeX</a>, for other ways to
format for different paper sizes that do not
require changing the source file.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Abstract-Objects.html
diff -u texi2html/Tests/nodes_texinfo_res/Abstract-Objects.html:1.20
texi2html/Tests/nodes_texinfo_res/Abstract-Objects.html:1.21
--- texi2html/Tests/nodes_texinfo_res/Abstract-Objects.html:1.20 Mon Nov
14 11:13:58 2005
+++ texi2html/Tests/nodes_texinfo_res/Abstract-Objects.html Sat Mar 25
13:26:47 2006
@@ -114,6 +114,7 @@
…
@end defcv
</pre></td></tr></table>
+
<p><code>@defcv</code> creates an entry in the index of variables.
</p>
<a name="IDX279"></a>
@@ -128,6 +129,7 @@
<var>body-of-definition</var>
@end defivar
</pre></td></tr></table>
+
<p><code>@defivar</code> creates an entry in the index of variables.
</p>
<a name="IDX280"></a>
@@ -170,6 +172,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@defop Operation windows
expose
</pre></td></tr></table>
+
<p>The <code>@defop</code> command is written at the beginning of a line and
is followed on the same line by the overall name of the category of
operation, the name of the class of the operation, the name of the
@@ -180,6 +183,7 @@
<var>body-of-definition</var>
@end defop
</pre></td></tr></table>
+
<p><code>@defop</code> creates an entry, such as `<code>expose</code> on
<code>windows</code>', in the index of functions.
</p>
@@ -205,7 +209,6 @@
the name of the class of the method, the name of the method, and its
arguments, if any.
</p>
-
<p>For example:
</p><table><tr><td> </td><td><pre class="example">@defmethod
<code>bar-class</code> bar-method argument
…
@@ -221,6 +224,7 @@
<var>body-of-definition</var>
@end defmethod
</pre></td></tr></table>
+
<p><code>@defmethod</code> creates an entry, such as `<code>bar-method</code>
on
<code>bar-class</code>', in the index of functions.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Conditional-Commands.html
diff -u texi2html/Tests/nodes_texinfo_res/Conditional-Commands.html:1.15
texi2html/Tests/nodes_texinfo_res/Conditional-Commands.html:1.16
--- texi2html/Tests/nodes_texinfo_res/Conditional-Commands.html:1.15 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Conditional-Commands.html Sat Mar 25
13:26:47 2006
@@ -122,7 +122,6 @@
However, this text will appear only in Info (or plain text).
And this text will only appear in HTML.
</p>
-
<p>Notice that you only see one of the input lines, depending on which
version of the manual you are reading.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Conditional-Not-Commands.html
diff -u texi2html/Tests/nodes_texinfo_res/Conditional-Not-Commands.html:1.17
texi2html/Tests/nodes_texinfo_res/Conditional-Not-Commands.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Conditional-Not-Commands.html:1.17
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Conditional-Not-Commands.html Sat Mar
25 13:26:47 2006
@@ -99,6 +99,7 @@
<code>@ifnotplaintext</code>, like this:
</p><table><tr><td> </td><td><pre class="example">This will be in Info,
but not plain text.
</pre></td></tr></table>
+
<p>The regions delimited by these commands are ordinary Texinfo source as
with <code>@iftex</code>, not raw formatter source as with <code>@tex</code>
(see section <a href="Raw-Formatter-Commands.html#SEC230">Raw Formatter
Commands</a>).
Index: texi2html/Tests/nodes_texinfo_res/Contents.html
diff -u texi2html/Tests/nodes_texinfo_res/Contents.html:1.18
texi2html/Tests/nodes_texinfo_res/Contents.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Contents.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Contents.html Sat Mar 25 13:26:47 2006
@@ -155,6 +155,7 @@
</p><table><tr><td> </td><td><pre class="example">texi2dvi address@hidden
foo.texi
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a
href="Printing-Indices-_0026-Menus.html#SEC69" title="Previous section in
reading order"> < </a>]</td>
Index: texi2html/Tests/nodes_texinfo_res/Conventions.html
diff -u texi2html/Tests/nodes_texinfo_res/Conventions.html:1.20
texi2html/Tests/nodes_texinfo_res/Conventions.html:1.21
--- texi2html/Tests/nodes_texinfo_res/Conventions.html:1.20 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Conventions.html Sat Mar 25 13:26:47 2006
@@ -133,11 +133,9 @@
with tabs, and thus a tab character in your input file may appear
differently in the output, for example, in indented text.
</p>
-
<p>To avoid this problem, Texinfo mode causes GNU Emacs to insert multiple
spaces when you press the <kbd>TAB</kbd> key.
</p>
-
<p>Also, you can run <code>untabify</code> in Emacs to convert tabs in a region
to multiple spaces.
</p></blockquote>
Index: texi2html/Tests/nodes_texinfo_res/Copyright.html
diff -u texi2html/Tests/nodes_texinfo_res/Copyright.html:1.17
texi2html/Tests/nodes_texinfo_res/Copyright.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Copyright.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Copyright.html Sat Mar 25 13:26:47 2006
@@ -108,6 +108,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@insertcopying
</pre></td></tr></table>
+
<p>Follow the copying text by the publisher, ISBN numbers, cover art
credits, and other such information.
</p>
@@ -125,6 +126,7 @@
@end titlepage
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/Cropmarks-and-Magnification.html
diff -u texi2html/Tests/nodes_texinfo_res/Cropmarks-and-Magnification.html:1.18
texi2html/Tests/nodes_texinfo_res/Cropmarks-and-Magnification.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Cropmarks-and-Magnification.html:1.18
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Cropmarks-and-Magnification.html Sat Mar
25 13:26:47 2006
@@ -89,6 +89,7 @@
@cropmarks
@end iftex
</pre></td></tr></table>
+
<p>This command is mainly for printers that typeset several pages on one
sheet of film; but you can attempt to use it to mark the corners of a
book set to 7 by 9.25 inches with the <code>@smallbook</code> command.
@@ -118,6 +119,7 @@
\mag=1200
@end tex
</pre></td></tr></table>
+
<p>With some printing technologies, you can print normal-sized copies that
look better than usual by giving a larger-than-normal master to your
print shop. They do the reduction, thus effectively increasing the
Index: texi2html/Tests/nodes_texinfo_res/Cross-Reference-Commands.html
diff -u texi2html/Tests/nodes_texinfo_res/Cross-Reference-Commands.html:1.19
texi2html/Tests/nodes_texinfo_res/Cross-Reference-Commands.html:1.20
--- texi2html/Tests/nodes_texinfo_res/Cross-Reference-Commands.html:1.19
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Cross-Reference-Commands.html Sat Mar
25 13:26:47 2006
@@ -106,7 +106,6 @@
</p></dd>
</dl>
-
<p>(The <code>@cite</code> command is used to make references to books and
manuals for which there is no corresponding Info file and, therefore,
no node to which to point. See section <a
href="cite.html#SEC133"><code>@cite</code></a>.)
Index: texi2html/Tests/nodes_texinfo_res/Cross-Reference-Parts.html
diff -u texi2html/Tests/nodes_texinfo_res/Cross-Reference-Parts.html:1.20
texi2html/Tests/nodes_texinfo_res/Cross-Reference-Parts.html:1.21
--- texi2html/Tests/nodes_texinfo_res/Cross-Reference-Parts.html:1.20 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Cross-Reference-Parts.html Sat Mar
25 13:26:47 2006
@@ -120,7 +120,6 @@
<blockquote><p>See section “Particular Topic” in <i>A Printed
Manual</i>, for details.
</p></blockquote>
-
<p>in a printed book.
</p>
<p>The five possible arguments for a cross reference are:
@@ -158,6 +157,7 @@
<table><tr><td> </td><td><pre class="example">@xref{<var>node-name</var>,
<var>cross-reference-name</var>, <var>title-or-topic</var>,
<var>info-file-name</var>, <var>printed-manual-title</var>}.
</pre></td></tr></table>
+
<p>Cross references with one, two, three, four, and five arguments are
described separately following the description of <code>@xref</code>.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Custom-Headings.html
diff -u texi2html/Tests/nodes_texinfo_res/Custom-Headings.html:1.21
texi2html/Tests/nodes_texinfo_res/Custom-Headings.html:1.22
--- texi2html/Tests/nodes_texinfo_res/Custom-Headings.html:1.21 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Custom-Headings.html Sat Mar 25
13:26:47 2006
@@ -196,7 +196,6 @@
</p></dd>
</dl>
-
<p>You can also use the <code>@today{}</code> command, which expands to the
current date, in `1 Jan 1900' format.
<a name="IDX461"></a>
@@ -209,6 +208,7 @@
@everyheading @emph{Draft!} @| @thispage @| @thischapter
@everyfooting @| @| Version: 0.27: @today{}
</pre></td></tr></table>
+
<p>Beware of overlong titles: they may overlap another part of the
header or footer and blot it out.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Data-Types.html
diff -u texi2html/Tests/nodes_texinfo_res/Data-Types.html:1.19
texi2html/Tests/nodes_texinfo_res/Data-Types.html:1.20
--- texi2html/Tests/nodes_texinfo_res/Data-Types.html:1.19 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Data-Types.html Sat Mar 25 13:26:47 2006
@@ -105,12 +105,14 @@
…
@end deftp
</pre></td></tr></table>
+
<p>The template is:
</p>
<table><tr><td> </td><td><pre class="example">@deftp <var>category</var>
<var>name-of-type</var> <var>attributes</var>…
<var>body-of-definition</var>
@end deftp
</pre></td></tr></table>
+
<p><code>@deftp</code> creates an entry in the index of data types.
</p></dd>
</dl>
Index: texi2html/Tests/nodes_texinfo_res/Debugging-with-Info.html
diff -u texi2html/Tests/nodes_texinfo_res/Debugging-with-Info.html:1.18
texi2html/Tests/nodes_texinfo_res/Debugging-with-Info.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Debugging-with-Info.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Debugging-with-Info.html Sat Mar 25
13:26:47 2006
@@ -119,6 +119,7 @@
∗
---------- Buffer: *Info Region* ----------
</pre></td></tr></table>
+
<p>The <code>texinfo-format-region</code> command sometimes provides slightly
odd error messages. For example, the following cross reference fails to
format:
</p>
@@ -141,11 +142,13 @@
<p>Formatting produces:
</p><table><tr><td> </td><td><pre class="example">(*Note for more info.:
Catching Mistakes)
</pre></td></tr></table>
+
<p>The only way for you to detect this error is to realize that the
reference should have looked like this:
</p>
<table><tr><td> </td><td><pre class="example">(*Note Catching Mistakes::,
for more info.)
</pre></td></tr></table>
+
<p>Incidentally, if you are reading this node in Info and type <kbd>f
<kbd>RET</kbd></kbd> (<code>Info-follow-reference</code>), you will generate
an error
message that says:
Index: texi2html/Tests/nodes_texinfo_res/Debugging-with-TeX.html
diff -u texi2html/Tests/nodes_texinfo_res/Debugging-with-TeX.html:1.19
texi2html/Tests/nodes_texinfo_res/Debugging-with-TeX.html:1.20
--- texi2html/Tests/nodes_texinfo_res/Debugging-with-TeX.html:1.19 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Debugging-with-TeX.html Sat Mar 25
13:26:47 2006
@@ -114,6 +114,7 @@
?
---------- Buffer: *tex-shell* ----------
</pre></td></tr></table>
+
<p>In this case, TeX produced an accurate and
understandable error message:
</p>
Index: texi2html/Tests/nodes_texinfo_res/Def-Cmd-Template.html
diff -u texi2html/Tests/nodes_texinfo_res/Def-Cmd-Template.html:1.18
texi2html/Tests/nodes_texinfo_res/Def-Cmd-Template.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Def-Cmd-Template.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Def-Cmd-Template.html Sat Mar 25
13:26:47 2006
@@ -169,7 +169,6 @@
</p></dd></dl>
</blockquote>
-
<p>See section <a href="Sample-Function-Definition.html#SEC226">A Sample
Function Definition</a>, for a more detailed example of a function
definition, including the use of <code>@example</code> inside the
definition.
Index: texi2html/Tests/nodes_texinfo_res/Defining-Macros.html
diff -u texi2html/Tests/nodes_texinfo_res/Defining-Macros.html:1.17
texi2html/Tests/nodes_texinfo_res/Defining-Macros.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Defining-Macros.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Defining-Macros.html Sat Mar 25
13:26:47 2006
@@ -86,6 +86,7 @@
<var>text</var> … \<var>param1</var>\ …
@end macro
</pre></td></tr></table>
+
<p>The <em>parameters</em> <var>param1</var>, <var>param2</var>, …
correspond to
arguments supplied when the macro is subsequently used in the document
(described in the next section).
@@ -134,6 +135,7 @@
…
@address@hidden
</pre></td></tr></table>
+
<p>This produces the output `a1atextb2b'. With <samp>address@hidden'</samp>
instead of
<samp>address@hidden'</samp>, an error message is given.
</p>
@@ -147,6 +149,7 @@
<table><tr><td> </td><td><pre class="example">@unmacro foo
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a
href="Defining-New-Texinfo-Commands.html#SEC238" title="Previous section in
reading order"> < </a>]</td>
Index: texi2html/Tests/nodes_texinfo_res/Directory-File.html
diff -u texi2html/Tests/nodes_texinfo_res/Directory-File.html:1.19
texi2html/Tests/nodes_texinfo_res/Directory-File.html:1.20
--- texi2html/Tests/nodes_texinfo_res/Directory-File.html:1.19 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Directory-File.html Sat Mar 25
13:26:47 2006
@@ -99,6 +99,7 @@
@TeX{} or an Info file.
…
</pre></td></tr></table>
+
<p>Each of these menu entries points to the `Top' node of the Info file
that is named in parentheses. (The menu entry does not need to
specify the `Top' node, since Info goes to the `Top' node if no node
Index: texi2html/Tests/nodes_texinfo_res/End-of-Header.html
diff -u texi2html/Tests/nodes_texinfo_res/End-of-Header.html:1.15
texi2html/Tests/nodes_texinfo_res/End-of-Header.html:1.16
--- texi2html/Tests/nodes_texinfo_res/End-of-Header.html:1.15 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/End-of-Header.html Sat Mar 25
13:26:47 2006
@@ -85,6 +85,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@c %**end of header
</pre></td></tr></table>
+
<p>See section <a href="Start-of-Header.html#SEC45">Start of Header</a>.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Ending-a-File.html
diff -u texi2html/Tests/nodes_texinfo_res/Ending-a-File.html:1.16
texi2html/Tests/nodes_texinfo_res/Ending-a-File.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Ending-a-File.html:1.16 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Ending-a-File.html Sat Mar 25
13:26:47 2006
@@ -97,6 +97,7 @@
@bye
</pre></td></tr></table>
+
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top"><a
href="Printing-Indices-_0026-Menus.html#SEC69">4.1 Printing Indices and
Menus</a></td><td> </td><td align="left" valign="top"> How to
print an index in hardcopy and
generate index menus in Info.
Index: texi2html/Tests/nodes_texinfo_res/Error-Glyph.html
diff -u texi2html/Tests/nodes_texinfo_res/Error-Glyph.html:1.17
texi2html/Tests/nodes_texinfo_res/Error-Glyph.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Error-Glyph.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Error-Glyph.html Sat Mar 25 13:26:47 2006
@@ -105,6 +105,7 @@
</p>
<table><tr><td> </td><td><pre class="lisp">Wrong type argument:
integer-or-marker-p, x
</pre></td></tr></table>
+
<p><samp>`error-->'</samp> itself is not part of the error message.
</p>
Index: texi2html/Tests/nodes_texinfo_res/First-Node.html
diff -u texi2html/Tests/nodes_texinfo_res/First-Node.html:1.18
texi2html/Tests/nodes_texinfo_res/First-Node.html:1.19
--- texi2html/Tests/nodes_texinfo_res/First-Node.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/First-Node.html Sat Mar 25 13:26:47 2006
@@ -126,6 +126,7 @@
<table><tr><td> </td><td><pre class="example">@node Top
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a
href="Node-Line-Requirements.html#SEC92" title="Previous section in reading
order"> < </a>]</td>
Index: texi2html/Tests/nodes_texinfo_res/Fonts.html
diff -u texi2html/Tests/nodes_texinfo_res/Fonts.html:1.16
texi2html/Tests/nodes_texinfo_res/Fonts.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Fonts.html:1.16 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Fonts.html Sat Mar 25 13:26:47 2006
@@ -105,6 +105,7 @@
</p>
<table><tr><td> </td><td><pre class="lisp">(+ 2 2) ; Add two plus two.
</pre></td></tr></table>
+
<p>If possible, you should avoid using the other three font commands. If
you need to use one, it probably indicates a gap in the Texinfo
language.
Index: texi2html/Tests/nodes_texinfo_res/Footnote-Commands.html
diff -u texi2html/Tests/nodes_texinfo_res/Footnote-Commands.html:1.17
texi2html/Tests/nodes_texinfo_res/Footnote-Commands.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Footnote-Commands.html:1.17 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Footnote-Commands.html Sat Mar 25
13:26:47 2006
@@ -88,6 +88,7 @@
</p>
<table><tr><td> </td><td><pre class="example">ordinary
address@hidden<var>text of footnote</var>}
</pre></td></tr></table>
+
<p>As shown here, the <code>@footnote</code> command should come right after
the
text being footnoted, with no intervening space; otherwise, the footnote
marker might end up starting a line.
@@ -98,6 +99,7 @@
<table><tr><td> </td><td><pre class="example">…a sample
address@hidden is the sample
footnote.}; in the Texinfo source…
</pre></td></tr></table>
+
<p>As you can see, the source includes two punctuation marks next to each
other; in this case, <samp>`.};'</samp> is the sequence. This is normal (the
first ends the footnote and the second belongs to the sentence being
Index: texi2html/Tests/nodes_texinfo_res/Footnote-Styles.html
diff -u texi2html/Tests/nodes_texinfo_res/Footnote-Styles.html:1.22
texi2html/Tests/nodes_texinfo_res/Footnote-Styles.html:1.23
--- texi2html/Tests/nodes_texinfo_res/Footnote-Styles.html:1.22 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Footnote-Styles.html Sat Mar 25
13:26:47 2006
@@ -92,13 +92,13 @@
<samp>`Footnotes'</samp> within it. Each footnote begins with an
<samp>`(<var>n</var>)'</samp> reference mark.
-
<p>Here is an example of a single footnote in the end of node style:
</p>
<table><tr><td> </td><td><pre class="example"> --------- Footnotes
---------
(1) Here is a sample footnote.
</pre></td></tr></table>
+
<a name="IDX228"></a>
</li><li>
In the `Separate' node style, all the footnotes for a single
@@ -115,7 +115,6 @@
<tt>`Footnotes-Footnotes'</tt>!) The footnotes' node has an
`Up' node pointer that leads back to its parent node.
</p>
-
<p>Here is how the first footnote in this manual looks after being
formatted for Info in the separate node style:
</p>
@@ -123,7 +122,8 @@
(1) The first syllable of "Texinfo" is pronounced like
"speck", not
"hex". …
-</pre></td></tr></table></li></ul>
+</pre></td></tr></table>
+</li></ul>
<p>A Texinfo file may be formatted into an Info file with either footnote
style.
@@ -141,6 +141,7 @@
<p>or
</p><table><tr><td> </td><td><pre class="example">@footnotestyle separate
</pre></td></tr></table>
+
<p>Write an <code>@footnotestyle</code> command before or shortly after the
end-of-header line at the beginning of a Texinfo file. (If you
include the <code>@footnotestyle</code> command between the start-of-header
Index: texi2html/Tests/nodes_texinfo_res/Format-with-tex_002ftexindex.html
diff -u texi2html/Tests/nodes_texinfo_res/Format-with-tex_002ftexindex.html:1.6
texi2html/Tests/nodes_texinfo_res/Format-with-tex_002ftexindex.html:1.7
--- texi2html/Tests/nodes_texinfo_res/Format-with-tex_002ftexindex.html:1.6
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Format-with-tex_002ftexindex.html Sat Mar
25 13:26:47 2006
@@ -85,6 +85,7 @@
</p>
<table><tr><td> </td><td><pre class="example">tex foo.texi
</pre></td></tr></table>
+
<p>TeX will produce a <em>DVI file</em> as well as several auxiliary
files containing information for indices, cross references, etc. The
DVI file (for <em>DeVice Independent</em> file) can be printed on virtually
@@ -190,6 +191,7 @@
@setfilename myfile.info
…
</pre></td></tr></table>
+
<p><code>@novalidate</code> also turns off validation in
<code>makeinfo</code>, just like its <code>--no-validate</code> option
(see section <a href="Pointer-Validation.html#SEC265">Pointer Validation</a>).
Index: texi2html/Tests/nodes_texinfo_res/Format-with-texi2dvi.html
diff -u texi2html/Tests/nodes_texinfo_res/Format-with-texi2dvi.html:1.17
texi2html/Tests/nodes_texinfo_res/Format-with-texi2dvi.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Format-with-texi2dvi.html:1.17 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Format-with-texi2dvi.html Sat Mar 25
13:26:47 2006
@@ -91,6 +91,7 @@
</p>
<table><tr><td> </td><td><pre class="example">prompt$ <kbd>texi2dvi
foo.texi</kbd>
</pre></td></tr></table>
+
<p>As shown in this example, the input filenames to <code>texi2dvi</code> must
include any extension (<samp>`.texi'</samp>, <samp>`.texinfo'</samp>, etc.).
Under
MS-DOS and perhaps in other circumstances, you may need to run <samp>`sh
Index: texi2html/Tests/nodes_texinfo_res/Formatting-Commands.html
diff -u texi2html/Tests/nodes_texinfo_res/Formatting-Commands.html:1.20
texi2html/Tests/nodes_texinfo_res/Formatting-Commands.html:1.21
--- texi2html/Tests/nodes_texinfo_res/Formatting-Commands.html:1.20 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Formatting-Commands.html Sat Mar 25
13:26:47 2006
@@ -135,7 +135,6 @@
appear in the output, so beware.
</li></ul>
-
<a name="IDX14"></a>
<p>As a general rule, a command requires braces if it mingles among other
text; but it does not need braces if it starts a line of its own. The
Index: texi2html/Tests/nodes_texinfo_res/Four-and-Five-Arguments.html
diff -u texi2html/Tests/nodes_texinfo_res/Four-and-Five-Arguments.html:1.17
texi2html/Tests/nodes_texinfo_res/Four-and-Five-Arguments.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Four-and-Five-Arguments.html:1.17 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Four-and-Five-Arguments.html Sat Mar
25 13:26:47 2006
@@ -88,7 +88,6 @@
<code>@xref</code> command to terminate the cross reference. In the
following examples, a clause follows a terminating comma.
</p>
-
<p>The template is:
</p>
<table><tr><td> </td><td><pre class="example">@xref{<var>node-name</var>,
<var>cross-reference-name</var>, <var>title-or-topic</var>,
@@ -109,14 +108,12 @@
<p>The name of the Info file is enclosed in parentheses and precedes
the name of the node.
</p>
-
<p>In a printed manual, the reference looks like this:
</p>
<blockquote><p>See section “Thunder and Lightning” in <i>An
Introduction to
Meteorology</i>, for details.
</p></blockquote>
-
<p>The title of the printed manual is typeset in italics; and the
reference lacks a page number since TeX cannot know to which page a
reference refers when that reference is to another manual.
@@ -125,7 +122,6 @@
version of <code>@xref</code>. In this case, the third argument, the topic
description, will be used as the cross reference name in Info.
</p>
-
<p>The template looks like this:
</p>
<table><tr><td> </td><td><pre class="example">@xref{<var>node-name</var>,
, <var>title-or-topic</var>, <var>info-file-name</var>,
@@ -142,7 +138,6 @@
<blockquote><p>See section <var>title-or-topic</var> in
<var>printed-manual-title</var>, for details.
</p></blockquote>
-
<p>For example,
</p>
<table><tr><td> </td><td><pre class="example">@xref{Electrical Effects, ,
Thunder and Lightning,
Index: texi2html/Tests/nodes_texinfo_res/Functions-Commands.html
diff -u texi2html/Tests/nodes_texinfo_res/Functions-Commands.html:1.21
texi2html/Tests/nodes_texinfo_res/Functions-Commands.html:1.22
--- texi2html/Tests/nodes_texinfo_res/Functions-Commands.html:1.21 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Functions-Commands.html Sat Mar 25
13:26:47 2006
@@ -120,6 +120,7 @@
<var>body-of-definition</var>
@end deffn
</pre></td></tr></table>
+
<a name="IDX267"></a>
</dd>
<dt> <code>@defun <var>name</var> <var>arguments</var>…</code></dt>
@@ -127,7 +128,6 @@
<code>@defun</code> is equivalent to <samp>address@hidden Function
…'</samp>.
</p>
-
<p>For example,
</p>
<table><tr><td> </td><td><pre class="example">@defun set symbol new-value
@@ -148,6 +148,7 @@
<var>body-of-definition</var>
@end defun
</pre></td></tr></table>
+
<p><code>@defun</code> creates an entry in the index of functions.
</p>
<a name="IDX268"></a>
Index: texi2html/Tests/nodes_texinfo_res/GNU-Free-Documentation-License.html
diff -u
texi2html/Tests/nodes_texinfo_res/GNU-Free-Documentation-License.html:1.19
texi2html/Tests/nodes_texinfo_res/GNU-Free-Documentation-License.html:1.20
--- texi2html/Tests/nodes_texinfo_res/GNU-Free-Documentation-License.html:1.19
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/GNU-Free-Documentation-License.html
Sat Mar 25 13:26:47 2006
@@ -88,6 +88,7 @@
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
</pre></td></tr></table>
+
<ol>
<li>
PREAMBLE
Index: texi2html/Tests/nodes_texinfo_res/GNU-Sample-Texts.html
diff -u texi2html/Tests/nodes_texinfo_res/GNU-Sample-Texts.html:1.69
texi2html/Tests/nodes_texinfo_res/GNU-Sample-Texts.html:1.70
--- texi2html/Tests/nodes_texinfo_res/GNU-Sample-Texts.html:1.69 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/GNU-Sample-Texts.html Sat Mar 25
13:26:47 2006
@@ -105,7 +105,8 @@
The <samp>`Id: texinfo.txi,v 1.2 2003/02/24 18:17:06 pertusus Exp $'</samp>
comment is for CVS (see <a href="../cvs/index.html#Top">(cvs)Top</a> section
`Overview' in <cite>Concurrent Versions System</cite>) or RCS (see rcsintro(1))
version control
systems, which expand it into a string such as:
<table><tr><td> </td><td><pre class="example">Id: texinfo.txi,v 1.2
2003/02/24 18:17:06 pertusus Exp $
-</pre></td></tr></table><p>(This is useful in all sources that use version
control, not just manuals.)
+</pre></td></tr></table>
+<p>(This is useful in all sources that use version control, not just manuals.)
</p>
</li><li>
<a name="IDX449"></a>
@@ -234,6 +235,7 @@
@bye
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a
href="Short-Sample-Texinfo-File.html#SEC295" title="Previous section in reading
order"> < </a>]</td>
Index: texi2html/Tests/nodes_texinfo_res/Heading-Choice.html
diff -u texi2html/Tests/nodes_texinfo_res/Heading-Choice.html:1.17
texi2html/Tests/nodes_texinfo_res/Heading-Choice.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Heading-Choice.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Heading-Choice.html Sat Mar 25
13:26:47 2006
@@ -113,7 +113,6 @@
</p></dd>
</dl>
-
<p>Texinfo lacks an <code>@setchapternewpage even</code> command.
</p>
<hr size="1">
Index: texi2html/Tests/nodes_texinfo_res/Heading-Format.html
diff -u texi2html/Tests/nodes_texinfo_res/Heading-Format.html:1.17
texi2html/Tests/nodes_texinfo_res/Heading-Format.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Heading-Format.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Heading-Format.html Sat Mar 25
13:26:47 2006
@@ -103,6 +103,7 @@
| |
</pre></td></tr></table>
+
<p>The standard format for two-sided printing depends on whether the page
number is even or odd. By convention, even-numbered pages are on the
left- and odd-numbered pages are on the right. (TeX will adjust the
Index: texi2html/Tests/nodes_texinfo_res/Images.html
diff -u texi2html/Tests/nodes_texinfo_res/Images.html:1.19
texi2html/Tests/nodes_texinfo_res/Images.html:1.20
--- texi2html/Tests/nodes_texinfo_res/Images.html:1.19 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Images.html Sat Mar 25 13:26:47 2006
@@ -86,6 +86,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@image{<var>filename</var>,
[<var>width</var>], [<var>height</var>], [<var>alttext</var>],
[<var>extension</var>]}
</pre></td></tr></table>
+
<a name="IDX230"></a>
<a name="IDX231"></a>
<p>The <var>filename</var> argument is mandatory, and must not have an
@@ -181,6 +182,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@image{ridt,,1in}
</pre></td></tr></table>
+
<a name="IDX252"></a>
<p>For <code>@image</code> to work with TeX, the file <tt>`epsf.tex'</tt> must
be
installed somewhere that TeX can find it. (The standard location is
Index: texi2html/Tests/nodes_texinfo_res/Indexing-Commands.html
diff -u texi2html/Tests/nodes_texinfo_res/Indexing-Commands.html:1.19
texi2html/Tests/nodes_texinfo_res/Indexing-Commands.html:1.20
--- texi2html/Tests/nodes_texinfo_res/Indexing-Commands.html:1.19 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Indexing-Commands.html Sat Mar 25
13:26:47 2006
@@ -97,6 +97,7 @@
@cindex Specifying index entries
@cindex Creating index entries
</pre></td></tr></table>
+
<p>Each predefined index has its own indexing
command—<code>@cindex</code>
for the concept index, <code>@findex</code> for the function index, and so
on.
Index: texi2html/Tests/nodes_texinfo_res/Info-Files.html
diff -u texi2html/Tests/nodes_texinfo_res/Info-Files.html:1.17
texi2html/Tests/nodes_texinfo_res/Info-Files.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Info-Files.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Info-Files.html Sat Mar 25 13:26:47 2006
@@ -160,6 +160,7 @@
info:emacs#Dissociated%20Press
info://localhost/usr/info/emacs#Dissociated%20Press
</pre></td></tr></table>
+
<p>The <code>info</code> program itself does not follow URI's of any kind.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Info-Formatting.html
diff -u texi2html/Tests/nodes_texinfo_res/Info-Formatting.html:1.20
texi2html/Tests/nodes_texinfo_res/Info-Formatting.html:1.21
--- texi2html/Tests/nodes_texinfo_res/Info-Formatting.html:1.20 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Info-Formatting.html Sat Mar 25
13:26:47 2006
@@ -126,6 +126,7 @@
or
M-x makeinfo-buffer
</pre></td></tr></table>
+
<p>For TeX or the Info formatting commands to work, the file <em>must</em>
include a line that has <code>@setfilename</code> in its header.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Installing-Dir-Entries.html
diff -u texi2html/Tests/nodes_texinfo_res/Installing-Dir-Entries.html:1.18
texi2html/Tests/nodes_texinfo_res/Installing-Dir-Entries.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Installing-Dir-Entries.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Installing-Dir-Entries.html Sat Mar
25 13:26:47 2006
@@ -102,6 +102,7 @@
…
@end direntry
</pre></td></tr></table>
+
<p>Here's what this produces in the Info file:
</p>
<table><tr><td> </td><td><pre class="smallexample">INFO-DIR-SECTION
Texinfo documentation system
@@ -134,6 +135,7 @@
TeX
Individual utilities
</pre></td></tr></table>
+
<p>The idea is to include the `Invoking' node for every program installed
by a package under `Individual utilities', and an entry for the manual
as a whole in the appropriate other category.
Index: texi2html/Tests/nodes_texinfo_res/Invoking-Macros.html
diff -u texi2html/Tests/nodes_texinfo_res/Invoking-Macros.html:1.17
texi2html/Tests/nodes_texinfo_res/Invoking-Macros.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Invoking-Macros.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Invoking-Macros.html Sat Mar 25
13:26:47 2006
@@ -85,6 +85,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@<var>macroname</var>
{<var>arg1</var>, <var>arg2</var>, …}
</pre></td></tr></table>
+
<p>and the result will be just as if you typed the body of
<var>macroname</var> at that spot. For example:
</p>
@@ -93,10 +94,12 @@
@end macro
@foo{a, b}
</pre></td></tr></table>
+
<p>produces:
</p>
<table><tr><td> </td><td><pre class="display">Together: a & b.
</pre></td></tr></table>
+
<a name="IDX315"></a>
<p>Thus, the arguments and parameters are separated by commas and delimited
by braces; any whitespace after (but not before) a comma is ignored.
@@ -109,10 +112,12 @@
@end macro
@argless{}
</pre></td></tr></table>
+
<p>produces:
</p>
<table><tr><td> </td><td><pre class="display">No arguments here.
</pre></td></tr></table>
+
<a name="IDX316"></a>
<a name="IDX317"></a>
<p>To insert a comma, brace, or backslash in an argument, prepend a
@@ -134,10 +139,12 @@
@end macro
@bar aah
</pre></td></tr></table>
+
<p>produces:
</p>
<table><tr><td> </td><td><pre class="display">Twice: aah & aah.
</pre></td></tr></table>
+
<p>If the macro is defined to take a single argument, and is invoked with
braces, the braced text is passed as the argument, regardless of
commas. For example:
@@ -147,11 +154,13 @@
@end macro
@bar{a,b}
</pre></td></tr></table>
+
<p>produces:
</p>
<table><tr><td> </td><td><pre class="display">Twice: a,b & a,b.
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/Invoking-install_002dinfo.html
diff -u texi2html/Tests/nodes_texinfo_res/Invoking-install_002dinfo.html:1.6
texi2html/Tests/nodes_texinfo_res/Invoking-install_002dinfo.html:1.7
--- texi2html/Tests/nodes_texinfo_res/Invoking-install_002dinfo.html:1.6
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Invoking-install_002dinfo.html Sat Mar
25 13:26:47 2006
@@ -89,6 +89,7 @@
</p>
<table><tr><td> </td><td><pre class="example">install-info
[<var>option</var>]… [<var>info-file</var> [<var>dir-file</var>]]
</pre></td></tr></table>
+
<p>If <var>info-file</var> or <var>dir-file</var> are not specified, the
options
(described below) that define them must be. There are no compile-time
defaults, and standard input is never used. <code>install-info</code> can
Index: texi2html/Tests/nodes_texinfo_res/Invoking-makeinfo.html
diff -u texi2html/Tests/nodes_texinfo_res/Invoking-makeinfo.html:1.16
texi2html/Tests/nodes_texinfo_res/Invoking-makeinfo.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Invoking-makeinfo.html:1.16 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Invoking-makeinfo.html Sat Mar 25
13:26:47 2006
@@ -86,6 +86,7 @@
</p>
<table><tr><td> </td><td><pre class="example">makeinfo bison.texinfo
</pre></td></tr></table>
+
<p>(You can run a shell inside Emacs by typing <kbd>M-x shell</kbd>.)
</p>
<p>Sometimes you will want to specify options. For example, if you wish
@@ -94,6 +95,7 @@
</p>
<table><tr><td> </td><td><pre class="example">makeinfo --version
</pre></td></tr></table>
+
<p>See section <a href="makeinfo-options.html#SEC264">Options for
<code>makeinfo</code></a>, for more information.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Less-Cluttered-Menu-Entry.html
diff -u texi2html/Tests/nodes_texinfo_res/Less-Cluttered-Menu-Entry.html:1.16
texi2html/Tests/nodes_texinfo_res/Less-Cluttered-Menu-Entry.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Less-Cluttered-Menu-Entry.html:1.16
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Less-Cluttered-Menu-Entry.html Sat Mar
25 13:26:47 2006
@@ -93,6 +93,7 @@
</p>
<table><tr><td> </td><td><pre class="example">* Name: Name.
<var>description</var>
</pre></td></tr></table>
+
<p>You should use the node name for the menu entry name whenever possible,
since it reduces visual clutter in the menu.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Lists-and-Tables.html
diff -u texi2html/Tests/nodes_texinfo_res/Lists-and-Tables.html:1.23
texi2html/Tests/nodes_texinfo_res/Lists-and-Tables.html:1.24
--- texi2html/Tests/nodes_texinfo_res/Lists-and-Tables.html:1.23 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Lists-and-Tables.html Sat Mar 25
13:26:47 2006
@@ -122,7 +122,6 @@
command.
</p>
<br>
-
<p>Here is an itemized list of the different kinds of table and lists:
</p>
<ul>
@@ -137,7 +136,6 @@
</li></ul>
<br>
-
<p>Here is an enumerated list with the same items:
</p>
<ol>
@@ -152,7 +150,6 @@
</li></ol>
<br>
-
<p>And here is a two-column table with the same items and their
@-commands:
</p>
Index: texi2html/Tests/nodes_texinfo_res/Macro-Details.html
diff -u texi2html/Tests/nodes_texinfo_res/Macro-Details.html:1.18
texi2html/Tests/nodes_texinfo_res/Macro-Details.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Macro-Details.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Macro-Details.html Sat Mar 25
13:26:47 2006
@@ -114,6 +114,7 @@
\gdef\ctorx#1,#2,{\def#1{something involving #2 somehow}}
@end tex
</pre></td></tr></table>
+
</li><li>
It is best to avoid comments inside macro definitions.
Index: texi2html/Tests/nodes_texinfo_res/Master-Menu-Parts.html
diff -u texi2html/Tests/nodes_texinfo_res/Master-Menu-Parts.html:1.18
texi2html/Tests/nodes_texinfo_res/Master-Menu-Parts.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Master-Menu-Parts.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Master-Menu-Parts.html Sat Mar 25
13:26:47 2006
@@ -138,6 +138,7 @@
@end menu
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/Menu-Example.html
diff -u texi2html/Tests/nodes_texinfo_res/Menu-Example.html:1.17
texi2html/Tests/nodes_texinfo_res/Menu-Example.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Menu-Example.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Menu-Example.html Sat Mar 25 13:26:47 2006
@@ -95,6 +95,7 @@
* menu entry name: Node name. A short description.
* Node name:: This form is preferred.
</pre></td></tr></table>
+
<p>Here is an example as you might see it in a Texinfo file:
</p>
<table><tr><td> </td><td><pre class="example">@menu
@@ -115,6 +116,7 @@
* Multiples: Buffers. Multiple buffers; editing
several files at once.
</pre></td></tr></table>
+
<p>In this example, the menu has two entries. <samp>`Files'</samp> is both a
menu
entry name and the name of the node referred to by that name.
<samp>`Multiples'</samp> is the menu entry name; it refers to the node named
Index: texi2html/Tests/nodes_texinfo_res/Menu-Parts.html
diff -u texi2html/Tests/nodes_texinfo_res/Menu-Parts.html:1.18
texi2html/Tests/nodes_texinfo_res/Menu-Parts.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Menu-Parts.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Menu-Parts.html Sat Mar 25 13:26:47 2006
@@ -97,6 +97,7 @@
</p>
<table><tr><td> </td><td><pre class="example">*
<var>menu-entry-name</var>: <var>node-name</var>. <var>description</var>
</pre></td></tr></table>
+
<p>Follow the menu entry name with a single colon and follow the node name
with tab, comma, period, or newline.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Menus.html
diff -u texi2html/Tests/nodes_texinfo_res/Menus.html:1.19
texi2html/Tests/nodes_texinfo_res/Menus.html:1.20
--- texi2html/Tests/nodes_texinfo_res/Menus.html:1.19 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Menus.html Sat Mar 25 13:26:47 2006
@@ -138,6 +138,7 @@
@heading Menus Need Short Nodes
@end ifinfo
</pre></td></tr></table>
+
<p>The Texinfo file for this document contains a number of
examples of this procedure; one is at the beginning of this chapter.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Minimum.html
diff -u texi2html/Tests/nodes_texinfo_res/Minimum.html:1.19
texi2html/Tests/nodes_texinfo_res/Minimum.html:1.20
--- texi2html/Tests/nodes_texinfo_res/Minimum.html:1.19 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Minimum.html Sat Mar 25 13:26:47 2006
@@ -100,8 +100,8 @@
</p>
<table><tr><td> </td><td><pre class="example">@bye
</pre></td></tr></table>
-<a name="IDX19"></a>
+<a name="IDX19"></a>
<p>Here's an explanation:
</p>
<ul>
Index: texi2html/Tests/nodes_texinfo_res/Multiple-Spaces.html
diff -u texi2html/Tests/nodes_texinfo_res/Multiple-Spaces.html:1.16
texi2html/Tests/nodes_texinfo_res/Multiple-Spaces.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Multiple-Spaces.html:1.16 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Multiple-Spaces.html Sat Mar 25
13:26:47 2006
@@ -102,10 +102,12 @@
</p><table><tr><td> </td><td><pre class="example">Spacey@ @ @ @
example.
</pre></td></tr></table>
+
<p>produces
</p>
<table><tr><td> </td><td><pre
class="example">Spacey example.
</pre></td></tr></table>
+
<p>Other possible uses of <code>@<kbd>SPACE</kbd></code> have been subsumed by
<code>@multitable</code> (see section <a
href="Multi_002dcolumn-Tables.html#SEC163">Multi-column Tables</a>).
</p>
Index: texi2html/Tests/nodes_texinfo_res/Multitable-Column-Widths.html
diff -u texi2html/Tests/nodes_texinfo_res/Multitable-Column-Widths.html:1.17
texi2html/Tests/nodes_texinfo_res/Multitable-Column-Widths.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Multitable-Column-Widths.html:1.17
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Multitable-Column-Widths.html Sat Mar
25 13:26:47 2006
@@ -95,6 +95,7 @@
<table><tr><td> </td><td><pre class="example">@multitable
@columnfractions .33 .33 .33
</pre></td></tr></table>
+
<p>The fractions need not add up exactly to 1.0, as these do
not. This allows you to produce tables that do not need the full line
length. You can use a leading zero if you wish.
Index: texi2html/Tests/nodes_texinfo_res/Multitable-Rows.html
diff -u texi2html/Tests/nodes_texinfo_res/Multitable-Rows.html:1.16
texi2html/Tests/nodes_texinfo_res/Multitable-Rows.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Multitable-Rows.html:1.16 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Multitable-Rows.html Sat Mar 25
13:26:47 2006
@@ -105,6 +105,7 @@
split that window.
@end multitable
</pre></td></tr></table>
+
<p>produces:
</p>
<table>
Index: texi2html/Tests/nodes_texinfo_res/New-Indices.html
diff -u texi2html/Tests/nodes_texinfo_res/New-Indices.html:1.18
texi2html/Tests/nodes_texinfo_res/New-Indices.html:1.19
--- texi2html/Tests/nodes_texinfo_res/New-Indices.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/New-Indices.html Sat Mar 25 13:26:47 2006
@@ -88,11 +88,13 @@
</p>
<table><tr><td> </td><td><pre class="example">@defindex <var>name</var>
</pre></td></tr></table>
+
<p>The name of an index should be a two letter word, such as <samp>`au'</samp>.
For example:
</p>
<table><tr><td> </td><td><pre class="example">@defindex au
</pre></td></tr></table>
+
<p>This defines a new index, called the <samp>`au'</samp> index. At the same
time, it creates a new indexing command, <code>@auindex</code>, that you
can use to make index entries. Use the new indexing command just as
@@ -120,6 +122,7 @@
@printindex au
</pre></td></tr></table>
+
<p>The <code>@defcodeindex</code> is like the <code>@defindex</code> command,
except
that, in the printed output, it prints entries in an <code>@code</code> font
instead of a roman font. Thus, it parallels the <code>@findex</code> command
Index: texi2html/Tests/nodes_texinfo_res/Node-Line-Requirements.html
diff -u texi2html/Tests/nodes_texinfo_res/Node-Line-Requirements.html:1.21
texi2html/Tests/nodes_texinfo_res/Node-Line-Requirements.html:1.22
--- texi2html/Tests/nodes_texinfo_res/Node-Line-Requirements.html:1.21 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Node-Line-Requirements.html Sat Mar
25 13:26:47 2006
@@ -119,6 +119,7 @@
@section @code{@@chapter}
@findex chapter
</pre></td></tr></table>
+
</li><li>
<a name="IDX98"></a>
You cannot use parentheses in node names, because a node name such as
@@ -144,6 +145,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">unnumberedsec
appendixsec heading
</pre></td></tr></table>
+
<a name="IDX105"></a>
</li><li>
Case is significant.
Index: texi2html/Tests/nodes_texinfo_res/Node-Menu-Illustration.html
diff -u texi2html/Tests/nodes_texinfo_res/Node-Menu-Illustration.html:1.17
texi2html/Tests/nodes_texinfo_res/Node-Menu-Illustration.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Node-Menu-Illustration.html:1.17 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Node-Menu-Illustration.html Sat Mar
25 13:26:47 2006
@@ -100,6 +100,7 @@
Section Section Section Section Section Section
1.1 1.2 2.1 2.2 3.1 3.2
</pre></td></tr></table>
+
<p>The fully-written command to start Chapter 2 would be this:
</p>
<table><tr><td> </td><td><pre class="example">@node Chapter 2,
Chapter 3, Chapter 1, Top
@@ -133,11 +134,13 @@
* Sect. 2.2::
@end menu
</pre></td></tr></table>
+
<p>Write the node for Sect. 2.1 like this:
</p>
<table><tr><td> </td><td><pre class="example"> @node Sect. 2.1,
Sect. 2.2, Chapter 2, Chapter 2
@comment node-name, next, previous, up
</pre></td></tr></table>
+
<p>In Info format, the `Next' and `Previous' pointers of a node usually
lead to other nodes at the same level—from chapter to chapter or from
section to section (sometimes, as shown, the `Previous' pointer points
@@ -163,6 +166,7 @@
@cindex File ending
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="Two-Paths.html#SEC86"
title="Previous section in reading order"> < </a>]</td>
Index: texi2html/Tests/nodes_texinfo_res/Not-Ending-a-Sentence.html
diff -u texi2html/Tests/nodes_texinfo_res/Not-Ending-a-Sentence.html:1.18
texi2html/Tests/nodes_texinfo_res/Not-Ending-a-Sentence.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Not-Ending-a-Sentence.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Not-Ending-a-Sentence.html Sat Mar
25 13:26:47 2006
@@ -108,7 +108,6 @@
The s.o.p. has three parts …
</p></blockquote>
-
<p>(Incidentally, <samp>`s.o.p.'</samp> is an abbreviation for “Standard
Operating
Procedure”.)
</p>
Index: texi2html/Tests/nodes_texinfo_res/Obtaining-TeX.html
diff -u texi2html/Tests/nodes_texinfo_res/Obtaining-TeX.html:1.15
texi2html/Tests/nodes_texinfo_res/Obtaining-TeX.html:1.16
--- texi2html/Tests/nodes_texinfo_res/Obtaining-TeX.html:1.15 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Obtaining-TeX.html Sat Mar 25
13:26:47 2006
@@ -89,6 +89,7 @@
</p><table><tr><td> </td><td><pre class="example"><a
href="ftp://tug.org/tex/unixtex.ftp">ftp://tug.org/tex/unixtex.ftp</a>
<a href="http://tug.org/unixtex.ftp">http://tug.org/unixtex.ftp</a>
</pre></td></tr></table>
+
<p>The Free Software Foundation provides a core distribution on its Source
Code CD-ROM suitable for printing Texinfo manuals. To order it, contact:
</p>
@@ -103,6 +104,7 @@
0066-3382-0158 (IDC)
Electronic mail: <code>address@hidden</code>
</pre></td></tr></table>
+
<p>Many other TeX distributions are available; see
<a href="http://tug.org/">http://tug.org/</a>.
</p>
Index: texi2html/Tests/nodes_texinfo_res/One-Argument.html
diff -u texi2html/Tests/nodes_texinfo_res/One-Argument.html:1.16
texi2html/Tests/nodes_texinfo_res/One-Argument.html:1.17
--- texi2html/Tests/nodes_texinfo_res/One-Argument.html:1.16 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/One-Argument.html Sat Mar 25 13:26:47 2006
@@ -85,7 +85,6 @@
output that the Info readers can use to jump to the reference; TeX
produces output that specifies the page and section number for you.
</p>
-
<p>For example,
</p>
<table><tr><td> </td><td><pre class="example">@xref{Tropical Storms}.
@@ -101,7 +100,6 @@
<blockquote><p>See Section 3.1 [Tropical Storms], page 24.
</p></blockquote>
-
<p>(Note that in the preceding example the closing brace is followed by a
period.)
</p>
@@ -120,7 +118,6 @@
<blockquote><p>See Section 3.1 [Tropical Storms], page 24, for more info.
</p></blockquote>
-
<p>(Note that in the preceding example the closing brace is followed by a
comma, and then by the clause, which is followed by a period.)
</p>
Index: texi2html/Tests/nodes_texinfo_res/Optional-Arguments.html
diff -u texi2html/Tests/nodes_texinfo_res/Optional-Arguments.html:1.18
texi2html/Tests/nodes_texinfo_res/Optional-Arguments.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Optional-Arguments.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Optional-Arguments.html Sat Mar 25
13:26:47 2006
@@ -104,7 +104,6 @@
</dl>
</blockquote>
-
<p>In this example, the arguments <var>from</var> and <var>to</var> are
optional,
but must both be present or both absent. If they are present,
<var>inc</var> may optionally be specified as well. These arguments are
Index: texi2html/Tests/nodes_texinfo_res/Other-Info-Directories.html
diff -u texi2html/Tests/nodes_texinfo_res/Other-Info-Directories.html:1.20
texi2html/Tests/nodes_texinfo_res/Other-Info-Directories.html:1.21
--- texi2html/Tests/nodes_texinfo_res/Other-Info-Directories.html:1.20 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Other-Info-Directories.html Sat Mar
25 13:26:47 2006
@@ -124,6 +124,7 @@
(cons (expand-file-name "/home/bob/info")
Info-directory-list))
</pre></td></tr></table>
+
<p>This tells Emacs to merge the system <tt>`dir'</tt> file with the
<tt>`dir'</tt>
file in <tt>`/home/bob/info'</tt>. Thus, Info will list the
<tt>`/home/bob/info/info-test'</tt> file as a menu entry in the
@@ -152,6 +153,7 @@
<table><tr><td> </td><td><pre class="smallexample">setenv INFOPATH
.:~/info:/usr/local/emacs/info
</pre></td></tr></table>
+
</li><li>
In a <tt>`.profile'</tt> file, you would achieve the same effect by
writing:
@@ -159,13 +161,14 @@
<table><tr><td> </td><td><pre
class="smallexample">INFOPATH=.:$HOME/info:/usr/local/emacs/info
export INFOPATH
</pre></td></tr></table>
+
</li><li>
<a name="IDX415"></a>
In a <tt>`autoexec.bat'</tt> file, you write this command<a name="DOCF12"
href="texinfo_fot.html#FOOT12">(12)</a>:
<table><tr><td> </td><td><pre class="smallexample">set
INFOPATH=.;%HOME%/info;c:/usr/local/emacs/info
-</pre></td></tr></table></li></ul>
-
+</pre></td></tr></table>
+</li></ul>
<p>The <samp>`.'</samp> indicates the current directory as usual. Emacs uses
the
<code>INFOPATH</code> environment variable to initialize the value of Emacs's
Index: texi2html/Tests/nodes_texinfo_res/Other-Info-Files.html
diff -u texi2html/Tests/nodes_texinfo_res/Other-Info-Files.html:1.17
texi2html/Tests/nodes_texinfo_res/Other-Info-Files.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Other-Info-Files.html:1.17 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Other-Info-Files.html Sat Mar 25
13:26:47 2006
@@ -93,6 +93,7 @@
* <var>second-entry-name</var>:(<var>filename</var>)<var>second-node</var>.
<var>description</var>
@end menu
</pre></td></tr></table>
+
<p>For example, to refer directly to the <samp>`Outlining'</samp> and
<samp>`Rebinding'</samp> nodes in the <cite>Emacs Manual</cite>, you would
write a
menu like this:
@@ -104,6 +105,7 @@
meaning of a key.
@end menu
</pre></td></tr></table>
+
<p>If you do not list the node name, but only name the file, then Info
presumes that you are referring to the `Top' node.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Other-Updating-Commands.html
diff -u texi2html/Tests/nodes_texinfo_res/Other-Updating-Commands.html:1.18
texi2html/Tests/nodes_texinfo_res/Other-Updating-Commands.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Other-Updating-Commands.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Other-Updating-Commands.html Sat Mar
25 13:26:47 2006
@@ -103,6 +103,7 @@
</p>
<table><tr><td> </td><td><pre class="example">C-x h C-u M-x
texinfo-insert-node-lines
</pre></td></tr></table>
+
<p>This command inserts titles as node names in <code>@node</code> lines; the
<code>texinfo-start-menu-description</code> command (see section <a
href="Inserting.html#SEC24">Inserting Frequently Used Commands</a>) inserts
titles as descriptions in
menu entries, a different action. However, in both cases, you need to
Index: texi2html/Tests/nodes_texinfo_res/Overfull-hboxes.html
diff -u texi2html/Tests/nodes_texinfo_res/Overfull-hboxes.html:1.17
texi2html/Tests/nodes_texinfo_res/Overfull-hboxes.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Overfull-hboxes.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Overfull-hboxes.html Sat Mar 25
13:26:47 2006
@@ -88,8 +88,8 @@
</p>
<table><tr><td> </td><td><pre class="example">Overfull @hbox (20.76302pt
too wide)
</pre></td></tr></table>
-<a name="IDX343"></a>
+<a name="IDX343"></a>
<p>(In TeX, lines are in “horizontal boxes”, hence the term,
“hbox”.
<samp>address@hidden'</samp> is a TeX primitive not needed in the Texinfo
language.)
</p>
@@ -138,6 +138,7 @@
<table><tr><td> </td><td><pre class="example">@finalout
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="Preparing-for-TeX.html#SEC253"
title="Previous section in reading order"> < </a>]</td>
Index: texi2html/Tests/nodes_texinfo_res/Point-Glyph.html
diff -u texi2html/Tests/nodes_texinfo_res/Point-Glyph.html:1.18
texi2html/Tests/nodes_texinfo_res/Point-Glyph.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Point-Glyph.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Point-Glyph.html Sat Mar 25 13:26:47 2006
@@ -101,6 +101,7 @@
---------- Buffer: foo ----------
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="example">(insert "changed
")
⇒ nil
---------- Buffer: foo ----------
@@ -108,6 +109,7 @@
---------- Buffer: foo ----------
</pre></td></tr></table>
+
<p>In a Texinfo source file, the example is written like this:
</p>
<table><tr><td> </td><td><pre class="example">@example
@@ -123,6 +125,7 @@
@end example
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/Predefined-Indices.html
diff -u texi2html/Tests/nodes_texinfo_res/Predefined-Indices.html:1.18
texi2html/Tests/nodes_texinfo_res/Predefined-Indices.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Predefined-Indices.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Predefined-Indices.html Sat Mar 25
13:26:47 2006
@@ -105,7 +105,6 @@
header files).
</li></ul>
-
<p>Not every manual needs all of these, and most manuals use two or three
of them. This manual has two indices: a
concept index and an @-command index (that is actually the function
Index: texi2html/Tests/nodes_texinfo_res/Preparing-for-TeX.html
diff -u texi2html/Tests/nodes_texinfo_res/Preparing-for-TeX.html:1.18
texi2html/Tests/nodes_texinfo_res/Preparing-for-TeX.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Preparing-for-TeX.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Preparing-for-TeX.html Sat Mar 25
13:26:47 2006
@@ -136,12 +136,14 @@
</p>
<table><tr><td> </td><td><pre class="example">setenv TEXINPUTS
.:/home/me/mylib:/usr/lib/tex/macros
</pre></td></tr></table>
+
<p>In a <tt>`.profile'</tt> file, you could use the following <code>sh</code>
command
sequence:
</p>
<table><tr><td> </td><td><pre
class="example">TEXINPUTS=.:/home/me/mylib:/usr/lib/tex/macros
export TEXINPUTS
</pre></td></tr></table>
+
<p>On MS-DOS/MS-Windows, you would say it like this<a name="DOCF10"
href="texinfo_fot.html#FOOT10">(10)</a>:
</p>
<table><tr><td> </td><td><pre class="example">set
TEXINPUTS=.;d:/home/me/mylib;c:/usr/lib/tex/macros
@@ -150,7 +152,6 @@
<p>It is customary for DOS/Windows users to put such commands in the
<tt>`autoexec.bat'</tt> file, or in the Windows Registry.
</p>
-
<p>These settings would cause TeX to look for <tt>`\input'</tt> file first
in the current directory, indicated by the <samp>`.'</samp>, then in a
hypothetical user's <tt>`me/mylib'</tt> directory, and finally in a system
@@ -165,6 +166,7 @@
</p>
<table><tr><td> </td><td><pre class="example">initex texinfo @dump
</pre></td></tr></table>
+
<p>(<code>dump</code> is a TeX primitive.) Then, move <tt>`texinfo.fmt'</tt>
to
wherever your <code>.fmt</code> files are found; typically, this will be in the
subdirectory <tt>`web2c'</tt> of your TeX installation.
Index: texi2html/Tests/nodes_texinfo_res/Print-Glyph.html
diff -u texi2html/Tests/nodes_texinfo_res/Print-Glyph.html:1.18
texi2html/Tests/nodes_texinfo_res/Print-Glyph.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Print-Glyph.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Print-Glyph.html Sat Mar 25 13:26:47 2006
@@ -107,6 +107,7 @@
@end lisp
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/Print-with-lpr.html
diff -u texi2html/Tests/nodes_texinfo_res/Print-with-lpr.html:1.18
texi2html/Tests/nodes_texinfo_res/Print-with-lpr.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Print-with-lpr.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Print-with-lpr.html Sat Mar 25
13:26:47 2006
@@ -102,6 +102,7 @@
lpr -d bison.dvi
# or perhaps dvips bison.dvi -o
</pre></td></tr></table>
+
<a name="IDX330"></a>
<a name="IDX331"></a>
<a name="IDX332"></a>
@@ -126,6 +127,7 @@
<table><tr><td> </td><td><pre class="example">lpr -Qdvi
-hprint.server.domain bison.dvi
</pre></td></tr></table>
+
</li><li> Convert the DVI file to a Postscript or PCL file and send it to your
local printer. See <a
href="../dvips/dvips-invocation.html#dvips-invocation">(dvips)dvips
invocation</a> section `dvips invocation' in <cite>Dvips</cite>, and the man
pages for <code>dvilj</code>, for detailed description of these tools. Once
Index: texi2html/Tests/nodes_texinfo_res/Raise_002flower-sections.html
diff -u texi2html/Tests/nodes_texinfo_res/Raise_002flower-sections.html:1.5
texi2html/Tests/nodes_texinfo_res/Raise_002flower-sections.html:1.6
--- texi2html/Tests/nodes_texinfo_res/Raise_002flower-sections.html:1.5 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Raise_002flower-sections.html Sat Mar
25 13:26:47 2006
@@ -105,6 +105,7 @@
@heading @chapheading,
etc.
</pre></td></tr></table>
+
<p><code>@lowersections</code> lowers a command one level in the chapter
structuring hierarchy:
</p>
@@ -115,6 +116,7 @@
@heading @subheading,
etc.
</pre></td></tr></table>
+
<p>An <code>@raisesections</code> or <code>@lowersections</code> command
changes only
those structuring commands that follow the command in the Texinfo file.
Write an <code>@raisesections</code> or <code>@lowersections</code> command on
a
@@ -127,6 +129,7 @@
@include somefile.texi
@raisesections
</pre></td></tr></table>
+
<p>Without the <code>@raisesections</code>, all the subsequent sections in your
document will be lowered.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Requirements-Summary.html
diff -u texi2html/Tests/nodes_texinfo_res/Requirements-Summary.html:1.16
texi2html/Tests/nodes_texinfo_res/Requirements-Summary.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Requirements-Summary.html:1.16 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Requirements-Summary.html Sat Mar 25
13:26:47 2006
@@ -95,6 +95,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@bye
</pre></td></tr></table>
+
<p>Strictly speaking, these lines are all a Texinfo file needs to be
processed successfully by TeX.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Sample-Beginning.html
diff -u texi2html/Tests/nodes_texinfo_res/Sample-Beginning.html:1.16
texi2html/Tests/nodes_texinfo_res/Sample-Beginning.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Sample-Beginning.html:1.16 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Sample-Beginning.html Sat Mar 25
13:26:47 2006
@@ -144,6 +144,7 @@
…
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/Sample-Function-Definition.html
diff -u texi2html/Tests/nodes_texinfo_res/Sample-Function-Definition.html:1.17
texi2html/Tests/nodes_texinfo_res/Sample-Function-Definition.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Sample-Function-Definition.html:1.17
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Sample-Function-Definition.html Sat Mar
25 13:26:47 2006
@@ -114,6 +114,7 @@
(apply 'append '((a b c) nil (x y z) nil))
⇒ (a b c x y z)
</pre></td></tr></table>
+
<p>An interesting example of using <code>apply</code> is found in the
description
of <code>mapcar</code>.
</p></dd></dl>
Index: texi2html/Tests/nodes_texinfo_res/Sample-Include-File.html
diff -u texi2html/Tests/nodes_texinfo_res/Sample-Include-File.html:1.18
texi2html/Tests/nodes_texinfo_res/Sample-Include-File.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Sample-Include-File.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Sample-Include-File.html Sat Mar 25
13:26:47 2006
@@ -114,6 +114,7 @@
@bye
</pre></td></tr></table>
+
<p>An included file, such as <tt>`foo.texinfo'</tt>, might look like this:
</p>
<table><tr><td> </td><td><pre class="example">@node First, Second, , Top
@@ -121,6 +122,7 @@
Contents of first chapter …
</pre></td></tr></table>
+
<p>The full contents of <tt>`concept-index.texinfo'</tt> might be as simple as
this:
</p>
<table><tr><td> </td><td><pre class="example">@node Concept Index
@@ -128,6 +130,7 @@
@printindex cp
</pre></td></tr></table>
+
<p>The outer Texinfo source file for <cite>The GNU Emacs Lisp Reference
Manual</cite> is named <tt>`elisp.texi'</tt>. This outer file contains a
master
menu with 417 entries and a list of 41 <code>@include</code>
Index: texi2html/Tests/nodes_texinfo_res/Short-Sample-Texinfo-File.html
diff -u texi2html/Tests/nodes_texinfo_res/Short-Sample-Texinfo-File.html:1.15
texi2html/Tests/nodes_texinfo_res/Short-Sample-Texinfo-File.html:1.16
--- texi2html/Tests/nodes_texinfo_res/Short-Sample-Texinfo-File.html:1.15
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Short-Sample-Texinfo-File.html Sat Mar
25 13:26:47 2006
@@ -151,6 +151,7 @@
@bye
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/Short-Sample.html
diff -u texi2html/Tests/nodes_texinfo_res/Short-Sample.html:1.18
texi2html/Tests/nodes_texinfo_res/Short-Sample.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Short-Sample.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Short-Sample.html Sat Mar 25 13:26:47 2006
@@ -98,7 +98,6 @@
<a name="SEC13"></a>
<h3 class="subheading"> Part 1: Header </h3>
-
<p>The header does not appear in either the Info file or the
printed output. It sets various parameters, including the
name of the Info file and the title used in the header.
@@ -109,10 +108,10 @@
@settitle Sample Manual 1.0
@c %**end of header
</pre></td></tr></table>
+
<a name="SEC14"></a>
<h3 class="subheading"> Part 2: Summary Description and Copyright </h3>
-
<p>A real manual includes more text here, according to the license under
which it is distributed. See section <a
href="GNU-Sample-Texts.html#SEC296">GNU Sample Texts</a>.
</p>
@@ -122,10 +121,10 @@
Copyright @copyright{} 2002 Free Software Foundation, Inc.
@end copying
</pre></td></tr></table>
+
<a name="SEC15"></a>
<h3 class="subheading"> Part 3: Titlepage, Contents, Copyright </h3>
-
<p>The titlepage segment does not appear in the online output, only in the
printed manual. We use the <code>@insertcopying</code> command to
include the permission text from the previous section, instead of
@@ -144,10 +143,10 @@
@c Output the table of contents at the beginning.
@contents
</pre></td></tr></table>
+
<a name="SEC16"></a>
<h3 class="subheading"> Part 4: `Top' Node and Master Menu </h3>
-
<p>The `Top' node contains the master menu for the Info file. Since a
printed manual uses a table of contents rather than a menu, the master
menu appears only in online output. We also include the copying text
@@ -158,6 +157,7 @@
@node Top
@end ifnottex
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="example">@insertcopying
@menu
@@ -167,10 +167,10 @@
@end menu
</pre></td></tr></table>
+
<a name="SEC17"></a>
<h3 class="subheading"> Part 5: The Body of the Document </h3>
-
<p>The body segment contains all the text of the document, but not the
indices or table of contents. This example illustrates a node and a
chapter containing an enumerated list.
@@ -194,10 +194,10 @@
@end enumerate
</pre></td></tr></table>
+
<a name="SEC18"></a>
<h3 class="subheading"> Part 6: The End of the Document </h3>
-
<p>The end segment contains commands for generating an index in a node and
unnumbered chapter of its own, and the <code>@bye</code> command that marks
the end of the document.
@@ -210,6 +210,7 @@
@bye
</pre></td></tr></table>
+
<a name="SEC19"></a>
<h3 class="subheading"> Some Results </h3>
Index: texi2html/Tests/nodes_texinfo_res/Smallcaps.html
diff -u texi2html/Tests/nodes_texinfo_res/Smallcaps.html:1.17
texi2html/Tests/nodes_texinfo_res/Smallcaps.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Smallcaps.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Smallcaps.html Sat Mar 25 13:26:47 2006
@@ -92,6 +92,7 @@
</p>
<table><tr><td> </td><td><pre class="display">The ACM and IEEE are
technical societies.
</pre></td></tr></table>
+
<p>TeX typesets the small caps font in a manner that prevents the
letters from `jumping out at you on the page'. This makes small caps
text easier to read than text in all upper case—but it's usually
Index: texi2html/Tests/nodes_texinfo_res/Start-of-Header.html
diff -u texi2html/Tests/nodes_texinfo_res/Start-of-Header.html:1.17
texi2html/Tests/nodes_texinfo_res/Start-of-Header.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Start-of-Header.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Start-of-Header.html Sat Mar 25
13:26:47 2006
@@ -84,6 +84,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@c %**start of header
</pre></td></tr></table>
+
<p>Write the start-of-header line on the second line of a Texinfo file.
Follow the start-of-header line with <code>@setfilename</code> and
<code>@settitle</code> lines and, optionally, with other commands that
Index: texi2html/Tests/nodes_texinfo_res/Tagifying.html
diff -u texi2html/Tests/nodes_texinfo_res/Tagifying.html:1.17
texi2html/Tests/nodes_texinfo_res/Tagifying.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Tagifying.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Tagifying.html Sat Mar 25 13:26:47 2006
@@ -101,6 +101,7 @@
M-x Info-tagify
M-x Info-validate
</pre></td></tr></table>
+
<p>After you have validated the node structure, you can rerun
<code>texinfo-format-buffer</code> in the normal way so it will construct a
tag table and split the file automatically, or you can make the tag
Index: texi2html/Tests/nodes_texinfo_res/Texinfo-File-Header.html
diff -u texi2html/Tests/nodes_texinfo_res/Texinfo-File-Header.html:1.16
texi2html/Tests/nodes_texinfo_res/Texinfo-File-Header.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Texinfo-File-Header.html:1.16 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Texinfo-File-Header.html Sat Mar 25
13:26:47 2006
@@ -102,6 +102,7 @@
@settitle Sample Manual 1.0
@c %**end of header
</pre></td></tr></table>
+
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top"><a href="First-Line.html#SEC44">3.2.1 The
First Line of a Texinfo File</a></td><td> </td><td align="left"
valign="top"> The first line of a Texinfo file.
</td></tr>
Index: texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Printing.html
diff -u texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Printing.html:1.18
texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Printing.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Printing.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Printing.html Sat Mar
25 13:26:47 2006
@@ -149,6 +149,7 @@
C-c C-t C-p Print the DVI file.
C-c C-t C-q Display the printer queue.
</pre></td></tr></table>
+
<p>The Texinfo mode TeX formatting commands start a subshell in Emacs
called the <tt>`*tex-shell*'</tt>. The <code>texinfo-tex-command</code>,
<code>texinfo-texindex-command</code>, and <code>tex-dvi-print-command</code>
@@ -173,6 +174,7 @@
tex-dvi-print-command "lpr -d"
tex-show-queue-command "lpq"
</pre></td></tr></table>
+
<p>You can change the values of these variables with the <kbd>M-x
edit-options</kbd> command (see <a
href="../emacs/Edit-Options.html#Edit-Options">(emacs)Edit Options</a> section
`Editing Variable Values' in <cite>The GNU Emacs Manual</cite>), with the
<kbd>M-x set-variable</kbd> command
(see <a href="../emacs/Examining.html#Examining">(emacs)Examining</a> section
`Examining and Setting Variables' in <cite>The GNU Emacs Manual</cite>), or
with your <tt>`.emacs'</tt> initialization file
Index: texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Summary.html
diff -u texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Summary.html:1.18
texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Summary.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Summary.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Texinfo-Mode-Summary.html Sat Mar 25
13:26:47 2006
@@ -108,6 +108,7 @@
in the space for the description
in a menu entry line.
</pre></td></tr></table>
+
<a name="SEC34"></a>
<h3 class="subheading"> Show Structure </h3>
@@ -116,6 +117,7 @@
</p>
<table><tr><td> </td><td><pre class="example">C-c C-s List all
the headings.
</pre></td></tr></table>
+
<a name="SEC35"></a>
<h3 class="subheading"> The Master Update Command </h3>
@@ -130,6 +132,7 @@
create or update all nodes and regular
menus, and then create a master menu.
</pre></td></tr></table>
+
<a name="SEC36"></a>
<h3 class="subheading"> Update Pointers </h3>
@@ -140,6 +143,7 @@
<table><tr><td> </td><td><pre class="example">C-c C-u C-n Update a
node.
C-c C-u C-e Update every node in the buffer.
</pre></td></tr></table>
+
<a name="SEC37"></a>
<h3 class="subheading"> Update Menus </h3>
@@ -158,6 +162,7 @@
first create or update all nodes and
then create or update all menus.
</pre></td></tr></table>
+
<a name="SEC38"></a>
<h3 class="subheading"> Format for Info </h3>
@@ -169,7 +174,6 @@
<code>makeinfo</code> program are invoked by typing <kbd>C-c C-m</kbd> and then
either <kbd>C-r</kbd> for a region or <kbd>C-b</kbd> for the whole buffer.
</p>
-
<p>Use the <code>texinfo-format…</code> commands:
</p>
<table><tr><td> </td><td><pre class="example">C-c C-e C-r Format the
region.
@@ -183,6 +187,7 @@
C-c C-m C-l Recenter the <code>makeinfo</code> output buffer.
C-c C-m C-k Kill the <code>makeinfo</code> formatting job.
</pre></td></tr></table>
+
<a name="SEC39"></a>
<h3 class="subheading"> Typeset and Print </h3>
@@ -201,6 +206,7 @@
C-c C-t C-x Quit a currently stopped TeX formatting job.
C-c C-t C-l Recenter the output buffer.
</pre></td></tr></table>
+
<a name="SEC40"></a>
<h3 class="subheading"> Other Updating Commands </h3>
@@ -225,6 +231,7 @@
Insert node pointers in strict sequence.
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="Printing.html#SEC31"
title="Previous section in reading order"> < </a>]</td>
Index: texi2html/Tests/nodes_texinfo_res/Three-Arguments.html
diff -u texi2html/Tests/nodes_texinfo_res/Three-Arguments.html:1.17
texi2html/Tests/nodes_texinfo_res/Three-Arguments.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Three-Arguments.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Three-Arguments.html Sat Mar 25
13:26:47 2006
@@ -99,7 +99,6 @@
examples, a clause follows a terminating comma.
</p>
-
<p>The template is like this:
</p>
<table><tr><td> </td><td><pre class="example">@xref{<var>node-name</var>,
<var>cross-reference-name</var>, <var>title-or-topic</var>}.
@@ -153,6 +152,7 @@
for more information.
@xref{Regexp, , Regular Expressions as Patterns}.
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="Two-Arguments.html#SEC111"
title="Previous section in reading order"> < </a>]</td>
Index: texi2html/Tests/nodes_texinfo_res/Tips.html
diff -u texi2html/Tests/nodes_texinfo_res/Tips.html:1.22
texi2html/Tests/nodes_texinfo_res/Tips.html:1.23
--- texi2html/Tests/nodes_texinfo_res/Tips.html:1.22 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Tips.html Sat Mar 25 13:26:47 2006
@@ -193,6 +193,7 @@
@noindent
On the other hand, …
</pre></td></tr></table>
+
<p>Insert blank lines before and after <code>@itemize</code> …
<code>@end
itemize</code> and <code>@enumerate</code> … <code>@end
enumerate</code> in the
same way.
@@ -286,7 +287,6 @@
version-controlled file corresponding to the current buffer.
</p></blockquote>
-
<p>In this case, the text should be formatted with
<code>@table</code>, <code>@item</code>, and <code>@itemx</code>, to create a
table.
</p>
@@ -300,6 +300,7 @@
<table><tr><td> </td><td><pre class="example">The main function is
@code{vc-next-action}, …
</pre></td></tr></table>
+
</li><li>
Avoid putting letters such as <samp>`s'</samp> immediately after an
<samp>address@hidden'</samp>. Such letters look bad.
@@ -398,6 +399,7 @@
dld_init (path)
char *path;
</pre></td></tr></table>
+
<p>Also, it is best to avoid writing <code>#include</code> above the
declaration just to indicate that the function is declared in a
header file. The practice may give the misimpression that the
Index: texi2html/Tests/nodes_texinfo_res/Top-Node-Example.html
diff -u texi2html/Tests/nodes_texinfo_res/Top-Node-Example.html:1.16
texi2html/Tests/nodes_texinfo_res/Top-Node-Example.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Top-Node-Example.html:1.16 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Top-Node-Example.html Sat Mar 25
13:26:47 2006
@@ -99,6 +99,7 @@
@end menu
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/Top-Node-Naming.html
diff -u texi2html/Tests/nodes_texinfo_res/Top-Node-Naming.html:1.18
texi2html/Tests/nodes_texinfo_res/Top-Node-Naming.html:1.19
--- texi2html/Tests/nodes_texinfo_res/Top-Node-Naming.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Top-Node-Naming.html Sat Mar 25
13:26:47 2006
@@ -89,7 +89,6 @@
entry for the third argument to the <code>@xref</code> command.
</p>
-
<p>Thus, to make a cross reference to <cite>The GNU Make Manual</cite>,
write:
</p>
@@ -106,7 +105,6 @@
<blockquote><p>See section “Overview” in <i>The GNU Make
Manual</i>.
</p></blockquote>
-
<p>In this example, <samp>`Top'</samp> is the name of the first node, and
<samp>`Overview'</samp> is the name of the first section of the manual.
</p><hr size="1">
Index: texi2html/Tests/nodes_texinfo_res/Tree-Structuring.html
diff -u texi2html/Tests/nodes_texinfo_res/Tree-Structuring.html:1.16
texi2html/Tests/nodes_texinfo_res/Tree-Structuring.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Tree-Structuring.html:1.16 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Tree-Structuring.html Sat Mar 25
13:26:47 2006
@@ -101,12 +101,14 @@
1.1 1.2 2.1 2.2 3.1 3.2
</pre></td></tr></table>
+
<p>In a Texinfo file that has this structure, the beginning of Chapter 2
looks like this:
</p>
<table><tr><td> </td><td><pre class="example">@node Chapter 2,
Chapter 3, Chapter 1, top
@chapter Chapter 2
</pre></td></tr></table>
+
<p>The chapter structuring commands are described in the sections that
follow; the <code>@node</code> and <code>@menu</code> commands are described in
following chapters. (See section <a href="Nodes.html#SEC85">Nodes</a>, and see
<a href="Menus.html#SEC97">Menus</a>.)
Index: texi2html/Tests/nodes_texinfo_res/Two-Arguments.html
diff -u texi2html/Tests/nodes_texinfo_res/Two-Arguments.html:1.16
texi2html/Tests/nodes_texinfo_res/Two-Arguments.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Two-Arguments.html:1.16 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Two-Arguments.html Sat Mar 25
13:26:47 2006
@@ -84,7 +84,6 @@
reference, while the first is still the name of the node to which the
cross reference points.
</p>
-
<p>The template is like this:
</p>
<table><tr><td> </td><td><pre class="example">@xref{<var>node-name</var>,
<var>cross-reference-name</var>}.
@@ -105,7 +104,6 @@
<blockquote><p>See Section 5.2 [Electrical Effects], page 57.
</p></blockquote>
-
<p>(Note that in the preceding example the closing brace is followed by a
period; and that the node name is printed, not the cross reference name.)
</p>
@@ -123,7 +121,6 @@
<blockquote><p>See Section 5.2 [Electrical Effects], page 57, for more info.
</p></blockquote>
-
<p>(Note that in the preceding example the closing brace is followed by a
comma, and then by the clause, which is followed by a period.)
</p>
Index: texi2html/Tests/nodes_texinfo_res/Typed-Functions.html
diff -u texi2html/Tests/nodes_texinfo_res/Typed-Functions.html:1.21
texi2html/Tests/nodes_texinfo_res/Typed-Functions.html:1.22
--- texi2html/Tests/nodes_texinfo_res/Typed-Functions.html:1.21 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Typed-Functions.html Sat Mar 25
13:26:47 2006
@@ -95,7 +95,6 @@
being described, the type of the returned value, the name of this
particular entity, and its arguments, if any.
</p>
-
<p>For example,
</p>
<table><tr><td> </td><td><pre class="example">@deftypefn {Library
Function} int foobar
@@ -111,6 +110,7 @@
<table><tr><td> </td><td><pre class="smallexample">-- Library Function:
int foobar (int FOO, float BAR)
…
</pre></td></tr></table>
+
<p>This means that <code>foobar</code> is a “library function”
that returns an
<code>int</code>, and its arguments are <var>foo</var> (an <code>int</code>)
and
<var>bar</var> (a <code>float</code>).
@@ -137,7 +137,6 @@
somewhat contrary to the convention described in the preceding
paragraphs.
</p>
-
<p>For example:
</p>
<table><tr><td> </td><td><pre class="example">@deftypefn stacks private
push
@@ -165,7 +164,6 @@
for functions in typed languages. The command is equivalent to
<samp>address@hidden Function …'</samp>.
</p>
-
<p>Thus,
</p>
<table><tr><td> </td><td><pre class="smallexample">@deftypefun int foobar
(int @var{foo}, float @var{bar})
@@ -178,12 +176,14 @@
<table><tr><td> </td><td><pre class="example">-- Function: int foobar
(int FOO, float BAR)
…
</pre></td></tr></table>
+
<p>The template is:
</p>
<table><tr><td> </td><td><pre class="example">@deftypefun <var>type</var>
<var>name</var> <var>arguments</var>…
<var>body-of-description</var>
@end deftypefun
</pre></td></tr></table>
+
<p><code>@deftypefun</code> creates an entry in the index of functions for
<var>name</var>.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Typed-Variables.html
diff -u texi2html/Tests/nodes_texinfo_res/Typed-Variables.html:1.21
texi2html/Tests/nodes_texinfo_res/Typed-Variables.html:1.22
--- texi2html/Tests/nodes_texinfo_res/Typed-Variables.html:1.21 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Typed-Variables.html Sat Mar 25
13:26:47 2006
@@ -101,7 +101,6 @@
being described, the data type, and the name of this particular
entity.
</p>
-
<p>For example:
</p>
<table><tr><td> </td><td><pre class="example">@deftypevr {Global Flag}
int enable
@@ -114,12 +113,14 @@
<table><tr><td> </td><td><pre class="example">-- Global Flag: int enable
…
</pre></td></tr></table>
+
<p>The template is:
</p>
<table><tr><td> </td><td><pre class="example">@deftypevr
<var>category</var> <var>data-type</var> <var>name</var>
<var>body-of-description</var>
@end deftypevr
</pre></td></tr></table>
+
<p><code>@deftypevr</code> creates an entry in the index of variables for
<var>name</var>.
</p>
@@ -130,7 +131,6 @@
for variables in typed languages. <code>@deftypevar</code> is equivalent
to <samp>address@hidden Variable …'</samp>.
</p>
-
<p>For example:
</p>
<table><tr><td> </td><td><pre class="example">@deftypevar int fubar
@@ -150,6 +150,7 @@
<var>body-of-description</var>
@end deftypevar
</pre></td></tr></table>
+
<p><code>@deftypevar</code> creates an entry in the index of variables for
<var>name</var>.
</p></dd>
Index: texi2html/Tests/nodes_texinfo_res/Updating-Requirements.html
diff -u texi2html/Tests/nodes_texinfo_res/Updating-Requirements.html:1.19
texi2html/Tests/nodes_texinfo_res/Updating-Requirements.html:1.20
--- texi2html/Tests/nodes_texinfo_res/Updating-Requirements.html:1.19 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Updating-Requirements.html Sat Mar
25 13:26:47 2006
@@ -101,11 +101,13 @@
@comment node-name, next, previous, up
@section Comments
</pre></td></tr></table>
+
<p>or like this (without the <code>@comment</code> line):
</p>
<table><tr><td> </td><td><pre class="example">@node Comments, Minimum,
Conventions, Overview
@section Comments
</pre></td></tr></table>
+
<p>or like this (without the explicit node pointers):
</p>
<table><tr><td> </td><td><pre class="example">@node Comments
Index: texi2html/Tests/nodes_texinfo_res/Using-Include-Files.html
diff -u texi2html/Tests/nodes_texinfo_res/Using-Include-Files.html:1.16
texi2html/Tests/nodes_texinfo_res/Using-Include-Files.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Using-Include-Files.html:1.16 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Using-Include-Files.html Sat Mar 25
13:26:47 2006
@@ -87,6 +87,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@include buffers.texi
</pre></td></tr></table>
+
<p>An included file should simply be a segment of text that you expect to
be included as is into the overall or <em>outer</em> Texinfo file; it
should not contain the standard beginning and end parts of a Texinfo
Index:
texi2html/Tests/nodes_texinfo_res/Using-texinfo_002dshow_002dstructure.html
diff -u
texi2html/Tests/nodes_texinfo_res/Using-texinfo_002dshow_002dstructure.html:1.6
texi2html/Tests/nodes_texinfo_res/Using-texinfo_002dshow_002dstructure.html:1.7
---
texi2html/Tests/nodes_texinfo_res/Using-texinfo_002dshow_002dstructure.html:1.6
Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Using-texinfo_002dshow_002dstructure.html
Sat Mar 25 13:26:47 2006
@@ -110,6 +110,7 @@
4469: @subsection @code{@@node} Line Tips
…
</pre></td></tr></table>
+
<p>This says that lines 4337, 4393, and 4417 of <tt>`texinfo.texi'</tt> begin
with the <code>@section</code>, <code>@subheading</code>, and
<code>@subsection</code>
commands respectively. If you move your cursor into the <samp>`*Occur*'</samp>
Index: texi2html/Tests/nodes_texinfo_res/Variables-Commands.html
diff -u texi2html/Tests/nodes_texinfo_res/Variables-Commands.html:1.21
texi2html/Tests/nodes_texinfo_res/Variables-Commands.html:1.22
--- texi2html/Tests/nodes_texinfo_res/Variables-Commands.html:1.21 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Variables-Commands.html Sat Mar 25
13:26:47 2006
@@ -106,6 +106,7 @@
…
@end defvr
</pre></td></tr></table>
+
<p>Terminate the definition with <code>@end defvr</code> on a line of its
own.
</p>
@@ -115,6 +116,7 @@
<var>body-of-definition</var>
@end defvr
</pre></td></tr></table>
+
<p><code>@defvr</code> creates an entry in the index of variables for
<var>name</var>.
</p>
<a name="IDX271"></a>
@@ -130,12 +132,14 @@
…
@end defvar
</pre></td></tr></table>
+
<p>The template is:
</p>
<table><tr><td> </td><td><pre class="example">@defvar <var>name</var>
<var>body-of-definition</var>
@end defvar
</pre></td></tr></table>
+
<p><code>@defvar</code> creates an entry in the index of variables for
<var>name</var>.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Within-Emacs.html
diff -u texi2html/Tests/nodes_texinfo_res/Within-Emacs.html:1.16
texi2html/Tests/nodes_texinfo_res/Within-Emacs.html:1.17
--- texi2html/Tests/nodes_texinfo_res/Within-Emacs.html:1.16 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Within-Emacs.html Sat Mar 25 13:26:47 2006
@@ -95,6 +95,7 @@
<table><tr><td> </td><td><pre class="example">texi2dvi gcc.texinfo
lpr -d gcc.dvi
</pre></td></tr></table>
+
<p>See section <a href="Texinfo-Mode-Printing.html#SEC250">Formatting and
Printing in Texinfo Mode</a>, for more information about formatting
and printing in Texinfo mode.
</p>
Index: texi2html/Tests/nodes_texinfo_res/Writing-a-Menu.html
diff -u texi2html/Tests/nodes_texinfo_res/Writing-a-Menu.html:1.17
texi2html/Tests/nodes_texinfo_res/Writing-a-Menu.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Writing-a-Menu.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Writing-a-Menu.html Sat Mar 25
13:26:47 2006
@@ -95,6 +95,7 @@
several files at once.
@end menu
</pre></td></tr></table>
+
<p>In a menu, every line that begins with an <samp>`* '</samp> is a <em>menu
entry</em>. (Note the space after the asterisk.) A line that does not
start with an <samp>`* '</samp> may also appear in a menu. Such a line is
Index: texi2html/Tests/nodes_texinfo_res/Writing-a-Node.html
diff -u texi2html/Tests/nodes_texinfo_res/Writing-a-Node.html:1.17
texi2html/Tests/nodes_texinfo_res/Writing-a-Node.html:1.18
--- texi2html/Tests/nodes_texinfo_res/Writing-a-Node.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/Writing-a-Node.html Sat Mar 25
13:26:47 2006
@@ -86,6 +86,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@node <var>node-name</var>
</pre></td></tr></table>
+
<p>If you are using GNU Emacs, you can use the update node commands
provided by Texinfo mode to insert the names of the pointers; or you
can leave the pointers out of the Texinfo file and let <code>makeinfo</code>
@@ -104,6 +105,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@node <var>node-name</var>,
<var>next</var>, <var>previous</var>, <var>up</var>
</pre></td></tr></table>
+
<p>If you wish, you can ignore <code>@node</code> lines altogether in your
first
draft and then use the <code>texinfo-insert-node-lines</code> command to
create <code>@node</code> lines for you. However, we do not recommend this
Index: texi2html/Tests/nodes_texinfo_res/_002d-and-hyphenation.html
diff -u texi2html/Tests/nodes_texinfo_res/_002d-and-hyphenation.html:1.7
texi2html/Tests/nodes_texinfo_res/_002d-and-hyphenation.html:1.8
--- texi2html/Tests/nodes_texinfo_res/_002d-and-hyphenation.html:1.7 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/_002d-and-hyphenation.html Sat Mar
25 13:26:47 2006
@@ -99,7 +99,8 @@
<dd><p>Tell TeX how to hyphenate <var>hy-phen-a-ted words</var>. As shown, you
put a <samp>`-'</samp> at each hyphenation point. For example:
</p><table><tr><td> </td><td><pre
class="example">@hyphenation{man-u-script man-u-scripts}
-</pre></td></tr></table><p>TeX only uses the specified hyphenation points when
the
+</pre></td></tr></table>
+<p>TeX only uses the specified hyphenation points when the
words match exactly, so give all necessary variants.
</p></dd>
</dl>
Index: texi2html/Tests/nodes_texinfo_res/alias.html
diff -u texi2html/Tests/nodes_texinfo_res/alias.html:1.15
texi2html/Tests/nodes_texinfo_res/alias.html:1.16
--- texi2html/Tests/nodes_texinfo_res/alias.html:1.15 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/alias.html Sat Mar 25 13:26:47 2006
@@ -90,6 +90,7 @@
Whitespace around the equals sign is ignored. Thus:
</p><table><tr><td> </td><td><pre class="example">@alias <var>new</var> =
<var>existing</var>
</pre></td></tr></table>
+
<p>For example, if your document contains citations for both books and
some other media (movies, for example), you might like to define a
macro <code>@moviecite{}</code> that does the same thing as an ordinary
@@ -98,6 +99,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@alias moviecite = cite
</pre></td></tr></table>
+
<p>Macros do not always have the same effect due to vagaries of argument
parsing. Also, aliases are much simpler to define than macros. So the
command is not redundant. (It was also heavily used in the Jargon File!)
Index: texi2html/Tests/nodes_texinfo_res/anchor.html
diff -u texi2html/Tests/nodes_texinfo_res/anchor.html:1.16
texi2html/Tests/nodes_texinfo_res/anchor.html:1.17
--- texi2html/Tests/nodes_texinfo_res/anchor.html:1.16 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/anchor.html Sat Mar 25 13:26:47 2006
@@ -90,12 +90,14 @@
…
@xref{x-spot,,the spot}.
</pre></td></tr></table>
+
<p>produces:
</p>
<table><tr><td> </td><td><pre class="example">This marks the spot.
…
See [the spot], page 1.
</pre></td></tr></table>
+
<p>As you can see, the <code>@anchor</code> command itself produces no output.
This example defines an anchor `x-spot' just before the word `spot'.
You can refer to it later with an <code>@xref</code> or other cross-reference
Index: texi2html/Tests/nodes_texinfo_res/chapter.html
diff -u texi2html/Tests/nodes_texinfo_res/chapter.html:1.17
texi2html/Tests/nodes_texinfo_res/chapter.html:1.18
--- texi2html/Tests/nodes_texinfo_res/chapter.html:1.17 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/chapter.html Sat Mar 25 13:26:47 2006
@@ -89,6 +89,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@chapter Chapter Structuring
</pre></td></tr></table>
+
<p>In TeX, the <code>@chapter</code> command creates a chapter in the
document, specifying the chapter title. The chapter is numbered
automatically.
@@ -100,6 +101,7 @@
<table><tr><td> </td><td><pre class="example">Chapter Structuring
*******************
</pre></td></tr></table>
+
<a name="IDX91"></a>
<p>Texinfo also provides a command <code>@centerchap</code>, which is analogous
to <code>@unnumbered</code>, but centers its argument in the printed output.
Index: texi2html/Tests/nodes_texinfo_res/command.html
diff -u texi2html/Tests/nodes_texinfo_res/command.html:1.16
texi2html/Tests/nodes_texinfo_res/command.html:1.17
--- texi2html/Tests/nodes_texinfo_res/command.html:1.16 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/command.html Sat Mar 25 13:26:47 2006
@@ -87,7 +87,8 @@
For example:
</p>
<table><tr><td> </td><td><pre class="example">The command @command{ls}
lists directory contents.
-</pre></td></tr></table><p>produces
+</pre></td></tr></table>
+<p>produces
</p><blockquote><p>The command <code>ls</code> lists directory contents.
</p></blockquote>
Index: texi2html/Tests/nodes_texinfo_res/copying.html
diff -u texi2html/Tests/nodes_texinfo_res/copying.html:1.17
texi2html/Tests/nodes_texinfo_res/copying.html:1.18
--- texi2html/Tests/nodes_texinfo_res/copying.html:1.17 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/copying.html Sat Mar 25 13:26:47 2006
@@ -97,6 +97,7 @@
@end quotation
@end copying
</pre></td></tr></table>
+
<p>The <code>@quotation</code> has no legal significance; it's there to improve
readability in some contexts.
</p>
@@ -117,6 +118,7 @@
</p>
<table><tr><td> </td><td><pre class="example">Copyright ©
<var>years</var> <var>copyright-owner</var>.
</pre></td></tr></table>
+
<a name="IDX74"></a>
<p>The word `Copyright' must always be written in English, even if the
manual is otherwise in another language. This is due to international
Index: texi2html/Tests/nodes_texinfo_res/display.html
diff -u texi2html/Tests/nodes_texinfo_res/display.html:1.17
texi2html/Tests/nodes_texinfo_res/display.html:1.18
--- texi2html/Tests/nodes_texinfo_res/display.html:1.17 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/display.html Sat Mar 25 13:26:47 2006
@@ -92,6 +92,7 @@
and an <code>@end display</code> command. The <code>@display</code> command
indents the text, but does not fill it.
</pre></td></tr></table>
+
<a name="IDX133"></a>
<p>Texinfo also provides a command <code>@smalldisplay</code>, which is like
<code>@display</code> but uses a smaller font in <code>@smallbook</code>
format.
Index: texi2html/Tests/nodes_texinfo_res/documentdescription.html
diff -u texi2html/Tests/nodes_texinfo_res/documentdescription.html:1.16
texi2html/Tests/nodes_texinfo_res/documentdescription.html:1.17
--- texi2html/Tests/nodes_texinfo_res/documentdescription.html:1.16 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/documentdescription.html Sat Mar 25
13:26:47 2006
@@ -96,6 +96,7 @@
</p>
<table><tr><td> </td><td><pre class="example"><meta name=description
content="descriptive text.">
</pre></td></tr></table>
+
<p><code>@documentdescription</code> must be specified before the first node of
the document.
</p>
Index: texi2html/Tests/nodes_texinfo_res/documentencoding.html
diff -u texi2html/Tests/nodes_texinfo_res/documentencoding.html:1.16
texi2html/Tests/nodes_texinfo_res/documentencoding.html:1.17
--- texi2html/Tests/nodes_texinfo_res/documentencoding.html:1.16 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/documentencoding.html Sat Mar 25
13:26:47 2006
@@ -95,6 +95,7 @@
charset=<var>enc</var>">
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/email.html
diff -u texi2html/Tests/nodes_texinfo_res/email.html:1.16
texi2html/Tests/nodes_texinfo_res/email.html:1.17
--- texi2html/Tests/nodes_texinfo_res/email.html:1.16 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/email.html Sat Mar 25 13:26:47 2006
@@ -92,11 +92,13 @@
</p>
<table><tr><td> </td><td><pre class="example">Send bug reports to
@email{bug-texinfo@@gnu.org},
suggestions to the @email{bug-texinfo@@gnu.org, same place}.
-</pre></td></tr></table><p>produces
+</pre></td></tr></table>
+<p>produces
</p><table><tr><td> </td><td><pre class="display">Send bug reports to <a
href="mailto:address@hidden">address@hidden</a>,
suggestions to the <a href="mailto:address@hidden">same place</a>.
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/emph-_0026-strong.html
diff -u texi2html/Tests/nodes_texinfo_res/emph-_0026-strong.html:1.6
texi2html/Tests/nodes_texinfo_res/emph-_0026-strong.html:1.7
--- texi2html/Tests/nodes_texinfo_res/emph-_0026-strong.html:1.6 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/emph-_0026-strong.html Sat Mar 25
13:26:47 2006
@@ -97,6 +97,7 @@
<table><tr><td> </td><td><pre class="example"> *Caution*: `rm *
.[^.]*' removes _all_
files in the directory.
</pre></td></tr></table>
+
<p>The <code>@strong</code> command is seldom used except to mark what is, in
effect, a typographical element, such as the word `Caution' in the
preceding example.
Index: texi2html/Tests/nodes_texinfo_res/env.html
diff -u texi2html/Tests/nodes_texinfo_res/env.html:1.16
texi2html/Tests/nodes_texinfo_res/env.html:1.17
--- texi2html/Tests/nodes_texinfo_res/env.html:1.16 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/env.html Sat Mar 25 13:26:47 2006
@@ -89,7 +89,8 @@
For example:
</p>
<table><tr><td> </td><td><pre class="example">The @env{PATH} environment
variable …
-</pre></td></tr></table><p>produces
+</pre></td></tr></table>
+<p>produces
</p><blockquote><p>The <code>PATH</code> environment variable …
</p></blockquote>
Index: texi2html/Tests/nodes_texinfo_res/example.html
diff -u texi2html/Tests/nodes_texinfo_res/example.html:1.17
texi2html/Tests/nodes_texinfo_res/example.html:1.18
--- texi2html/Tests/nodes_texinfo_res/example.html:1.17 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/example.html Sat Mar 25 13:26:47 2006
@@ -93,6 +93,7 @@
significant. In the Info file, an analogous result is
obtained by indenting each line with five spaces.
</pre></td></tr></table>
+
<p>Write an <code>@example</code> command at the beginning of a line by itself.
Mark the end of the example
with an <code>@end example</code> command, also written at the beginning of a
@@ -109,6 +110,7 @@
</p>
<table><tr><td> </td><td><pre class="example">mv foo bar
</pre></td></tr></table>
+
<p>The lines containing <code>@example</code> and <code>@end example</code>
will disappear from the output.
To make the output look good,
Index: texi2html/Tests/nodes_texinfo_res/exampleindent.html
diff -u texi2html/Tests/nodes_texinfo_res/exampleindent.html:1.17
texi2html/Tests/nodes_texinfo_res/exampleindent.html:1.18
--- texi2html/Tests/nodes_texinfo_res/exampleindent.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/exampleindent.html Sat Mar 25
13:26:47 2006
@@ -87,6 +87,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@exampleindent
<var>indent</var>
</pre></td></tr></table>
+
<p>The indentation is according to the value of <var>indent</var>:
</p>
<dl compact="compact">
Index: texi2html/Tests/nodes_texinfo_res/exdent.html
diff -u texi2html/Tests/nodes_texinfo_res/exdent.html:1.16
texi2html/Tests/nodes_texinfo_res/exdent.html:1.17
--- texi2html/Tests/nodes_texinfo_res/exdent.html:1.16 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/exdent.html Sat Mar 25 13:26:47 2006
@@ -103,6 +103,7 @@
This line follows the exdented line.
The @end example comes on the next line.
</pre></td></tr></table>
+
<p>In practice, the <code>@exdent</code> command is rarely used.
Usually, you un-indent text by ending the example and
returning the page to its normal width.
Index: texi2html/Tests/nodes_texinfo_res/expansion.html
diff -u texi2html/Tests/nodes_texinfo_res/expansion.html:1.18
texi2html/Tests/nodes_texinfo_res/expansion.html:1.19
--- texi2html/Tests/nodes_texinfo_res/expansion.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/expansion.html Sat Mar 25 13:26:47 2006
@@ -109,7 +109,6 @@
the result of evaluating the expression is <code>c</code>.
</p></blockquote>
-
<p>Often, as in this case, an example looks better if the
<code>@expansion{}</code> and <code>@result{}</code> commands are indented
five spaces.
Index: texi2html/Tests/nodes_texinfo_res/format.html
diff -u texi2html/Tests/nodes_texinfo_res/format.html:1.17
texi2html/Tests/nodes_texinfo_res/format.html:1.18
--- texi2html/Tests/nodes_texinfo_res/format.html:1.17 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/format.html Sat Mar 25 13:26:47 2006
@@ -89,6 +89,7 @@
from this example,
the <code>@format</code> command does not fill the text.
</pre></td></tr></table>
+
<a name="IDX134"></a>
<p>Texinfo also provides a command <code>@smallformat</code>, which is like
<code>@format</code> but uses a smaller font in <code>@smallbook</code> format.
Index: texi2html/Tests/nodes_texinfo_res/ifset-ifclear.html
diff -u texi2html/Tests/nodes_texinfo_res/ifset-ifclear.html:1.17
texi2html/Tests/nodes_texinfo_res/ifset-ifclear.html:1.18
--- texi2html/Tests/nodes_texinfo_res/ifset-ifclear.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/ifset-ifclear.html Sat Mar 25
13:26:47 2006
@@ -93,6 +93,7 @@
<var>conditional-text</var>
@end ifset
</pre></td></tr></table>
+
<p>For example, you can create one document that has two variants, such as
a manual for a `large' and `small' model:
</p>
@@ -139,6 +140,7 @@
<table><tr><td> </td><td><pre class="example">@ifclear <var>flag</var>
</pre></td></tr></table>
+
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="set-value.html#SEC232"
title="Previous section in reading order"> < </a>]</td>
Index: texi2html/Tests/nodes_texinfo_res/inforef.html
diff -u texi2html/Tests/nodes_texinfo_res/inforef.html:1.19
texi2html/Tests/nodes_texinfo_res/inforef.html:1.20
--- texi2html/Tests/nodes_texinfo_res/inforef.html:1.19 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/inforef.html Sat Mar 25 13:26:47 2006
@@ -99,12 +99,10 @@
The Info file name.
</li></ol>
-
<p>Separate the arguments with commas, as with <code>@xref</code>. Also, you
must terminate the reference with a comma or period after the
<samp>`}'</samp>, as you do with <code>@xref</code>.
</p>
-
<p>The template is:
</p>
<table><tr><td> </td><td><pre
class="example">@inforef{<var>node-name</var>, <var>cross-reference-name</var>,
<var>info-file-name</var>},
@@ -127,7 +125,6 @@
<blockquote><p>See Info file <tt>`info'</tt>, node <samp>`Expert'</samp>, for
more information.
</p></blockquote>
-
<p>Similarly,
</p>
<table><tr><td> </td><td><pre class="example">@inforef{Expert, , info},
for more information.
Index: texi2html/Tests/nodes_texinfo_res/insertcopying.html
diff -u texi2html/Tests/nodes_texinfo_res/insertcopying.html:1.15
texi2html/Tests/nodes_texinfo_res/insertcopying.html:1.16
--- texi2html/Tests/nodes_texinfo_res/insertcopying.html:1.15 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/insertcopying.html Sat Mar 25
13:26:47 2006
@@ -85,6 +85,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@insertcopying
</pre></td></tr></table>
+
<p>It inserts the text previously defined by <code>@copying</code>. Legally,
it
must be used on the copyright page in the printed manual
(see section <a href="Copyright.html#SEC56">Copyright Page</a>).
Index: texi2html/Tests/nodes_texinfo_res/itemx.html
diff -u texi2html/Tests/nodes_texinfo_res/itemx.html:1.18
texi2html/Tests/nodes_texinfo_res/itemx.html:1.19
--- texi2html/Tests/nodes_texinfo_res/itemx.html:1.18 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/itemx.html Sat Mar 25 13:26:47 2006
@@ -109,7 +109,6 @@
</p></dd>
</dl>
-
<p>(Note also that this example illustrates multi-line supporting text in
a two-column table.)
</p>
Index: texi2html/Tests/nodes_texinfo_res/kbd.html
diff -u texi2html/Tests/nodes_texinfo_res/kbd.html:1.19
texi2html/Tests/nodes_texinfo_res/kbd.html:1.20
--- texi2html/Tests/nodes_texinfo_res/kbd.html:1.19 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/kbd.html Sat Mar 25 13:26:47 2006
@@ -91,6 +91,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@kbd{M-x shell}
</pre></td></tr></table>
+
<a name="IDX120"></a>
<a name="IDX121"></a>
<p>The <code>@kbd</code> command has the same effect as <code>@code</code> in
Info,
Index: texi2html/Tests/nodes_texinfo_res/key.html
diff -u texi2html/Tests/nodes_texinfo_res/key.html:1.18
texi2html/Tests/nodes_texinfo_res/key.html:1.19
--- texi2html/Tests/nodes_texinfo_res/key.html:1.18 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/key.html Sat Mar 25 13:26:47 2006
@@ -85,6 +85,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@key{RET}
</pre></td></tr></table>
+
<p>You can use the <code>@key</code> command within the argument of an
<code>@kbd</code> command when the sequence of characters to be typed
includes one or more keys that are described by name.
@@ -93,6 +94,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@kbd{C-x @key{ESC}}
</pre></td></tr></table>
+
<p>Here is a list of the recommended names for keys:
<a name="IDX126"></a>
<a name="IDX127"></a>
Index: texi2html/Tests/nodes_texinfo_res/lisp.html
diff -u texi2html/Tests/nodes_texinfo_res/lisp.html:1.16
texi2html/Tests/nodes_texinfo_res/lisp.html:1.17
--- texi2html/Tests/nodes_texinfo_res/lisp.html:1.16 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/lisp.html Sat Mar 25 13:26:47 2006
@@ -86,6 +86,7 @@
<table><tr><td> </td><td><pre class="lisp">This is an example of text
written between an
<code>@lisp</code> command and an <code>@end lisp</code> command.
</pre></td></tr></table>
+
<p>Use <code>@lisp</code> instead of <code>@example</code> to preserve
information
regarding the nature of the example. This is useful, for example, if
you write a function that evaluates only and all the Lisp code in a
Index: texi2html/Tests/nodes_texinfo_res/makeinfo-in-Emacs.html
diff -u texi2html/Tests/nodes_texinfo_res/makeinfo-in-Emacs.html:1.19
texi2html/Tests/nodes_texinfo_res/makeinfo-in-Emacs.html:1.20
--- texi2html/Tests/nodes_texinfo_res/makeinfo-in-Emacs.html:1.19 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/makeinfo-in-Emacs.html Sat Mar 25
13:26:47 2006
@@ -139,7 +139,6 @@
</p></dd>
</dl>
-
<p>(Note that the parallel commands for killing and recentering a TeX
job are <kbd>C-c C-t C-k</kbd> and <kbd>C-c C-t C-l</kbd>. See section <a
href="Texinfo-Mode-Printing.html#SEC250">Formatting and Printing in Texinfo
Mode</a>.)
</p>
Index: texi2html/Tests/nodes_texinfo_res/makeinfo-options.html
diff -u texi2html/Tests/nodes_texinfo_res/makeinfo-options.html:1.20
texi2html/Tests/nodes_texinfo_res/makeinfo-options.html:1.21
--- texi2html/Tests/nodes_texinfo_res/makeinfo-options.html:1.20 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/makeinfo-options.html Sat Mar 25
13:26:47 2006
@@ -92,6 +92,7 @@
</p>
<table><tr><td> </td><td><pre class="example">makeinfo --fill-column=68
bison.texinfo
</pre></td></tr></table>
+
<p>You can write two or more options in sequence, like this:
</p>
<table><tr><td> </td><td><pre class="example">makeinfo --no-split
--fill-column=70 …
Index: texi2html/Tests/nodes_texinfo_res/makeinfo-top-command.html
diff -u texi2html/Tests/nodes_texinfo_res/makeinfo-top-command.html:1.15
texi2html/Tests/nodes_texinfo_res/makeinfo-top-command.html:1.16
--- texi2html/Tests/nodes_texinfo_res/makeinfo-top-command.html:1.15 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/makeinfo-top-command.html Sat Mar 25
13:26:47 2006
@@ -107,6 +107,7 @@
@top Your Manual Title
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/math.html
diff -u texi2html/Tests/nodes_texinfo_res/math.html:1.16
texi2html/Tests/nodes_texinfo_res/math.html:1.17
--- texi2html/Tests/nodes_texinfo_res/math.html:1.16 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/math.html Sat Mar 25 13:26:47 2006
@@ -85,10 +85,12 @@
</p>
<table><tr><td> </td><td><pre class="example">@math{(a + b)(a + b) = a^2
+ 2ab + b^2}
</pre></td></tr></table>
+
<p>This produces the following in Info:
</p>
<table><tr><td> </td><td><pre class="example">(a + b)(a + b) = a^2 + 2ab
+ b^2
</pre></td></tr></table>
+
<p>Thus, the <code>@math</code> command has no effect on the Info output.
</p>
<p><code>@math</code> implies <code>@tex</code>. This not only makes it
possible to
@@ -98,9 +100,11 @@
As in:
</p><table><tr><td> </td><td><pre class="example">@math{\sin 2\pi \equiv
\cos 3\pi}
</pre></td></tr></table>
+
<p>which looks like the input in Info and HTML:
</p><table><tr><td> </td><td><pre class="example">\sin 2\pi \equiv \cos
3\pi
</pre></td></tr></table>
+
<a name="IDX224"></a>
<p>Since <samp>`\'</samp> is an escape character inside <code>@math</code>,
you can use
<code>@\</code> to get a literal backslash (<code>\\</code> will work in TeX,
Index: texi2html/Tests/nodes_texinfo_res/need.html
diff -u texi2html/Tests/nodes_texinfo_res/need.html:1.17
texi2html/Tests/nodes_texinfo_res/need.html:1.18
--- texi2html/Tests/nodes_texinfo_res/need.html:1.17 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/need.html Sat Mar 25 13:26:47 2006
@@ -93,6 +93,7 @@
<table><tr><td> </td><td><pre class="example">@need 800
This paragraph is preceded by …
</pre></td></tr></table>
+
<p>The <code>@need</code> command is useful for preventing orphans (single
lines at the bottoms of printed pages).
</p>
Index: texi2html/Tests/nodes_texinfo_res/noindent.html
diff -u texi2html/Tests/nodes_texinfo_res/noindent.html:1.16
texi2html/Tests/nodes_texinfo_res/noindent.html:1.17
--- texi2html/Tests/nodes_texinfo_res/noindent.html:1.16 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/noindent.html Sat Mar 25 13:26:47 2006
@@ -102,13 +102,14 @@
<p>produces
</p>
<table><tr><td> </td><td><table><tr><td> </td><td><pre
class="example">This is an example
-</pre></td></tr></table><pre class="display">
-
+</pre></td></tr></table>
+<pre class="display">
This line is not indented. As you can see, the
beginning of the line is fully flush left with the line
that follows after it. (This whole example is between
<code>@display</code> and <code>@end display</code>.)
</pre></td></tr></table>
+
<p>To adjust the number of blank lines properly in the Info file output,
remember that the line containing <code>@noindent</code> does not generate a
blank line, and neither does the <code>@end example</code> line.
Index: texi2html/Tests/nodes_texinfo_res/option.html
diff -u texi2html/Tests/nodes_texinfo_res/option.html:1.15
texi2html/Tests/nodes_texinfo_res/option.html:1.16
--- texi2html/Tests/nodes_texinfo_res/option.html:1.15 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/option.html Sat Mar 25 13:26:47 2006
@@ -88,7 +88,8 @@
For example:
</p>
<table><tr><td> </td><td><pre class="example">The option @option{-l}
produces a long listing.
-</pre></td></tr></table><p>produces
+</pre></td></tr></table>
+<p>produces
</p><blockquote><p>The option <samp>`-l'</samp> produces a long listing.
</p></blockquote>
Index: texi2html/Tests/nodes_texinfo_res/pagesizes.html
diff -u texi2html/Tests/nodes_texinfo_res/pagesizes.html:1.17
texi2html/Tests/nodes_texinfo_res/pagesizes.html:1.18
--- texi2html/Tests/nodes_texinfo_res/pagesizes.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/pagesizes.html Sat Mar 25 13:26:47 2006
@@ -86,8 +86,10 @@
title page. The height comes first, then the width if desired,
separated by a comma. Examples:
</p>
-<table><tr><td> </td><td><pre class="example">@pagesizes 200mm,150mm
</pre></td></tr></table><p>and
+<table><tr><td> </td><td><pre class="example">@pagesizes 200mm,150mm
</pre></td></tr></table>
+<p>and
</p><table><tr><td> </td><td><pre class="example">@pagesizes 11.5in
</pre></td></tr></table>
+
<a name="IDX352"></a>
<a name="IDX353"></a>
<p>This would be reasonable for printing on B5-size paper. To emphasize,
Index: texi2html/Tests/nodes_texinfo_res/paragraphindent.html
diff -u texi2html/Tests/nodes_texinfo_res/paragraphindent.html:1.17
texi2html/Tests/nodes_texinfo_res/paragraphindent.html:1.18
--- texi2html/Tests/nodes_texinfo_res/paragraphindent.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/paragraphindent.html Sat Mar 25
13:26:47 2006
@@ -88,6 +88,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@paragraphindent
<var>indent</var>
</pre></td></tr></table>
+
<p>The indentation is according to the value of <var>indent</var>:
</p>
<dl compact="compact">
Index: texi2html/Tests/nodes_texinfo_res/pxref.html
diff -u texi2html/Tests/nodes_texinfo_res/pxref.html:1.19
texi2html/Tests/nodes_texinfo_res/pxref.html:1.20
--- texi2html/Tests/nodes_texinfo_res/pxref.html:1.19 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/pxref.html Sat Mar 25 13:26:47 2006
@@ -111,7 +111,6 @@
the need to use complicated methods to put a terminator into one form
of the output and not the other.
</p>
-
<p>With one argument, a parenthetical cross reference looks like
this:
</p>
Index: texi2html/Tests/nodes_texinfo_res/ref.html
diff -u texi2html/Tests/nodes_texinfo_res/ref.html:1.16
texi2html/Tests/nodes_texinfo_res/ref.html:1.17
--- texi2html/Tests/nodes_texinfo_res/ref.html:1.16 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/ref.html Sat Mar 25 13:26:47 2006
@@ -84,7 +84,6 @@
not generate a `See' in the printed output, just the reference itself.
This makes it useful as the last part of a sentence.
</p>
-
<p>For example,
</p>
<a name="IDX111"></a>
@@ -106,7 +105,6 @@
in the Info format. Bear in mind that your audience will be using
both the printed and the Info format.
</p>
-
<p>For example,
</p>
<a name="IDX112"></a>
@@ -118,11 +116,11 @@
<blockquote><p>Sea surges are described in Section 6.7 [Hurricanes], page 72.
</p></blockquote>
-
<p>in a printed document, and the following in Info:
</p>
<table><tr><td> </td><td><pre class="example">Sea surges are described in
*Note Hurricanes::.
</pre></td></tr></table>
+
<blockquote><p><strong>Caution:</strong> You <em>must</em> write a period,
comma, or right
parenthesis immediately after an <code>@ref</code> command with two or more
arguments. Otherwise, Info will not find the end of the cross reference
Index: texi2html/Tests/nodes_texinfo_res/section.html
diff -u texi2html/Tests/nodes_texinfo_res/section.html:1.17
texi2html/Tests/nodes_texinfo_res/section.html:1.18
--- texi2html/Tests/nodes_texinfo_res/section.html:1.17 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/section.html Sat Mar 25 13:26:47 2006
@@ -90,6 +90,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@section @code{@@section}
</pre></td></tr></table>
+
<p>To create a section, write the <code>@section</code> command at the
beginning of a line and follow it on the same line by the section
title.
Index: texi2html/Tests/nodes_texinfo_res/set-value.html
diff -u texi2html/Tests/nodes_texinfo_res/set-value.html:1.18
texi2html/Tests/nodes_texinfo_res/set-value.html:1.19
--- texi2html/Tests/nodes_texinfo_res/set-value.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/set-value.html Sat Mar 25 13:26:47 2006
@@ -104,6 +104,7 @@
to this:
This is a string.
</pre></td></tr></table>
+
<p>You can write an <code>@value</code> command within a paragraph; but you
must write an <code>@set</code> command on a line of its own.
</p>
@@ -128,6 +129,7 @@
into
It is a very, very, very wet day.
</pre></td></tr></table>
+
<p>If you write
</p>
<table><tr><td> </td><td><pre class="example">@clear how-much
@@ -140,6 +142,7 @@
It is a {No value for "how-much"} wet day.
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/setchapternewpage.html
diff -u texi2html/Tests/nodes_texinfo_res/setchapternewpage.html:1.18
texi2html/Tests/nodes_texinfo_res/setchapternewpage.html:1.19
--- texi2html/Tests/nodes_texinfo_res/setchapternewpage.html:1.18 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/setchapternewpage.html Sat Mar 25
13:26:47 2006
@@ -100,6 +100,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@setchapternewpage odd
</pre></td></tr></table>
+
<p>You can specify one of three alternatives with the
<code>@setchapternewpage</code> command:
</p>
Index: texi2html/Tests/nodes_texinfo_res/setfilename.html
diff -u texi2html/Tests/nodes_texinfo_res/setfilename.html:1.17
texi2html/Tests/nodes_texinfo_res/setfilename.html:1.18
--- texi2html/Tests/nodes_texinfo_res/setfilename.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/setfilename.html Sat Mar 25 13:26:47 2006
@@ -85,6 +85,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@setfilename
<var>info-file-name</var>
</pre></td></tr></table>
+
<p>Write the <code>@setfilename</code> command at the beginning of a line and
follow it on the same line by the Info file name. Do not write anything
else on the line; anything on the line after the command is considered
Index: texi2html/Tests/nodes_texinfo_res/settitle.html
diff -u texi2html/Tests/nodes_texinfo_res/settitle.html:1.16
texi2html/Tests/nodes_texinfo_res/settitle.html:1.17
--- texi2html/Tests/nodes_texinfo_res/settitle.html:1.16 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/settitle.html Sat Mar 25 13:26:47 2006
@@ -85,6 +85,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@settitle <var>title</var>
</pre></td></tr></table>
+
<p>Write the <code>@settitle</code> command at the beginning of a line and
follow it on the same line by the title. This tells TeX the title to
use in a header or footer. Do not write anything else on the line;
Index: texi2html/Tests/nodes_texinfo_res/small.html
diff -u texi2html/Tests/nodes_texinfo_res/small.html:1.18
texi2html/Tests/nodes_texinfo_res/small.html:1.19
--- texi2html/Tests/nodes_texinfo_res/small.html:1.18 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/small.html Sat Mar 25 13:26:47 2006
@@ -100,6 +100,7 @@
<code>@end smallexample</code>. In Info this text appears in its normal size;
but in a 7 by 9.25 inch manual, this text appears in a smaller font.
</pre></td></tr></table>
+
<p>The <code>@small…</code> commands make it easier to prepare manuals
without forcing you to edit examples by hand to fit them onto narrower
pages.
Index: texi2html/Tests/nodes_texinfo_res/subsection.html
diff -u texi2html/Tests/nodes_texinfo_res/subsection.html:1.17
texi2html/Tests/nodes_texinfo_res/subsection.html:1.18
--- texi2html/Tests/nodes_texinfo_res/subsection.html:1.17 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/subsection.html Sat Mar 25 13:26:47 2006
@@ -92,6 +92,7 @@
<table><tr><td> </td><td><pre class="example">This is a subsection
--------------------
</pre></td></tr></table>
+
<p>In a printed manual, subsections are listed in the table of contents
and are numbered three levels deep.
</p>
Index: texi2html/Tests/nodes_texinfo_res/subsubsection.html
diff -u texi2html/Tests/nodes_texinfo_res/subsubsection.html:1.18
texi2html/Tests/nodes_texinfo_res/subsubsection.html:1.19
--- texi2html/Tests/nodes_texinfo_res/subsubsection.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/subsubsection.html Sat Mar 25
13:26:47 2006
@@ -124,6 +124,7 @@
<table><tr><td> </td><td><pre class="example">This is a subsubsection
.......................
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/syncodeindex.html
diff -u texi2html/Tests/nodes_texinfo_res/syncodeindex.html:1.18
texi2html/Tests/nodes_texinfo_res/syncodeindex.html:1.19
--- texi2html/Tests/nodes_texinfo_res/syncodeindex.html:1.18 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/syncodeindex.html Sat Mar 25 13:26:47 2006
@@ -92,6 +92,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@syncodeindex
<var>from</var> <var>to</var>
</pre></td></tr></table>
+
<a name="IDX155"></a>
<a name="IDX156"></a>
<a name="IDX157"></a>
@@ -136,6 +137,7 @@
<table><tr><td> </td><td><pre class="example">@syncodeindex vr cp
@syncodeindex fn cp
</pre></td></tr></table>
+
<a name="IDX159"></a>
<p>The <code>@syncodeindex</code> command puts all the entries from the `from'
index (the redirected index) into the <code>@code</code> font, overriding
Index: texi2html/Tests/nodes_texinfo_res/texinfo_283.html
diff -u texi2html/Tests/nodes_texinfo_res/texinfo_283.html:1.16
texi2html/Tests/nodes_texinfo_res/texinfo_283.html:1.17
--- texi2html/Tests/nodes_texinfo_res/texinfo_283.html:1.16 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/texinfo_283.html Sat Mar 25 13:26:47 2006
@@ -92,6 +92,7 @@
A copy of the license is included in the section entitled ``GNU
Free Documentation License''.
</pre></td></tr></table>
+
<p>If you have no Invariant Sections, write “with no Invariant
Sections”
instead of saying which ones are invariant. If you have no
Front-Cover Texts, write “no Front-Cover Texts” instead of
Index: texi2html/Tests/nodes_texinfo_res/title-subtitle-author.html
diff -u texi2html/Tests/nodes_texinfo_res/title-subtitle-author.html:1.16
texi2html/Tests/nodes_texinfo_res/title-subtitle-author.html:1.17
--- texi2html/Tests/nodes_texinfo_res/title-subtitle-author.html:1.16 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/title-subtitle-author.html Sat Mar
25 13:26:47 2006
@@ -135,6 +135,7 @@
…
@end titlepage
</pre></td></tr></table>
+
<p>You may also combine the <code>@titlefont</code> method described in the
previous section and <code>@title</code> method described in this one. This
may be useful if you have a very long title. Here is a real-life example:
Index: texi2html/Tests/nodes_texinfo_res/titlefont-center-sp.html
diff -u texi2html/Tests/nodes_texinfo_res/titlefont-center-sp.html:1.17
texi2html/Tests/nodes_texinfo_res/titlefont-center-sp.html:1.18
--- texi2html/Tests/nodes_texinfo_res/titlefont-center-sp.html:1.17 Mon Nov
14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/titlefont-center-sp.html Sat Mar 25
13:26:47 2006
@@ -92,6 +92,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@titlefont{Texinfo}
</pre></td></tr></table>
+
<p>Use the <code>@center</code> command at the beginning of a line to center
the remaining text on that line. Thus,
</p>
@@ -121,6 +122,7 @@
…
@end titlepage
</pre></td></tr></table>
+
<p>The spacing of the example fits an 8.5 by 11 inch manual.
</p>
Index: texi2html/Tests/nodes_texinfo_res/uref.html
diff -u texi2html/Tests/nodes_texinfo_res/uref.html:1.17
texi2html/Tests/nodes_texinfo_res/uref.html:1.18
--- texi2html/Tests/nodes_texinfo_res/uref.html:1.17 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/uref.html Sat Mar 25 13:26:47 2006
@@ -100,36 +100,45 @@
</p>
<table><tr><td> </td><td><pre class="example">The official GNU ftp site
is @uref{ftp://ftp.gnu.org/gnu}.
</pre></td></tr></table>
+
<p>produces:
</p><table><tr><td> </td><td><pre class="display">The official GNU ftp
site is <a href="ftp://ftp.gnu.org/gnu">ftp://ftp.gnu.org/gnu</a>.
</pre></td></tr></table>
+
<p>An example of the two-argument form:
</p><table><tr><td> </td><td><pre class="example">The official
@uref{ftp://ftp.gnu.org/gnu, GNU ftp site}
holds programs and texts.
</pre></td></tr></table>
+
<p>produces:
</p><table><tr><td> </td><td><pre class="display">The official <a
href="ftp://ftp.gnu.org/gnu">GNU ftp site</a>
holds programs and texts.
</pre></td></tr></table>
+
<p>that is, the Info output is this:
</p><table><tr><td> </td><td><pre class="example">The official GNU ftp
site (ftp://ftp.gnu.org/gnu)
holds programs and texts.
</pre></td></tr></table>
+
<p>and the HTML output is this:
</p><table><tr><td> </td><td><pre class="example">The official <a
href="ftp://ftp.gnu.org/gnu">GNU ftp site</a>
holds programs and texts.
</pre></td></tr></table>
+
<p>An example of the three-argument form:
</p><table><tr><td> </td><td><pre class="example">The
@uref{/man.cgi/1/ls,,ls(1)} program …
</pre></td></tr></table>
+
<p>produces:
</p><table><tr><td> </td><td><pre class="display">The <a
href="/man.cgi/1/ls">ls(1)</a> program …
</pre></td></tr></table>
+
<p>but with HTML:
</p><table><tr><td> </td><td><pre class="example">The <a
href="/man.cgi/1/ls">ls(1)</a> program …
</pre></td></tr></table>
+
<p>To merely indicate a url without creating a link people can follow, use
<code>@url</code> (see section <a
href="url.html#SEC135"><code>@url</code></a>).
</p>
Index: texi2html/Tests/nodes_texinfo_res/url.html
diff -u texi2html/Tests/nodes_texinfo_res/url.html:1.15
texi2html/Tests/nodes_texinfo_res/url.html:1.16
--- texi2html/Tests/nodes_texinfo_res/url.html:1.15 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/url.html Sat Mar 25 13:26:47 2006
@@ -89,11 +89,13 @@
</p>
<table><tr><td> </td><td><pre class="example">For example, the url might
be @url{http://example.org/path}.
</pre></td></tr></table>
+
<p>which produces:
</p>
<table><tr><td> </td><td><pre class="display">For example, the url might
be <a href="http://example.org/path">http://example.org/path</a>.
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/value-Example.html
diff -u texi2html/Tests/nodes_texinfo_res/value-Example.html:1.19
texi2html/Tests/nodes_texinfo_res/value-Example.html:1.20
--- texi2html/Tests/nodes_texinfo_res/value-Example.html:1.19 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/value-Example.html Sat Mar 25
13:26:47 2006
@@ -95,6 +95,7 @@
@set UPDATED 14 August 1992
@set UPDATE-MONTH August 1992
</pre></td></tr></table>
+
</li><li>
Write text for the <code>@copying</code> section (see section <a
href="copying.html#SEC50"><code>@copying</code>: Declare copying
permissions</a>):
@@ -109,6 +110,7 @@
Permission is granted …
@end copying
</pre></td></tr></table>
+
</li><li>
Write text for the title page, for people reading the printed manual:
@@ -137,12 +139,14 @@
…
@end ifnottex
</pre></td></tr></table>
+
<p>After you format the manual, the <code>@value</code> constructs have been
expanded, so the output contains text like this:
</p>
<table><tr><td> </td><td><pre class="example">This is Edition 0.35 Beta,
last updated 14 August 1992,
of `The GNU Make Manual', for `make', Version 3.63 Beta.
-</pre></td></tr></table></li></ol>
+</pre></td></tr></table>
+</li></ol>
<p>When you update the manual, you change only the values of the flags; you
do not need to edit the three sections.
Index: texi2html/Tests/nodes_texinfo_res/var.html
diff -u texi2html/Tests/nodes_texinfo_res/var.html:1.18
texi2html/Tests/nodes_texinfo_res/var.html:1.19
--- texi2html/Tests/nodes_texinfo_res/var.html:1.18 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/var.html Sat Mar 25 13:26:47 2006
@@ -110,7 +110,6 @@
<blockquote><p>To delete file <var>filename</var>, type <samp>`rm
<var>filename</var>'</samp>.
</p></blockquote>
-
<p>(Note that <code>@var</code> may appear inside <code>@code</code>,
<code>@samp</code>, <code>@file</code>, etc.)
</p>
@@ -130,6 +129,7 @@
@setfilename <var>info-file-name</var>
@settitle <var>name-of-manual</var>
</pre></td></tr></table>
+
<p>In some documentation styles, metasyntactic variables are shown with
angle brackets, for example:
</p>
Index: texi2html/Tests/nodes_texinfo_res/verb.html
diff -u texi2html/Tests/nodes_texinfo_res/verb.html:1.15
texi2html/Tests/nodes_texinfo_res/verb.html:1.16
--- texi2html/Tests/nodes_texinfo_res/verb.html:1.15 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/verb.html Sat Mar 25 13:26:47 2006
@@ -96,6 +96,7 @@
<table><tr><td> </td><td><pre class="example">How many <tt>@
</tt>-escapes does one need to print this
<tt>@a @b @c</tt> string or these <tt>@'e?`{}!`\</tt> this?
</pre></td></tr></table>
+
<p>This is in contrast to <code>@samp</code> (see the previous
section), whose argument is normal Texinfo text, where the characters
<code>@{}</code> are special; with <code>@verb</code>, nothing is special
except
Index: texi2html/Tests/nodes_texinfo_res/verbatiminclude.html
diff -u texi2html/Tests/nodes_texinfo_res/verbatiminclude.html:1.15
texi2html/Tests/nodes_texinfo_res/verbatiminclude.html:1.16
--- texi2html/Tests/nodes_texinfo_res/verbatiminclude.html:1.15 Mon Nov 14
11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/verbatiminclude.html Sat Mar 25
13:26:47 2006
@@ -85,6 +85,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@verbatiminclude
<var>filename</var>
</pre></td></tr></table>
+
<p>The contents of <var>filename</var> is printed in a verbatim environment
(see section <a href="verbatim.html#SEC145"><code>@verbatim</code></a>).
Generally, the file is printed
exactly as it is, with all special characters and white space retained.
Index: texi2html/Tests/nodes_texinfo_res/w.html
diff -u texi2html/Tests/nodes_texinfo_res/w.html:1.17
texi2html/Tests/nodes_texinfo_res/w.html:1.18
--- texi2html/Tests/nodes_texinfo_res/w.html:1.17 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/w.html Sat Mar 25 13:26:47 2006
@@ -103,6 +103,7 @@
<table><tr><td> </td><td><pre class="example">None of the formatters will
break at address@hidden }space.
</pre></td></tr></table>
+
<hr size="1">
<p>
<font size="-1">
Index: texi2html/Tests/nodes_texinfo_res/xref.html
diff -u texi2html/Tests/nodes_texinfo_res/xref.html:1.20
texi2html/Tests/nodes_texinfo_res/xref.html:1.21
--- texi2html/Tests/nodes_texinfo_res/xref.html:1.20 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/nodes_texinfo_res/xref.html Sat Mar 25 13:26:47 2006
@@ -119,7 +119,6 @@
<blockquote><p>See Section <var>section-number</var> [<var>node-name</var>],
page <var>page</var>.
</p></blockquote>
-
<p>or like this
</p>
<blockquote><p>See Section <var>section-number</var>
[<var>title-or-topic</var>], page <var>page</var>.
Index: texi2html/Tests/texi2html_res/texi2html.html
diff -u texi2html/Tests/texi2html_res/texi2html.html:1.25
texi2html/Tests/texi2html_res/texi2html.html:1.26
--- texi2html/Tests/texi2html_res/texi2html.html:1.25 Tue Aug 23 23:51:15 2005
+++ texi2html/Tests/texi2html_res/texi2html.html Sat Mar 25 13:26:47 2006
@@ -66,6 +66,7 @@
</p><table><tr><td> </td><td><pre class="example">This manual is
currently under
construction and of course incomplete ;-)
</pre></td></tr></table>
+
<hr size="1">
<a name="Overview"></a>
<a name="SEC1"></a>
@@ -239,7 +240,8 @@
<p>Result based on using <samp>`-frames'</samp>
</p>
<table><tr><td> </td><td><pre class="example">texi2html -V -frames
texi2html.texi
-</pre></td></tr></table><p>Explanation of the output differences against
default,
+</pre></td></tr></table>
+<p>Explanation of the output differences against default,
whatever this is ;-)
</p>
@@ -501,6 +503,7 @@
print $fh "</BODY></HTML>\n";
}
</pre></td></tr></table>
+
<p>As you can see it is very simple Perl Code, which can
be changed more or less simple to fit you requirements
(see section <a href="#SEC15">T2H_DEFAULT_print_page_head</a>).
@@ -555,6 +558,7 @@
EOT
}
</pre></td></tr></table>
+
<hr size="6">
<a name="CustPagePageFoot"></a>
<a name="SEC16"></a>
@@ -680,6 +684,7 @@
. 'TEXT="#000000" LINK="#0000FF" '
. 'VLINK="#800080" ALINK="#FF0000"';
</pre></td></tr></table>
+
<p>If you like to change the basic color combination, you can
change the entry <var>T2H_BODYTEXT</var>.
</p>
@@ -740,6 +745,7 @@
# can be used for <style> <script>, <meta> tags
$T2H_EXTRA_HEAD = '';
</pre></td></tr></table>
+
<p>The default output into the <acronym>HTML</acronym> file.
See section <a href="#SEC41">DocType</a>.
</p>
@@ -771,6 +777,7 @@
<BODY $T2H_BODYTEXT>
$T2H_AFTER_BODY_OPEN
</pre></td></tr></table>
+
<hr size="6">
<a name="CustHTMLHead"></a>
<a name="SEC22"></a>
@@ -1344,6 +1351,7 @@
</p>
<table><tr><td> </td><td><pre class="example"><!DOCTYPE html PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN">
</pre></td></tr></table>
+
<hr size="6">
<a name="OptionCheck"></a>
<a name="SEC42"></a>
@@ -1451,6 +1459,7 @@
<table><tr><td> </td><td><pre class="example">$T2H_INVISIBLE_MARK =
"";
# $T2H_INVISIBLE_MARK = '&#160;';
</pre></td></tr></table>
+
<hr size="6">
<a name="OptionIso"></a>
<a name="SEC46"></a>
Index: texi2html/Tests/texinfo_res/info-stnd_10.html
diff -u texi2html/Tests/texinfo_res/info-stnd_10.html:1.22
texi2html/Tests/texinfo_res/info-stnd_10.html:1.23
--- texi2html/Tests/texinfo_res/info-stnd_10.html:1.22 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/texinfo_res/info-stnd_10.html Sat Mar 25 13:26:47 2006
@@ -171,6 +171,7 @@
</p>
<table><tr><td> </td><td><pre class="example"><kbd>M-3 2 C-l</kbd>
</pre></td></tr></table>
+
</dd>
<dt> <kbd>M–</kbd> (<code>add-digit-to-numeric-arg</code></dt>
<dt> <kbd>-</kbd></dt>
Index: texi2html/Tests/texinfo_res/info-stnd_12.html
diff -u texi2html/Tests/texinfo_res/info-stnd_12.html:1.22
texi2html/Tests/texinfo_res/info-stnd_12.html:1.23
--- texi2html/Tests/texinfo_res/info-stnd_12.html:1.22 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/texinfo_res/info-stnd_12.html Sat Mar 25 13:26:47 2006
@@ -135,6 +135,7 @@
</p>
<table><tr><td> </td><td><pre class="example">infokey
[<var>option</var>…] [<var>input-file</var>]
</pre></td></tr></table>
+
<p>Besides the standard <samp>`--help'</samp> and <samp>`--version'</samp>,
the only
option is <samp>`--output <var>file</var>'</samp>. This tells
<code>infokey</code> to
write the binary data to <var>file</var> instead of <tt>`$HOME/.info'</tt>.
@@ -193,6 +194,7 @@
#var
scroll-step=1
</pre></td></tr></table>
+
<p>The source file consists of one or more <em>sections</em>.
Each section starts with a line that identifies the type of section.
Possible sections are:
@@ -207,6 +209,7 @@
</p>
<table><tr><td> </td><td><pre class="example"><var>string</var>
whitespace <var>action</var> [ whitespace [ # comment ] ] newline
</pre></td></tr></table>
+
<p>Whitespace is any sequence of one or more spaces and/or tabs. Comment
is any sequence of any characters, excluding newline. <var>string</var> is
the key sequence which invokes the action. <var>action</var> is the name of
@@ -300,6 +303,7 @@
</p>
<table><tr><td> </td><td><pre class="example">#stop
</pre></td></tr></table>
+
<p>This will cause GNU Info to ignore all the default key commands for that
section.
</p>
Index: texi2html/Tests/texinfo_res/info-stnd_13.html
diff -u texi2html/Tests/texinfo_res/info-stnd_13.html:1.21
texi2html/Tests/texinfo_res/info-stnd_13.html:1.22
--- texi2html/Tests/texinfo_res/info-stnd_13.html:1.21 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/texinfo_res/info-stnd_13.html Sat Mar 25 13:26:47 2006
@@ -116,6 +116,7 @@
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
</pre></td></tr></table>
+
<ol>
<li>
PREAMBLE
@@ -504,6 +505,7 @@
A copy of the license is included in the section entitled ``GNU
Free Documentation License''.
</pre></td></tr></table>
+
<p>If you have no Invariant Sections, write “with no Invariant
Sections”
instead of saying which ones are invariant. If you have no
Front-Cover Texts, write “no Front-Cover Texts” instead of
Index: texi2html/Tests/texinfo_res/info-stnd_2.html
diff -u texi2html/Tests/texinfo_res/info-stnd_2.html:1.21
texi2html/Tests/texinfo_res/info-stnd_2.html:1.22
--- texi2html/Tests/texinfo_res/info-stnd_2.html:1.21 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/texinfo_res/info-stnd_2.html Sat Mar 25 13:26:47 2006
@@ -87,6 +87,7 @@
</p>
<table><tr><td> </td><td><pre class="example">info
[<var>option</var>]… [<var>menu-item</var>…]
</pre></td></tr></table>
+
<p>The program accepts the following options:
</p>
<dl compact="compact">
Index: texi2html/Tests/texinfo_res/info-stnd_5.html
diff -u texi2html/Tests/texinfo_res/info-stnd_5.html:1.21
texi2html/Tests/texinfo_res/info-stnd_5.html:1.22
--- texi2html/Tests/texinfo_res/info-stnd_5.html:1.21 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/texinfo_res/info-stnd_5.html Sat Mar 25 13:26:47 2006
@@ -244,6 +244,7 @@
</p>
<table><tr><td> </td><td><pre class="example"><code>g(emacs)Buffers</code>
</pre></td></tr></table>
+
<p>finds the node <samp>`Buffers'</samp> in the Info file <tt>`emacs'</tt>.
</p>
<p><a name="goto_002dinvocation"></a>
@@ -315,9 +316,11 @@
<a name="IDX157"></a>
<p>Read the name of a file and selects the entire file. The command
</p><table><tr><td> </td><td><pre class="example"><code>C-x C-f
<var>filename</var></code>
-</pre></td></tr></table><p>is equivalent to typing
+</pre></td></tr></table>
+<p>is equivalent to typing
</p><table><tr><td> </td><td><pre
class="example"><code>g(<var>filename</var>)*</code>
</pre></td></tr></table>
+
</dd>
<dt> <kbd>C-x C-b</kbd> (<code>list-visited-nodes</code>)</dt>
<dd><a name="IDX158"></a>
Index: texi2html/Tests/texinfo_res/info-stnd_7.html
diff -u texi2html/Tests/texinfo_res/info-stnd_7.html:1.22
texi2html/Tests/texinfo_res/info-stnd_7.html:1.23
--- texi2html/Tests/texinfo_res/info-stnd_7.html:1.22 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/texinfo_res/info-stnd_7.html Sat Mar 25 13:26:47 2006
@@ -126,6 +126,7 @@
</p>
<table><tr><td> </td><td><pre class="example">* Foo Label: Foo Target.
More information about Foo.
</pre></td></tr></table>
+
<p>Note the <samp>`.'</samp> which ends the name of the target. The
<samp>`.'</samp> is
not part of the target; it serves only to let Info know where the target
name ends.
@@ -135,6 +136,7 @@
</p>
<table><tr><td> </td><td><pre class="example">* Foo Commands::
Commands pertaining to Foo.
</pre></td></tr></table>
+
<p>In the above example, the name of the target is the same as the name of
the label, in this case <code>Foo Commands</code>.
</p>
Index: texi2html/Tests/texinfo_res/info-stnd_8.html
diff -u texi2html/Tests/texinfo_res/info-stnd_8.html:1.21
texi2html/Tests/texinfo_res/info-stnd_8.html:1.22
--- texi2html/Tests/texinfo_res/info-stnd_8.html:1.21 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/texinfo_res/info-stnd_8.html Sat Mar 25 13:26:47 2006
@@ -137,6 +137,7 @@
^^ ^ ^^^ ^^
(file)Node #lines where
</pre></td></tr></table>
+
<p>When a node comes from a file which is compressed on disk, this is
indicated in the mode line with two small <samp>`z'</samp>'s. In addition, if
the Info file containing the node has been split into subfiles, the name
@@ -144,12 +145,14 @@
</p>
<table><tr><td> </td><td><pre class="example">--zz-Info: (emacs)Top, 291
lines --Top-- Subfile: emacs-1.Z-------------
</pre></td></tr></table>
+
<p>Truncation of long lines (as opposed to wrapping them to the next
display line, see section <a href="info-stnd_4.html#SEC4">toggle-wrap</a>) is
indicated by a
<samp>`$'</samp> at the left edge of the mode line:
</p>
<table><tr><td> </td><td><pre class="example">--$--Info: (texinfo)Top,
480 lines --Top-- Subfile: texinfo-1-----------
</pre></td></tr></table>
+
<p>When Info makes a node internally, such that there is no corresponding
info file on disk, the name of the node is surrounded by asterisks
(<samp>`*'</samp>). The name itself tells you what the contents of the window
@@ -158,6 +161,7 @@
</p>
<table><tr><td> </td><td><pre class="example">-----Info: *Completions*, 7
lines --All---------------------------------
</pre></td></tr></table>
+
<hr size="6">
<a name="Basic-Windows"></a>
<a name="SEC12"></a>
Index: texi2html/Tests/texinfo_res/texinfo_10.html
diff -u texi2html/Tests/texinfo_res/texinfo_10.html:1.26
texi2html/Tests/texinfo_res/texinfo_10.html:1.27
--- texi2html/Tests/texinfo_res/texinfo_10.html:1.26 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/texinfo_res/texinfo_10.html Sat Mar 25 13:26:47 2006
@@ -383,6 +383,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@kbd{M-x shell}
</pre></td></tr></table>
+
<a name="IDX120"></a>
<a name="IDX121"></a>
<p>The <code>@kbd</code> command has the same effect as <code>@code</code> in
Info,
@@ -466,6 +467,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@key{RET}
</pre></td></tr></table>
+
<p>You can use the <code>@key</code> command within the argument of an
<code>@kbd</code> command when the sequence of characters to be typed
includes one or more keys that are described by name.
@@ -474,6 +476,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@kbd{C-x @key{ESC}}
</pre></td></tr></table>
+
<p>Here is a list of the recommended names for keys:
<a name="IDX126"></a>
<a name="IDX127"></a>
@@ -625,6 +628,7 @@
<table><tr><td> </td><td><pre class="example">How many <tt>@
</tt>-escapes does one need to print this
<tt>@a @b @c</tt> string or these <tt>@'e?`{}!`\</tt> this?
</pre></td></tr></table>
+
<p>This is in contrast to <code>@samp</code> (see the previous
section), whose argument is normal Texinfo text, where the characters
<code>@{}</code> are special; with <code>@verb</code>, nothing is special
except
@@ -682,7 +686,6 @@
<blockquote><p>To delete file <var>filename</var>, type <samp>`rm
<var>filename</var>'</samp>.
</p></blockquote>
-
<p>(Note that <code>@var</code> may appear inside <code>@code</code>,
<code>@samp</code>, <code>@file</code>, etc.)
</p>
@@ -702,6 +705,7 @@
@setfilename <var>info-file-name</var>
@settitle <var>name-of-manual</var>
</pre></td></tr></table>
+
<p>In some documentation styles, metasyntactic variables are shown with
angle brackets, for example:
</p>
@@ -743,7 +747,8 @@
For example:
</p>
<table><tr><td> </td><td><pre class="example">The @env{PATH} environment
variable …
-</pre></td></tr></table><p>produces
+</pre></td></tr></table>
+<p>produces
</p><blockquote><p>The <code>PATH</code> environment variable …
</p></blockquote>
@@ -816,7 +821,8 @@
For example:
</p>
<table><tr><td> </td><td><pre class="example">The command @command{ls}
lists directory contents.
-</pre></td></tr></table><p>produces
+</pre></td></tr></table>
+<p>produces
</p><blockquote><p>The command <code>ls</code> lists directory contents.
</p></blockquote>
@@ -857,7 +863,8 @@
For example:
</p>
<table><tr><td> </td><td><pre class="example">The option @option{-l}
produces a long listing.
-</pre></td></tr></table><p>produces
+</pre></td></tr></table>
+<p>produces
</p><blockquote><p>The option <samp>`-l'</samp> produces a long listing.
</p></blockquote>
@@ -999,11 +1006,13 @@
</p>
<table><tr><td> </td><td><pre class="example">For example, the url might
be @url{http://example.org/path}.
</pre></td></tr></table>
+
<p>which produces:
</p>
<table><tr><td> </td><td><pre class="display">For example, the url might
be <a href="http://example.org/path">http://example.org/path</a>.
</pre></td></tr></table>
+
<hr size="6">
<a name="email"></a>
<a name="SEC136"></a>
@@ -1037,11 +1046,13 @@
</p>
<table><tr><td> </td><td><pre class="example">Send bug reports to
@email{bug-texinfo@@gnu.org},
suggestions to the @email{bug-texinfo@@gnu.org, same place}.
-</pre></td></tr></table><p>produces
+</pre></td></tr></table>
+<p>produces
</p><table><tr><td> </td><td><pre class="display">Send bug reports to <a
href="mailto:address@hidden">address@hidden</a>,
suggestions to the <a href="mailto:address@hidden">same place</a>.
</pre></td></tr></table>
+
<hr size="6">
<a name="Emphasis"></a>
<a name="SEC137"></a>
@@ -1119,6 +1130,7 @@
<table><tr><td> </td><td><pre class="example"> *Caution*: `rm *
.[^.]*' removes _all_
files in the directory.
</pre></td></tr></table>
+
<p>The <code>@strong</code> command is seldom used except to mark what is, in
effect, a typographical element, such as the word `Caution' in the
preceding example.
@@ -1165,6 +1177,7 @@
</p>
<table><tr><td> </td><td><pre class="display">The ACM and IEEE are
technical societies.
</pre></td></tr></table>
+
<p>TeX typesets the small caps font in a manner that prevents the
letters from `jumping out at you on the page'. This makes small caps
text easier to read than text in all upper case—but it's usually
@@ -1234,6 +1247,7 @@
</p>
<table><tr><td> </td><td><pre class="lisp">(+ 2 2) ; Add two plus two.
</pre></td></tr></table>
+
<p>If possible, you should avoid using the other three font commands. If
you need to use one, it probably indicates a gap in the Texinfo
language.
Index: texi2html/Tests/texinfo_res/texinfo_11.html
diff -u texi2html/Tests/texinfo_res/texinfo_11.html:1.25
texi2html/Tests/texinfo_res/texinfo_11.html:1.26
--- texi2html/Tests/texinfo_res/texinfo_11.html:1.25 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/texinfo_res/texinfo_11.html Sat Mar 25 13:26:47 2006
@@ -307,6 +307,7 @@
significant. In the Info file, an analogous result is
obtained by indenting each line with five spaces.
</pre></td></tr></table>
+
<p>Write an <code>@example</code> command at the beginning of a line by itself.
Mark the end of the example
with an <code>@end example</code> command, also written at the beginning of a
@@ -323,6 +324,7 @@
</p>
<table><tr><td> </td><td><pre class="example">mv foo bar
</pre></td></tr></table>
+
<p>The lines containing <code>@example</code> and <code>@end example</code>
will disappear from the output.
To make the output look good,
@@ -443,6 +445,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@verbatiminclude
<var>filename</var>
</pre></td></tr></table>
+
<p>The contents of <var>filename</var> is printed in a verbatim environment
(see section <a href="#SEC145"><code>@verbatim</code></a>). Generally, the
file is printed
exactly as it is, with all special characters and white space retained.
@@ -475,6 +478,7 @@
<table><tr><td> </td><td><pre class="lisp">This is an example of text
written between an
<code>@lisp</code> command and an <code>@end lisp</code> command.
</pre></td></tr></table>
+
<p>Use <code>@lisp</code> instead of <code>@example</code> to preserve
information
regarding the nature of the example. This is useful, for example, if
you write a function that evaluates only and all the Lisp code in a
@@ -526,6 +530,7 @@
<code>@end smallexample</code>. In Info this text appears in its normal size;
but in a 7 by 9.25 inch manual, this text appears in a smaller font.
</pre></td></tr></table>
+
<p>The <code>@small…</code> commands make it easier to prepare manuals
without forcing you to edit examples by hand to fit them onto narrower
pages.
@@ -572,6 +577,7 @@
and an <code>@end display</code> command. The <code>@display</code> command
indents the text, but does not fill it.
</pre></td></tr></table>
+
<a name="IDX133"></a>
<p>Texinfo also provides a command <code>@smalldisplay</code>, which is like
<code>@display</code> but uses a smaller font in <code>@smallbook</code>
format.
@@ -608,6 +614,7 @@
from this example,
the <code>@format</code> command does not fill the text.
</pre></td></tr></table>
+
<a name="IDX134"></a>
<p>Texinfo also provides a command <code>@smallformat</code>, which is like
<code>@format</code> but uses a smaller font in <code>@smallbook</code> format.
@@ -659,6 +666,7 @@
This line follows the exdented line.
The @end example comes on the next line.
</pre></td></tr></table>
+
<p>In practice, the <code>@exdent</code> command is rarely used.
Usually, you un-indent text by ending the example and
returning the page to its normal width.
@@ -769,13 +777,14 @@
<p>produces
</p>
<table><tr><td> </td><td><table><tr><td> </td><td><pre
class="example">This is an example
-</pre></td></tr></table><pre class="display">
-
+</pre></td></tr></table>
+<pre class="display">
This line is not indented. As you can see, the
beginning of the line is fully flush left with the line
that follows after it. (This whole example is between
<code>@display</code> and <code>@end display</code>.)
</pre></td></tr></table>
+
<p>To adjust the number of blank lines properly in the Info file output,
remember that the line containing <code>@noindent</code> does not generate a
blank line, and neither does the <code>@end example</code> line.
Index: texi2html/Tests/texinfo_res/texinfo_12.html
diff -u texi2html/Tests/texinfo_res/texinfo_12.html:1.29
texi2html/Tests/texinfo_res/texinfo_12.html:1.30
--- texi2html/Tests/texinfo_res/texinfo_12.html:1.29 Mon Nov 14 11:13:59 2005
+++ texi2html/Tests/texinfo_res/texinfo_12.html Sat Mar 25 13:26:47 2006
@@ -121,7 +121,6 @@
command.
</p>
<br>
-
<p>Here is an itemized list of the different kinds of table and lists:
</p>
<ul>
@@ -136,7 +135,6 @@
</li></ul>
<br>
-
<p>Here is an enumerated list with the same items:
</p>
<ol>
@@ -151,7 +149,6 @@
</li></ol>
<br>
-
<p>And here is a two-column table with the same items and their
@-commands:
</p>
@@ -608,7 +605,6 @@
</p></dd>
</dl>
-
<p>(Note also that this example illustrates multi-line supporting text in
a two-column table.)
</p>
@@ -685,6 +681,7 @@
<table><tr><td> </td><td><pre class="example">@multitable
@columnfractions .33 .33 .33
</pre></td></tr></table>
+
<p>The fractions need not add up exactly to 1.0, as these do
not. This allows you to produce tables that do not need the full line
length. You can use a leading zero if you wish.
@@ -755,6 +752,7 @@
split that window.
@end multitable
</pre></td></tr></table>
+
<p>produces:
</p>
<table>
Index: texi2html/Tests/texinfo_res/texinfo_13.html
diff -u texi2html/Tests/texinfo_res/texinfo_13.html:1.23
texi2html/Tests/texinfo_res/texinfo_13.html:1.24
--- texi2html/Tests/texinfo_res/texinfo_13.html:1.23 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_13.html Sat Mar 25 13:26:47 2006
@@ -191,7 +191,6 @@
header files).
</li></ul>
-
<p>Not every manual needs all of these, and most manuals use two or three
of them. This manual has two indices: a
concept index and an @-command index (that is actually the function
@@ -237,6 +236,7 @@
@cindex Specifying index entries
@cindex Creating index entries
</pre></td></tr></table>
+
<p>Each predefined index has its own indexing
command—<code>@cindex</code>
for the concept index, <code>@findex</code> for the function index, and so
on.
@@ -403,6 +403,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@syncodeindex
<var>from</var> <var>to</var>
</pre></td></tr></table>
+
<a name="IDX155"></a>
<a name="IDX156"></a>
<a name="IDX157"></a>
@@ -447,6 +448,7 @@
<table><tr><td> </td><td><pre class="example">@syncodeindex vr cp
@syncodeindex fn cp
</pre></td></tr></table>
+
<a name="IDX159"></a>
<p>The <code>@syncodeindex</code> command puts all the entries from the `from'
index (the redirected index) into the <code>@code</code> font, overriding
@@ -514,11 +516,13 @@
</p>
<table><tr><td> </td><td><pre class="example">@defindex <var>name</var>
</pre></td></tr></table>
+
<p>The name of an index should be a two letter word, such as <samp>`au'</samp>.
For example:
</p>
<table><tr><td> </td><td><pre class="example">@defindex au
</pre></td></tr></table>
+
<p>This defines a new index, called the <samp>`au'</samp> index. At the same
time, it creates a new indexing command, <code>@auindex</code>, that you
can use to make index entries. Use the new indexing command just as
@@ -546,6 +550,7 @@
@printindex au
</pre></td></tr></table>
+
<p>The <code>@defcodeindex</code> is like the <code>@defindex</code> command,
except
that, in the printed output, it prints entries in an <code>@code</code> font
instead of a roman font. Thus, it parallels the <code>@findex</code> command
Index: texi2html/Tests/texinfo_res/texinfo_14.html
diff -u texi2html/Tests/texinfo_res/texinfo_14.html:1.25
texi2html/Tests/texinfo_res/texinfo_14.html:1.26
--- texi2html/Tests/texinfo_res/texinfo_14.html:1.25 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_14.html Sat Mar 25 13:26:47 2006
@@ -292,7 +292,6 @@
The s.o.p. has three parts …
</p></blockquote>
-
<p>(Incidentally, <samp>`s.o.p.'</samp> is an abbreviation for “Standard
Operating
Procedure”.)
</p>
@@ -390,10 +389,12 @@
</p><table><tr><td> </td><td><pre class="example">Spacey@ @ @ @
example.
</pre></td></tr></table>
+
<p>produces
</p>
<table><tr><td> </td><td><pre
class="example">Spacey example.
</pre></td></tr></table>
+
<p>Other possible uses of <code>@<kbd>SPACE</kbd></code> have been subsumed by
<code>@multitable</code> (see section <a
href="texinfo_12.html#SEC163">Multi-column Tables</a>).
</p>
@@ -892,10 +893,12 @@
</p>
<table><tr><td> </td><td><pre class="example">@math{(a + b)(a + b) = a^2
+ 2ab + b^2}
</pre></td></tr></table>
+
<p>This produces the following in Info:
</p>
<table><tr><td> </td><td><pre class="example">(a + b)(a + b) = a^2 + 2ab
+ b^2
</pre></td></tr></table>
+
<p>Thus, the <code>@math</code> command has no effect on the Info output.
</p>
<p><code>@math</code> implies <code>@tex</code>. This not only makes it
possible to
@@ -905,9 +908,11 @@
As in:
</p><table><tr><td> </td><td><pre class="example">@math{\sin 2\pi \equiv
\cos 3\pi}
</pre></td></tr></table>
+
<p>which looks like the input in Info and HTML:
</p><table><tr><td> </td><td><pre class="example">\sin 2\pi \equiv \cos
3\pi
</pre></td></tr></table>
+
<a name="IDX224"></a>
<p>Since <samp>`\'</samp> is an escape character inside <code>@math</code>,
you can use
<code>@\</code> to get a literal backslash (<code>\\</code> will work in TeX,
@@ -1126,7 +1131,6 @@
the result of evaluating the expression is <code>c</code>.
</p></blockquote>
-
<p>Often, as in this case, an example looks better if the
<code>@expansion{}</code> and <code>@result{}</code> commands are indented
five spaces.
@@ -1180,6 +1184,7 @@
@end lisp
</pre></td></tr></table>
+
<hr size="6">
<a name="Error-Glyph"></a>
<a name="SEC198"></a>
@@ -1226,6 +1231,7 @@
</p>
<table><tr><td> </td><td><pre class="lisp">Wrong type argument:
integer-or-marker-p, x
</pre></td></tr></table>
+
<p><samp>`error-->'</samp> itself is not part of the error message.
</p>
@@ -1314,6 +1320,7 @@
---------- Buffer: foo ----------
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="example">(insert "changed
")
⇒ nil
---------- Buffer: foo ----------
@@ -1321,6 +1328,7 @@
---------- Buffer: foo ----------
</pre></td></tr></table>
+
<p>In a Texinfo source file, the example is written like this:
</p>
<table><tr><td> </td><td><pre class="example">@example
@@ -1336,6 +1344,7 @@
@end example
</pre></td></tr></table>
+
<hr size="6">
<a name="Footnotes"></a>
<a name="SEC201"></a>
@@ -1397,6 +1406,7 @@
</p>
<table><tr><td> </td><td><pre class="example">ordinary
address@hidden<var>text of footnote</var>}
</pre></td></tr></table>
+
<p>As shown here, the <code>@footnote</code> command should come right after
the
text being footnoted, with no intervening space; otherwise, the footnote
marker might end up starting a line.
@@ -1407,6 +1417,7 @@
<table><tr><td> </td><td><pre class="example">…a sample
address@hidden is the sample
footnote.}; in the Texinfo source…
</pre></td></tr></table>
+
<p>As you can see, the source includes two punctuation marks next to each
other; in this case, <samp>`.};'</samp> is the sequence. This is normal (the
first ends the footnote and the second belongs to the sentence being
@@ -1463,13 +1474,13 @@
<samp>`Footnotes'</samp> within it. Each footnote begins with an
<samp>`(<var>n</var>)'</samp> reference mark.
-
<p>Here is an example of a single footnote in the end of node style:
</p>
<table><tr><td> </td><td><pre class="example"> --------- Footnotes
---------
(1) Here is a sample footnote.
</pre></td></tr></table>
+
<a name="IDX228"></a>
</li><li>
In the `Separate' node style, all the footnotes for a single
@@ -1486,7 +1497,6 @@
<tt>`Footnotes-Footnotes'</tt>!) The footnotes' node has an
`Up' node pointer that leads back to its parent node.
</p>
-
<p>Here is how the first footnote in this manual looks after being
formatted for Info in the separate node style:
</p>
@@ -1494,7 +1504,8 @@
(1) The first syllable of "Texinfo" is pronounced like
"speck", not
"hex". …
-</pre></td></tr></table></li></ul>
+</pre></td></tr></table>
+</li></ul>
<p>A Texinfo file may be formatted into an Info file with either footnote
style.
@@ -1512,6 +1523,7 @@
<p>or
</p><table><tr><td> </td><td><pre class="example">@footnotestyle separate
</pre></td></tr></table>
+
<p>Write an <code>@footnotestyle</code> command before or shortly after the
end-of-header line at the beginning of a Texinfo file. (If you
include the <code>@footnotestyle</code> command between the start-of-header
@@ -1553,6 +1565,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@image{<var>filename</var>,
[<var>width</var>], [<var>height</var>], [<var>alttext</var>],
[<var>extension</var>]}
</pre></td></tr></table>
+
<a name="IDX230"></a>
<a name="IDX231"></a>
<p>The <var>filename</var> argument is mandatory, and must not have an
@@ -1648,6 +1661,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@image{ridt,,1in}
</pre></td></tr></table>
+
<a name="IDX252"></a>
<p>For <code>@image</code> to work with TeX, the file <tt>`epsf.tex'</tt> must
be
installed somewhere that TeX can find it. (The standard location is
Index: texi2html/Tests/texinfo_res/texinfo_15.html
diff -u texi2html/Tests/texinfo_res/texinfo_15.html:1.25
texi2html/Tests/texinfo_res/texinfo_15.html:1.26
--- texi2html/Tests/texinfo_res/texinfo_15.html:1.25 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_15.html Sat Mar 25 13:26:47 2006
@@ -263,7 +263,8 @@
<dd><p>Tell TeX how to hyphenate <var>hy-phen-a-ted words</var>. As shown, you
put a <samp>`-'</samp> at each hyphenation point. For example:
</p><table><tr><td> </td><td><pre
class="example">@hyphenation{man-u-script man-u-scripts}
-</pre></td></tr></table><p>TeX only uses the specified hyphenation points when
the
+</pre></td></tr></table>
+<p>TeX only uses the specified hyphenation points when the
words match exactly, so give all necessary variants.
</p></dd>
</dl>
@@ -314,6 +315,7 @@
<table><tr><td> </td><td><pre class="example">None of the formatters will
break at address@hidden }space.
</pre></td></tr></table>
+
<hr size="6">
<a name="sp"></a>
<a name="SEC210"></a>
@@ -472,6 +474,7 @@
<table><tr><td> </td><td><pre class="example">@need 800
This paragraph is preceded by …
</pre></td></tr></table>
+
<p>The <code>@need</code> command is useful for preventing orphans (single
lines at the bottoms of printed pages).
</p>
Index: texi2html/Tests/texinfo_res/texinfo_16.html
diff -u texi2html/Tests/texinfo_res/texinfo_16.html:1.24
texi2html/Tests/texinfo_res/texinfo_16.html:1.25
--- texi2html/Tests/texinfo_res/texinfo_16.html:1.24 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_16.html Sat Mar 25 13:26:47 2006
@@ -226,7 +226,6 @@
</p></dd></dl>
</blockquote>
-
<p>See section <a href="#SEC226">A Sample Function Definition</a>, for a more
detailed example of a function
definition, including the use of <code>@example</code> inside the
definition.
@@ -282,7 +281,6 @@
</dl>
</blockquote>
-
<p>In this example, the arguments <var>from</var> and <var>to</var> are
optional,
but must both be present or both absent. If they are present,
<var>inc</var> may optionally be specified as well. These arguments are
@@ -462,6 +460,7 @@
<var>body-of-definition</var>
@end deffn
</pre></td></tr></table>
+
<a name="IDX267"></a>
</dd>
<dt> <code>@defun <var>name</var> <var>arguments</var>…</code></dt>
@@ -469,7 +468,6 @@
<code>@defun</code> is equivalent to <samp>address@hidden Function
…'</samp>.
</p>
-
<p>For example,
</p>
<table><tr><td> </td><td><pre class="example">@defun set symbol new-value
@@ -490,6 +488,7 @@
<var>body-of-definition</var>
@end defun
</pre></td></tr></table>
+
<p><code>@defun</code> creates an entry in the index of functions.
</p>
<a name="IDX268"></a>
@@ -557,6 +556,7 @@
…
@end defvr
</pre></td></tr></table>
+
<p>Terminate the definition with <code>@end defvr</code> on a line of its
own.
</p>
@@ -566,6 +566,7 @@
<var>body-of-definition</var>
@end defvr
</pre></td></tr></table>
+
<p><code>@defvr</code> creates an entry in the index of variables for
<var>name</var>.
</p>
<a name="IDX271"></a>
@@ -581,12 +582,14 @@
…
@end defvar
</pre></td></tr></table>
+
<p>The template is:
</p>
<table><tr><td> </td><td><pre class="example">@defvar <var>name</var>
<var>body-of-definition</var>
@end defvar
</pre></td></tr></table>
+
<p><code>@defvar</code> creates an entry in the index of variables for
<var>name</var>.
</p>
@@ -638,7 +641,6 @@
being described, the type of the returned value, the name of this
particular entity, and its arguments, if any.
</p>
-
<p>For example,
</p>
<table><tr><td> </td><td><pre class="example">@deftypefn {Library
Function} int foobar
@@ -654,6 +656,7 @@
<table><tr><td> </td><td><pre class="smallexample">-- Library Function:
int foobar (int FOO, float BAR)
…
</pre></td></tr></table>
+
<p>This means that <code>foobar</code> is a “library function”
that returns an
<code>int</code>, and its arguments are <var>foo</var> (an <code>int</code>)
and
<var>bar</var> (a <code>float</code>).
@@ -680,7 +683,6 @@
somewhat contrary to the convention described in the preceding
paragraphs.
</p>
-
<p>For example:
</p>
<table><tr><td> </td><td><pre class="example">@deftypefn stacks private
push
@@ -708,7 +710,6 @@
for functions in typed languages. The command is equivalent to
<samp>address@hidden Function …'</samp>.
</p>
-
<p>Thus,
</p>
<table><tr><td> </td><td><pre class="smallexample">@deftypefun int foobar
(int @var{foo}, float @var{bar})
@@ -721,12 +722,14 @@
<table><tr><td> </td><td><pre class="example">-- Function: int foobar
(int FOO, float BAR)
…
</pre></td></tr></table>
+
<p>The template is:
</p>
<table><tr><td> </td><td><pre class="example">@deftypefun <var>type</var>
<var>name</var> <var>arguments</var>…
<var>body-of-description</var>
@end deftypefun
</pre></td></tr></table>
+
<p><code>@deftypefun</code> creates an entry in the index of functions for
<var>name</var>.
</p>
@@ -776,7 +779,6 @@
being described, the data type, and the name of this particular
entity.
</p>
-
<p>For example:
</p>
<table><tr><td> </td><td><pre class="example">@deftypevr {Global Flag}
int enable
@@ -789,12 +791,14 @@
<table><tr><td> </td><td><pre class="example">-- Global Flag: int enable
…
</pre></td></tr></table>
+
<p>The template is:
</p>
<table><tr><td> </td><td><pre class="example">@deftypevr
<var>category</var> <var>data-type</var> <var>name</var>
<var>body-of-description</var>
@end deftypevr
</pre></td></tr></table>
+
<p><code>@deftypevr</code> creates an entry in the index of variables for
<var>name</var>.
</p>
@@ -805,7 +809,6 @@
for variables in typed languages. <code>@deftypevar</code> is equivalent
to <samp>address@hidden Variable …'</samp>.
</p>
-
<p>For example:
</p>
<table><tr><td> </td><td><pre class="example">@deftypevar int fubar
@@ -825,6 +828,7 @@
<var>body-of-description</var>
@end deftypevar
</pre></td></tr></table>
+
<p><code>@deftypevar</code> creates an entry in the index of variables for
<var>name</var>.
</p></dd>
@@ -885,6 +889,7 @@
…
@end defcv
</pre></td></tr></table>
+
<p><code>@defcv</code> creates an entry in the index of variables.
</p>
<a name="IDX279"></a>
@@ -899,6 +904,7 @@
<var>body-of-definition</var>
@end defivar
</pre></td></tr></table>
+
<p><code>@defivar</code> creates an entry in the index of variables.
</p>
<a name="IDX280"></a>
@@ -941,6 +947,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@defop Operation windows
expose
</pre></td></tr></table>
+
<p>The <code>@defop</code> command is written at the beginning of a line and
is followed on the same line by the overall name of the category of
operation, the name of the class of the operation, the name of the
@@ -951,6 +958,7 @@
<var>body-of-definition</var>
@end defop
</pre></td></tr></table>
+
<p><code>@defop</code> creates an entry, such as `<code>expose</code> on
<code>windows</code>', in the index of functions.
</p>
@@ -976,7 +984,6 @@
the name of the class of the method, the name of the method, and its
arguments, if any.
</p>
-
<p>For example:
</p><table><tr><td> </td><td><pre class="example">@defmethod
<code>bar-class</code> bar-method argument
…
@@ -992,6 +999,7 @@
<var>body-of-definition</var>
@end defmethod
</pre></td></tr></table>
+
<p><code>@defmethod</code> creates an entry, such as `<code>bar-method</code>
on
<code>bar-class</code>', in the index of functions.
</p>
@@ -1054,12 +1062,14 @@
…
@end deftp
</pre></td></tr></table>
+
<p>The template is:
</p>
<table><tr><td> </td><td><pre class="example">@deftp <var>category</var>
<var>name-of-type</var> <var>attributes</var>…
<var>body-of-definition</var>
@end deftp
</pre></td></tr></table>
+
<p><code>@deftp</code> creates an entry in the index of data types.
</p></dd>
</dl>
@@ -1147,6 +1157,7 @@
(apply 'append '((a b c) nil (x y z) nil))
⇒ (a b c x y z)
</pre></td></tr></table>
+
<p>An interesting example of using <code>apply</code> is found in the
description
of <code>mapcar</code>.
</p></dd></dl>
Index: texi2html/Tests/texinfo_res/texinfo_17.html
diff -u texi2html/Tests/texinfo_res/texinfo_17.html:1.25
texi2html/Tests/texinfo_res/texinfo_17.html:1.26
--- texi2html/Tests/texinfo_res/texinfo_17.html:1.25 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_17.html Sat Mar 25 13:26:47 2006
@@ -172,7 +172,6 @@
However, this text will appear only in Info (or plain text).
And this text will only appear in HTML.
</p>
-
<p>Notice that you only see one of the input lines, depending on which
version of the manual you are reading.
</p>
@@ -217,6 +216,7 @@
<code>@ifnotplaintext</code>, like this:
</p><table><tr><td> </td><td><pre class="example">This will be in Info,
but not plain text.
</pre></td></tr></table>
+
<p>The regions delimited by these commands are ordinary Texinfo source as
with <code>@iftex</code>, not raw formatter source as with <code>@tex</code>
(see section <a href="#SEC230">Raw Formatter Commands</a>).
@@ -394,6 +394,7 @@
to this:
This is a string.
</pre></td></tr></table>
+
<p>You can write an <code>@value</code> command within a paragraph; but you
must write an <code>@set</code> command on a line of its own.
</p>
@@ -418,6 +419,7 @@
into
It is a very, very, very wet day.
</pre></td></tr></table>
+
<p>If you write
</p>
<table><tr><td> </td><td><pre class="example">@clear how-much
@@ -430,6 +432,7 @@
It is a {No value for "how-much"} wet day.
</pre></td></tr></table>
+
<hr size="6">
<a name="ifset-ifclear"></a>
<a name="SEC233"></a>
@@ -464,6 +467,7 @@
<var>conditional-text</var>
@end ifset
</pre></td></tr></table>
+
<p>For example, you can create one document that has two variants, such as
a manual for a `large' and `small' model:
</p>
@@ -510,6 +514,7 @@
<table><tr><td> </td><td><pre class="example">@ifclear <var>flag</var>
</pre></td></tr></table>
+
<hr size="6">
<a name="value-Example"></a>
<a name="SEC234"></a>
@@ -546,6 +551,7 @@
@set UPDATED 14 August 1992
@set UPDATE-MONTH August 1992
</pre></td></tr></table>
+
</li><li>
Write text for the <code>@copying</code> section (see section <a
href="texinfo_4.html#SEC50"><code>@copying</code>: Declare copying
permissions</a>):
@@ -560,6 +566,7 @@
Permission is granted …
@end copying
</pre></td></tr></table>
+
</li><li>
Write text for the title page, for people reading the printed manual:
@@ -588,12 +595,14 @@
…
@end ifnottex
</pre></td></tr></table>
+
<p>After you format the manual, the <code>@value</code> constructs have been
expanded, so the output contains text like this:
</p>
<table><tr><td> </td><td><pre class="example">This is Edition 0.35 Beta,
last updated 14 August 1992,
of `The GNU Make Manual', for `make', Version 3.63 Beta.
-</pre></td></tr></table></li></ol>
+</pre></td></tr></table>
+</li></ol>
<p>When you update the manual, you change only the values of the flags; you
do not need to edit the three sections.
Index: texi2html/Tests/texinfo_res/texinfo_18.html
diff -u texi2html/Tests/texinfo_res/texinfo_18.html:1.19
texi2html/Tests/texinfo_res/texinfo_18.html:1.20
--- texi2html/Tests/texinfo_res/texinfo_18.html:1.19 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_18.html Sat Mar 25 13:26:47 2006
@@ -410,6 +410,7 @@
charset=<var>enc</var>">
</pre></td></tr></table>
+
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#SEC235" title="Beginning of
this chapter or previous chapter"> << </a>]</td>
Index: texi2html/Tests/texinfo_res/texinfo_19.html
diff -u texi2html/Tests/texinfo_res/texinfo_19.html:1.23
texi2html/Tests/texinfo_res/texinfo_19.html:1.24
--- texi2html/Tests/texinfo_res/texinfo_19.html:1.23 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_19.html Sat Mar 25 13:26:47 2006
@@ -143,6 +143,7 @@
<var>text</var> … \<var>param1</var>\ …
@end macro
</pre></td></tr></table>
+
<p>The <em>parameters</em> <var>param1</var>, <var>param2</var>, …
correspond to
arguments supplied when the macro is subsequently used in the document
(described in the next section).
@@ -191,6 +192,7 @@
…
@address@hidden
</pre></td></tr></table>
+
<p>This produces the output `a1atextb2b'. With <samp>address@hidden'</samp>
instead of
<samp>address@hidden'</samp>, an error message is given.
</p>
@@ -204,6 +206,7 @@
<table><tr><td> </td><td><pre class="example">@unmacro foo
</pre></td></tr></table>
+
<hr size="6">
<a name="Invoking-Macros"></a>
<a name="SEC240"></a>
@@ -230,6 +233,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@<var>macroname</var>
{<var>arg1</var>, <var>arg2</var>, …}
</pre></td></tr></table>
+
<p>and the result will be just as if you typed the body of
<var>macroname</var> at that spot. For example:
</p>
@@ -238,10 +242,12 @@
@end macro
@foo{a, b}
</pre></td></tr></table>
+
<p>produces:
</p>
<table><tr><td> </td><td><pre class="display">Together: a & b.
</pre></td></tr></table>
+
<a name="IDX315"></a>
<p>Thus, the arguments and parameters are separated by commas and delimited
by braces; any whitespace after (but not before) a comma is ignored.
@@ -254,10 +260,12 @@
@end macro
@argless{}
</pre></td></tr></table>
+
<p>produces:
</p>
<table><tr><td> </td><td><pre class="display">No arguments here.
</pre></td></tr></table>
+
<a name="IDX316"></a>
<a name="IDX317"></a>
<p>To insert a comma, brace, or backslash in an argument, prepend a
@@ -279,10 +287,12 @@
@end macro
@bar aah
</pre></td></tr></table>
+
<p>produces:
</p>
<table><tr><td> </td><td><pre class="display">Twice: aah & aah.
</pre></td></tr></table>
+
<p>If the macro is defined to take a single argument, and is invoked with
braces, the braced text is passed as the argument, regardless of
commas. For example:
@@ -292,11 +302,13 @@
@end macro
@bar{a,b}
</pre></td></tr></table>
+
<p>produces:
</p>
<table><tr><td> </td><td><pre class="display">Twice: a,b & a,b.
</pre></td></tr></table>
+
<hr size="6">
<a name="Macro-Details"></a>
<a name="SEC241"></a>
@@ -352,6 +364,7 @@
\gdef\ctorx#1,#2,{\def#1{something involving #2 somehow}}
@end tex
</pre></td></tr></table>
+
</li><li>
It is best to avoid comments inside macro definitions.
@@ -392,6 +405,7 @@
Whitespace around the equals sign is ignored. Thus:
</p><table><tr><td> </td><td><pre class="example">@alias <var>new</var> =
<var>existing</var>
</pre></td></tr></table>
+
<p>For example, if your document contains citations for both books and
some other media (movies, for example), you might like to define a
macro <code>@moviecite{}</code> that does the same thing as an ordinary
@@ -400,6 +414,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@alias moviecite = cite
</pre></td></tr></table>
+
<p>Macros do not always have the same effect due to vagaries of argument
parsing. Also, aliases are much simpler to define than macros. So the
command is not redundant. (It was also heavily used in the Jargon File!)
Index: texi2html/Tests/texinfo_res/texinfo_2.html
diff -u texi2html/Tests/texinfo_res/texinfo_2.html:1.26
texi2html/Tests/texinfo_res/texinfo_2.html:1.27
--- texi2html/Tests/texinfo_res/texinfo_2.html:1.26 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_2.html Sat Mar 25 13:26:47 2006
@@ -370,6 +370,7 @@
info:emacs#Dissociated%20Press
info://localhost/usr/info/emacs#Dissociated%20Press
</pre></td></tr></table>
+
<p>The <code>info</code> program itself does not follow URI's of any kind.
</p>
@@ -523,7 +524,6 @@
appear in the output, so beware.
</li></ul>
-
<a name="IDX14"></a>
<p>As a general rule, a command requires braces if it mingles among other
text; but it does not need braces if it starts a line of its own. The
@@ -611,11 +611,9 @@
with tabs, and thus a tab character in your input file may appear
differently in the output, for example, in indented text.
</p>
-
<p>To avoid this problem, Texinfo mode causes GNU Emacs to insert multiple
spaces when you press the <kbd>TAB</kbd> key.
</p>
-
<p>Also, you can run <code>untabify</code> in Emacs to convert tabs in a region
to multiple spaces.
</p></blockquote>
@@ -718,8 +716,8 @@
</p>
<table><tr><td> </td><td><pre class="example">@bye
</pre></td></tr></table>
-<a name="IDX19"></a>
+<a name="IDX19"></a>
<p>Here's an explanation:
</p>
<ul>
@@ -874,7 +872,6 @@
<a name="SEC13"></a>
<h3 class="subheading"> Part 1: Header </h3>
-
<p>The header does not appear in either the Info file or the
printed output. It sets various parameters, including the
name of the Info file and the title used in the header.
@@ -885,10 +882,10 @@
@settitle Sample Manual 1.0
@c %**end of header
</pre></td></tr></table>
+
<a name="SEC14"></a>
<h3 class="subheading"> Part 2: Summary Description and Copyright </h3>
-
<p>A real manual includes more text here, according to the license under
which it is distributed. See section <a href="texinfo_24.html#SEC296">GNU
Sample Texts</a>.
</p>
@@ -898,10 +895,10 @@
Copyright @copyright{} 2002 Free Software Foundation, Inc.
@end copying
</pre></td></tr></table>
+
<a name="SEC15"></a>
<h3 class="subheading"> Part 3: Titlepage, Contents, Copyright </h3>
-
<p>The titlepage segment does not appear in the online output, only in the
printed manual. We use the <code>@insertcopying</code> command to
include the permission text from the previous section, instead of
@@ -920,10 +917,10 @@
@c Output the table of contents at the beginning.
@contents
</pre></td></tr></table>
+
<a name="SEC16"></a>
<h3 class="subheading"> Part 4: `Top' Node and Master Menu </h3>
-
<p>The `Top' node contains the master menu for the Info file. Since a
printed manual uses a table of contents rather than a menu, the master
menu appears only in online output. We also include the copying text
@@ -934,6 +931,7 @@
@node Top
@end ifnottex
</pre></td></tr></table>
+
<table><tr><td> </td><td><pre class="example">@insertcopying
@menu
@@ -943,10 +941,10 @@
@end menu
</pre></td></tr></table>
+
<a name="SEC17"></a>
<h3 class="subheading"> Part 5: The Body of the Document </h3>
-
<p>The body segment contains all the text of the document, but not the
indices or table of contents. This example illustrates a node and a
chapter containing an enumerated list.
@@ -970,10 +968,10 @@
@end enumerate
</pre></td></tr></table>
+
<a name="SEC18"></a>
<h3 class="subheading"> Part 6: The End of the Document </h3>
-
<p>The end segment contains commands for generating an index in a node and
unnumbered chapter of its own, and the <code>@bye</code> command that marks
the end of the document.
@@ -986,6 +984,7 @@
@bye
</pre></td></tr></table>
+
<a name="SEC19"></a>
<h3 class="subheading"> Some Results </h3>
Index: texi2html/Tests/texinfo_res/texinfo_20.html
diff -u texi2html/Tests/texinfo_res/texinfo_20.html:1.26
texi2html/Tests/texinfo_res/texinfo_20.html:1.27
--- texi2html/Tests/texinfo_res/texinfo_20.html:1.26 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_20.html Sat Mar 25 13:26:47 2006
@@ -183,6 +183,7 @@
</p>
<table><tr><td> </td><td><pre class="example">tex foo.texi
</pre></td></tr></table>
+
<p>TeX will produce a <em>DVI file</em> as well as several auxiliary
files containing information for indices, cross references, etc. The
DVI file (for <em>DeVice Independent</em> file) can be printed on virtually
@@ -288,6 +289,7 @@
@setfilename myfile.info
…
</pre></td></tr></table>
+
<p><code>@novalidate</code> also turns off validation in
<code>makeinfo</code>, just like its <code>--no-validate</code> option
(see section <a href="texinfo_21.html#SEC265">Pointer Validation</a>).
@@ -325,6 +327,7 @@
</p>
<table><tr><td> </td><td><pre class="example">prompt$ <kbd>texi2dvi
foo.texi</kbd>
</pre></td></tr></table>
+
<p>As shown in this example, the input filenames to <code>texi2dvi</code> must
include any extension (<samp>`.texi'</samp>, <samp>`.texinfo'</samp>, etc.).
Under
MS-DOS and perhaps in other circumstances, you may need to run <samp>`sh
@@ -387,6 +390,7 @@
lpr -d bison.dvi
# or perhaps dvips bison.dvi -o
</pre></td></tr></table>
+
<a name="IDX330"></a>
<a name="IDX331"></a>
<a name="IDX332"></a>
@@ -411,6 +415,7 @@
<table><tr><td> </td><td><pre class="example">lpr -Qdvi
-hprint.server.domain bison.dvi
</pre></td></tr></table>
+
</li><li> Convert the DVI file to a Postscript or PCL file and send it to your
local printer. See <a
href="../dvips/dvips-invocation.html#dvips-invocation">(dvips)dvips
invocation</a> section `dvips invocation' in <cite>Dvips</cite>, and the man
pages for <code>dvilj</code>, for detailed description of these tools. Once
@@ -455,6 +460,7 @@
<table><tr><td> </td><td><pre class="example">texi2dvi gcc.texinfo
lpr -d gcc.dvi
</pre></td></tr></table>
+
<p>See section <a href="#SEC250">Formatting and Printing in Texinfo Mode</a>,
for more information about formatting
and printing in Texinfo mode.
</p>
@@ -549,6 +555,7 @@
C-c C-t C-p Print the DVI file.
C-c C-t C-q Display the printer queue.
</pre></td></tr></table>
+
<p>The Texinfo mode TeX formatting commands start a subshell in Emacs
called the <tt>`*tex-shell*'</tt>. The <code>texinfo-tex-command</code>,
<code>texinfo-texindex-command</code>, and <code>tex-dvi-print-command</code>
@@ -573,6 +580,7 @@
tex-dvi-print-command "lpr -d"
tex-show-queue-command "lpq"
</pre></td></tr></table>
+
<p>You can change the values of these variables with the <kbd>M-x
edit-options</kbd> command (see <a
href="../emacs/Edit-Options.html#Edit-Options">(emacs)Edit Options</a> section
`Editing Variable Values' in <cite>The GNU Emacs Manual</cite>), with the
<kbd>M-x set-variable</kbd> command
(see <a href="../emacs/Examining.html#Examining">(emacs)Examining</a> section
`Examining and Setting Variables' in <cite>The GNU Emacs Manual</cite>), or
with your <tt>`.emacs'</tt> initialization file
@@ -661,6 +669,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@bye
</pre></td></tr></table>
+
<p>Strictly speaking, these lines are all a Texinfo file needs to be
processed successfully by TeX.
</p>
@@ -758,12 +767,14 @@
</p>
<table><tr><td> </td><td><pre class="example">setenv TEXINPUTS
.:/home/me/mylib:/usr/lib/tex/macros
</pre></td></tr></table>
+
<p>In a <tt>`.profile'</tt> file, you could use the following <code>sh</code>
command
sequence:
</p>
<table><tr><td> </td><td><pre
class="example">TEXINPUTS=.:/home/me/mylib:/usr/lib/tex/macros
export TEXINPUTS
</pre></td></tr></table>
+
<p>On MS-DOS/MS-Windows, you would say it like this<a name="DOCF10"
href="texinfo_fot.html#FOOT10">(10)</a>:
</p>
<table><tr><td> </td><td><pre class="example">set
TEXINPUTS=.;d:/home/me/mylib;c:/usr/lib/tex/macros
@@ -772,7 +783,6 @@
<p>It is customary for DOS/Windows users to put such commands in the
<tt>`autoexec.bat'</tt> file, or in the Windows Registry.
</p>
-
<p>These settings would cause TeX to look for <tt>`\input'</tt> file first
in the current directory, indicated by the <samp>`.'</samp>, then in a
hypothetical user's <tt>`me/mylib'</tt> directory, and finally in a system
@@ -787,6 +797,7 @@
</p>
<table><tr><td> </td><td><pre class="example">initex texinfo @dump
</pre></td></tr></table>
+
<p>(<code>dump</code> is a TeX primitive.) Then, move <tt>`texinfo.fmt'</tt>
to
wherever your <code>.fmt</code> files are found; typically, this will be in the
subdirectory <tt>`web2c'</tt> of your TeX installation.
@@ -821,8 +832,8 @@
</p>
<table><tr><td> </td><td><pre class="example">Overfull @hbox (20.76302pt
too wide)
</pre></td></tr></table>
-<a name="IDX343"></a>
+<a name="IDX343"></a>
<p>(In TeX, lines are in “horizontal boxes”, hence the term,
“hbox”.
<samp>address@hidden'</samp> is a TeX primitive not needed in the Texinfo
language.)
</p>
@@ -871,6 +882,7 @@
<table><tr><td> </td><td><pre class="example">@finalout
</pre></td></tr></table>
+
<hr size="6">
<a name="smallbook"></a>
<a name="SEC255"></a>
@@ -951,6 +963,7 @@
@afourpaper
@c %**end of header
</pre></td></tr></table>
+
<p>See section <a href="#SEC247">Format with <code>texi2dvi</code></a>, and <a
href="#SEC253">Preparing for TeX</a>, for other ways to format for different
paper sizes that do not
require changing the source file.
</p>
@@ -987,8 +1000,10 @@
title page. The height comes first, then the width if desired,
separated by a comma. Examples:
</p>
-<table><tr><td> </td><td><pre class="example">@pagesizes 200mm,150mm
</pre></td></tr></table><p>and
+<table><tr><td> </td><td><pre class="example">@pagesizes 200mm,150mm
</pre></td></tr></table>
+<p>and
</p><table><tr><td> </td><td><pre class="example">@pagesizes 11.5in
</pre></td></tr></table>
+
<a name="IDX352"></a>
<a name="IDX353"></a>
<p>This would be reasonable for printing on B5-size paper. To emphasize,
@@ -1037,6 +1052,7 @@
@cropmarks
@end iftex
</pre></td></tr></table>
+
<p>This command is mainly for printers that typeset several pages on one
sheet of film; but you can attempt to use it to mark the corners of a
book set to 7 by 9.25 inches with the <code>@smallbook</code> command.
@@ -1066,6 +1082,7 @@
\mag=1200
@end tex
</pre></td></tr></table>
+
<p>With some printing technologies, you can print normal-sized copies that
look better than usual by giving a larger-than-normal master to your
print shop. They do the reduction, thus effectively increasing the
Index: texi2html/Tests/texinfo_res/texinfo_21.html
diff -u texi2html/Tests/texinfo_res/texinfo_21.html:1.25
texi2html/Tests/texinfo_res/texinfo_21.html:1.26
--- texi2html/Tests/texinfo_res/texinfo_21.html:1.25 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_21.html Sat Mar 25 13:26:47 2006
@@ -207,6 +207,7 @@
</p>
<table><tr><td> </td><td><pre class="example">makeinfo bison.texinfo
</pre></td></tr></table>
+
<p>(You can run a shell inside Emacs by typing <kbd>M-x shell</kbd>.)
</p>
<p>Sometimes you will want to specify options. For example, if you wish
@@ -215,6 +216,7 @@
</p>
<table><tr><td> </td><td><pre class="example">makeinfo --version
</pre></td></tr></table>
+
<p>See section <a href="#SEC264">Options for <code>makeinfo</code></a>, for
more information.
</p>
@@ -251,6 +253,7 @@
</p>
<table><tr><td> </td><td><pre class="example">makeinfo --fill-column=68
bison.texinfo
</pre></td></tr></table>
+
<p>You can write two or more options in sequence, like this:
</p>
<table><tr><td> </td><td><pre class="example">makeinfo --no-split
--fill-column=70 …
@@ -685,7 +688,6 @@
</p></dd>
</dl>
-
<p>(Note that the parallel commands for killing and recentering a TeX
job are <kbd>C-c C-t C-k</kbd> and <kbd>C-c C-t C-l</kbd>. See section <a
href="texinfo_20.html#SEC250">Formatting and Printing in Texinfo Mode</a>.)
</p>
@@ -1051,6 +1053,7 @@
@TeX{} or an Info file.
…
</pre></td></tr></table>
+
<p>Each of these menu entries points to the `Top' node of the Info file
that is named in parentheses. (The menu entry does not need to
specify the `Top' node, since Info goes to the `Top' node if no node
@@ -1179,6 +1182,7 @@
(cons (expand-file-name "/home/bob/info")
Info-directory-list))
</pre></td></tr></table>
+
<p>This tells Emacs to merge the system <tt>`dir'</tt> file with the
<tt>`dir'</tt>
file in <tt>`/home/bob/info'</tt>. Thus, Info will list the
<tt>`/home/bob/info/info-test'</tt> file as a menu entry in the
@@ -1207,6 +1211,7 @@
<table><tr><td> </td><td><pre class="smallexample">setenv INFOPATH
.:~/info:/usr/local/emacs/info
</pre></td></tr></table>
+
</li><li>
In a <tt>`.profile'</tt> file, you would achieve the same effect by
writing:
@@ -1214,13 +1219,14 @@
<table><tr><td> </td><td><pre
class="smallexample">INFOPATH=.:$HOME/info:/usr/local/emacs/info
export INFOPATH
</pre></td></tr></table>
+
</li><li>
<a name="IDX415"></a>
In a <tt>`autoexec.bat'</tt> file, you write this command<a name="DOCF12"
href="texinfo_fot.html#FOOT12">(12)</a>:
<table><tr><td> </td><td><pre class="smallexample">set
INFOPATH=.;%HOME%/info;c:/usr/local/emacs/info
-</pre></td></tr></table></li></ul>
-
+</pre></td></tr></table>
+</li></ul>
<p>The <samp>`.'</samp> indicates the current directory as usual. Emacs uses
the
<code>INFOPATH</code> environment variable to initialize the value of Emacs's
@@ -1294,6 +1300,7 @@
…
@end direntry
</pre></td></tr></table>
+
<p>Here's what this produces in the Info file:
</p>
<table><tr><td> </td><td><pre class="smallexample">INFO-DIR-SECTION
Texinfo documentation system
@@ -1326,6 +1333,7 @@
TeX
Individual utilities
</pre></td></tr></table>
+
<p>The idea is to include the `Invoking' node for every program installed
by a package under `Individual utilities', and an entry for the manual
as a whole in the appropriate other category.
@@ -1361,6 +1369,7 @@
</p>
<table><tr><td> </td><td><pre class="example">install-info
[<var>option</var>]… [<var>info-file</var> [<var>dir-file</var>]]
</pre></td></tr></table>
+
<p>If <var>info-file</var> or <var>dir-file</var> are not specified, the
options
(described below) that define them must be. There are no compile-time
defaults, and standard input is never used. <code>install-info</code> can
Index: texi2html/Tests/texinfo_res/texinfo_23.html
diff -u texi2html/Tests/texinfo_res/texinfo_23.html:1.23
texi2html/Tests/texinfo_res/texinfo_23.html:1.24
--- texi2html/Tests/texinfo_res/texinfo_23.html:1.23 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_23.html Sat Mar 25 13:26:47 2006
@@ -192,6 +192,7 @@
@noindent
On the other hand, …
</pre></td></tr></table>
+
<p>Insert blank lines before and after <code>@itemize</code> …
<code>@end
itemize</code> and <code>@enumerate</code> … <code>@end
enumerate</code> in the
same way.
@@ -285,7 +286,6 @@
version-controlled file corresponding to the current buffer.
</p></blockquote>
-
<p>In this case, the text should be formatted with
<code>@table</code>, <code>@item</code>, and <code>@itemx</code>, to create a
table.
</p>
@@ -299,6 +299,7 @@
<table><tr><td> </td><td><pre class="example">The main function is
@code{vc-next-action}, …
</pre></td></tr></table>
+
</li><li>
Avoid putting letters such as <samp>`s'</samp> immediately after an
<samp>address@hidden'</samp>. Such letters look bad.
@@ -397,6 +398,7 @@
dld_init (path)
char *path;
</pre></td></tr></table>
+
<p>Also, it is best to avoid writing <code>#include</code> above the
declaration just to indicate that the function is declared in a
header file. The practice may give the misimpression that the
Index: texi2html/Tests/texinfo_res/texinfo_24.html
diff -u texi2html/Tests/texinfo_res/texinfo_24.html:1.74
texi2html/Tests/texinfo_res/texinfo_24.html:1.75
--- texi2html/Tests/texinfo_res/texinfo_24.html:1.74 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_24.html Sat Mar 25 13:26:47 2006
@@ -183,6 +183,7 @@
@bye
</pre></td></tr></table>
+
<hr size="6">
<a name="GNU-Sample-Texts"></a>
<a name="SEC296"></a>
@@ -229,7 +230,8 @@
The <samp>`Id: texinfo.txi,v 1.2 2003/02/24 18:17:06 pertusus Exp $'</samp>
comment is for CVS (see <a href="../cvs/index.html#Top">(cvs)Top</a> section
`Overview' in <cite>Concurrent Versions System</cite>) or RCS (see rcsintro(1))
version control
systems, which expand it into a string such as:
<table><tr><td> </td><td><pre class="example">Id: texinfo.txi,v 1.2
2003/02/24 18:17:06 pertusus Exp $
-</pre></td></tr></table><p>(This is useful in all sources that use version
control, not just manuals.)
+</pre></td></tr></table>
+<p>(This is useful in all sources that use version control, not just manuals.)
</p>
</li><li>
<a name="IDX449"></a>
@@ -358,6 +360,7 @@
@bye
</pre></td></tr></table>
+
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#SEC294" title="Beginning of
this chapter or previous chapter"> << </a>]</td>
Index: texi2html/Tests/texinfo_res/texinfo_25.html
diff -u texi2html/Tests/texinfo_res/texinfo_25.html:1.26
texi2html/Tests/texinfo_res/texinfo_25.html:1.27
--- texi2html/Tests/texinfo_res/texinfo_25.html:1.26 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_25.html Sat Mar 25 13:26:47 2006
@@ -132,6 +132,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@include buffers.texi
</pre></td></tr></table>
+
<p>An included file should simply be a segment of text that you expect to
be included as is into the overall or <em>outer</em> Texinfo file; it
should not contain the standard beginning and end parts of a Texinfo
@@ -354,6 +355,7 @@
@bye
</pre></td></tr></table>
+
<p>An included file, such as <tt>`foo.texinfo'</tt>, might look like this:
</p>
<table><tr><td> </td><td><pre class="example">@node First, Second, , Top
@@ -361,6 +363,7 @@
Contents of first chapter …
</pre></td></tr></table>
+
<p>The full contents of <tt>`concept-index.texinfo'</tt> might be as simple as
this:
</p>
<table><tr><td> </td><td><pre class="example">@node Concept Index
@@ -368,6 +371,7 @@
@printindex cp
</pre></td></tr></table>
+
<p>The outer Texinfo source file for <cite>The GNU Emacs Lisp Reference
Manual</cite> is named <tt>`elisp.texi'</tt>. This outer file contains a
master
menu with 417 entries and a list of 41 <code>@include</code>
Index: texi2html/Tests/texinfo_res/texinfo_26.html
diff -u texi2html/Tests/texinfo_res/texinfo_26.html:1.26
texi2html/Tests/texinfo_res/texinfo_26.html:1.27
--- texi2html/Tests/texinfo_res/texinfo_26.html:1.26 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_26.html Sat Mar 25 13:26:47 2006
@@ -175,6 +175,7 @@
| |
</pre></td></tr></table>
+
<p>The standard format for two-sided printing depends on whether the page
number is even or odd. By convention, even-numbered pages are on the
left- and odd-numbered pages are on the right. (TeX will adjust the
@@ -261,7 +262,6 @@
</p></dd>
</dl>
-
<p>Texinfo lacks an <code>@setchapternewpage even</code> command.
</p>
<hr size="6">
@@ -401,7 +401,6 @@
</p></dd>
</dl>
-
<p>You can also use the <code>@today{}</code> command, which expands to the
current date, in `1 Jan 1900' format.
<a name="IDX461"></a>
@@ -414,6 +413,7 @@
@everyheading @emph{Draft!} @| @thispage @| @thischapter
@everyfooting @| @| Version: 0.27: @today{}
</pre></td></tr></table>
+
<p>Beware of overlong titles: they may overlap another part of the
header or footer and blot it out.
</p>
Index: texi2html/Tests/texinfo_res/texinfo_27.html
diff -u texi2html/Tests/texinfo_res/texinfo_27.html:1.26
texi2html/Tests/texinfo_res/texinfo_27.html:1.27
--- texi2html/Tests/texinfo_res/texinfo_27.html:1.26 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_27.html Sat Mar 25 13:26:47 2006
@@ -188,6 +188,7 @@
∗
---------- Buffer: *Info Region* ----------
</pre></td></tr></table>
+
<p>The <code>texinfo-format-region</code> command sometimes provides slightly
odd error messages. For example, the following cross reference fails to
format:
</p>
@@ -210,11 +211,13 @@
<p>Formatting produces:
</p><table><tr><td> </td><td><pre class="example">(*Note for more info.:
Catching Mistakes)
</pre></td></tr></table>
+
<p>The only way for you to detect this error is to realize that the
reference should have looked like this:
</p>
<table><tr><td> </td><td><pre class="example">(*Note Catching Mistakes::,
for more info.)
</pre></td></tr></table>
+
<p>Incidentally, if you are reading this node in Info and type <kbd>f
<kbd>RET</kbd></kbd> (<code>Info-follow-reference</code>), you will generate
an error
message that says:
@@ -287,6 +290,7 @@
?
---------- Buffer: *tex-shell* ----------
</pre></td></tr></table>
+
<p>In this case, TeX produced an accurate and
understandable error message:
</p>
@@ -416,6 +420,7 @@
4469: @subsection @code{@@node} Line Tips
…
</pre></td></tr></table>
+
<p>This says that lines 4337, 4393, and 4417 of <tt>`texinfo.texi'</tt> begin
with the <code>@section</code>, <code>@subheading</code>, and
<code>@subsection</code>
commands respectively. If you move your cursor into the <samp>`*Occur*'</samp>
@@ -701,6 +706,7 @@
M-x Info-tagify
M-x Info-validate
</pre></td></tr></table>
+
<p>After you have validated the node structure, you can rerun
<code>texinfo-format-buffer</code> in the normal way so it will construct a
tag table and split the file automatically, or you can make the tag
Index: texi2html/Tests/texinfo_res/texinfo_3.html
diff -u texi2html/Tests/texinfo_res/texinfo_3.html:1.27
texi2html/Tests/texinfo_res/texinfo_3.html:1.28
--- texi2html/Tests/texinfo_res/texinfo_3.html:1.27 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_3.html Sat Mar 25 13:26:47 2006
@@ -695,11 +695,13 @@
@comment node-name, next, previous, up
@section Comments
</pre></td></tr></table>
+
<p>or like this (without the <code>@comment</code> line):
</p>
<table><tr><td> </td><td><pre class="example">@node Comments, Minimum,
Conventions, Overview
@section Comments
</pre></td></tr></table>
+
<p>or like this (without the explicit node pointers):
</p>
<table><tr><td> </td><td><pre class="example">@node Comments
@@ -773,6 +775,7 @@
</p>
<table><tr><td> </td><td><pre class="example">C-x h C-u M-x
texinfo-insert-node-lines
</pre></td></tr></table>
+
<p>This command inserts titles as node names in <code>@node</code> lines; the
<code>texinfo-start-menu-description</code> command (see section <a
href="#SEC24">Inserting Frequently Used Commands</a>) inserts titles as
descriptions in
menu entries, a different action. However, in both cases, you need to
@@ -884,6 +887,7 @@
or
M-x makeinfo-buffer
</pre></td></tr></table>
+
<p>For TeX or the Info formatting commands to work, the file <em>must</em>
include a line that has <code>@setfilename</code> in its header.
</p>
@@ -1018,6 +1022,7 @@
in the space for the description
in a menu entry line.
</pre></td></tr></table>
+
<a name="SEC34"></a>
<h3 class="subheading"> Show Structure </h3>
@@ -1026,6 +1031,7 @@
</p>
<table><tr><td> </td><td><pre class="example">C-c C-s List all
the headings.
</pre></td></tr></table>
+
<a name="SEC35"></a>
<h3 class="subheading"> The Master Update Command </h3>
@@ -1040,6 +1046,7 @@
create or update all nodes and regular
menus, and then create a master menu.
</pre></td></tr></table>
+
<a name="SEC36"></a>
<h3 class="subheading"> Update Pointers </h3>
@@ -1050,6 +1057,7 @@
<table><tr><td> </td><td><pre class="example">C-c C-u C-n Update a
node.
C-c C-u C-e Update every node in the buffer.
</pre></td></tr></table>
+
<a name="SEC37"></a>
<h3 class="subheading"> Update Menus </h3>
@@ -1068,6 +1076,7 @@
first create or update all nodes and
then create or update all menus.
</pre></td></tr></table>
+
<a name="SEC38"></a>
<h3 class="subheading"> Format for Info </h3>
@@ -1079,7 +1088,6 @@
<code>makeinfo</code> program are invoked by typing <kbd>C-c C-m</kbd> and then
either <kbd>C-r</kbd> for a region or <kbd>C-b</kbd> for the whole buffer.
</p>
-
<p>Use the <code>texinfo-format…</code> commands:
</p>
<table><tr><td> </td><td><pre class="example">C-c C-e C-r Format the
region.
@@ -1093,6 +1101,7 @@
C-c C-m C-l Recenter the <code>makeinfo</code> output buffer.
C-c C-m C-k Kill the <code>makeinfo</code> formatting job.
</pre></td></tr></table>
+
<a name="SEC39"></a>
<h3 class="subheading"> Typeset and Print </h3>
@@ -1111,6 +1120,7 @@
C-c C-t C-x Quit a currently stopped TeX formatting job.
C-c C-t C-l Recenter the output buffer.
</pre></td></tr></table>
+
<a name="SEC40"></a>
<h3 class="subheading"> Other Updating Commands </h3>
@@ -1135,6 +1145,7 @@
Insert node pointers in strict sequence.
</pre></td></tr></table>
+
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#SEC21" title="Beginning of
this chapter or previous chapter"> << </a>]</td>
Index: texi2html/Tests/texinfo_res/texinfo_30.html
diff -u texi2html/Tests/texinfo_res/texinfo_30.html:1.16
texi2html/Tests/texinfo_res/texinfo_30.html:1.17
--- texi2html/Tests/texinfo_res/texinfo_30.html:1.16 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_30.html Sat Mar 25 13:26:47 2006
@@ -88,6 +88,7 @@
</p><table><tr><td> </td><td><pre class="example"><a
href="ftp://tug.org/tex/unixtex.ftp">ftp://tug.org/tex/unixtex.ftp</a>
<a href="http://tug.org/unixtex.ftp">http://tug.org/unixtex.ftp</a>
</pre></td></tr></table>
+
<p>The Free Software Foundation provides a core distribution on its Source
Code CD-ROM suitable for printing Texinfo manuals. To order it, contact:
</p>
@@ -102,6 +103,7 @@
0066-3382-0158 (IDC)
Electronic mail: <code>address@hidden</code>
</pre></td></tr></table>
+
<p>Many other TeX distributions are available; see
<a href="http://tug.org/">http://tug.org/</a>.
</p>
Index: texi2html/Tests/texinfo_res/texinfo_31.html
diff -u texi2html/Tests/texinfo_res/texinfo_31.html:1.21
texi2html/Tests/texinfo_res/texinfo_31.html:1.22
--- texi2html/Tests/texinfo_res/texinfo_31.html:1.21 Mon Nov 14 11:14:00 2005
+++ texi2html/Tests/texinfo_res/texinfo_31.html Sat Mar 25 13:26:47 2006
@@ -115,6 +115,7 @@
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
</pre></td></tr></table>
+
<ol>
<li>
PREAMBLE
@@ -503,6 +504,7 @@
A copy of the license is included in the section entitled ``GNU
Free Documentation License''.
</pre></td></tr></table>
+
<p>If you have no Invariant Sections, write “with no Invariant
Sections”
instead of saying which ones are invariant. If you have no
Front-Cover Texts, write “no Front-Cover Texts” instead of
Index: texi2html/Tests/texinfo_res/texinfo_4.html
diff -u texi2html/Tests/texinfo_res/texinfo_4.html:1.25
texi2html/Tests/texinfo_res/texinfo_4.html:1.26
--- texi2html/Tests/texinfo_res/texinfo_4.html:1.25 Mon Nov 14 11:14:01 2005
+++ texi2html/Tests/texinfo_res/texinfo_4.html Sat Mar 25 13:26:47 2006
@@ -190,6 +190,7 @@
…
</pre></td></tr></table>
+
<hr size="6">
<a name="Texinfo-File-Header"></a>
<a name="SEC43"></a>
@@ -233,6 +234,7 @@
@settitle Sample Manual 1.0
@c %**end of header
</pre></td></tr></table>
+
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top"><a href="#SEC44">3.2.1 The First Line of a
Texinfo File</a></td><td> </td><td align="left" valign="top">
The first line of a Texinfo file.
</td></tr>
@@ -319,6 +321,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@c %**start of header
</pre></td></tr></table>
+
<p>Write the start-of-header line on the second line of a Texinfo file.
Follow the start-of-header line with <code>@setfilename</code> and
<code>@settitle</code> lines and, optionally, with other commands that
@@ -360,6 +363,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@setfilename
<var>info-file-name</var>
</pre></td></tr></table>
+
<p>Write the <code>@setfilename</code> command at the beginning of a line and
follow it on the same line by the Info file name. Do not write anything
else on the line; anything on the line after the command is considered
@@ -434,6 +438,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@settitle <var>title</var>
</pre></td></tr></table>
+
<p>Write the <code>@settitle</code> command at the beginning of a line and
follow it on the same line by the title. This tells TeX the title to
use in a header or footer. Do not write anything else on the line;
@@ -503,6 +508,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@c %**end of header
</pre></td></tr></table>
+
<p>See section <a href="#SEC45">Start of Header</a>.
</p>
@@ -579,6 +585,7 @@
@end quotation
@end copying
</pre></td></tr></table>
+
<p>The <code>@quotation</code> has no legal significance; it's there to improve
readability in some contexts.
</p>
@@ -599,6 +606,7 @@
</p>
<table><tr><td> </td><td><pre class="example">Copyright ©
<var>years</var> <var>copyright-owner</var>.
</pre></td></tr></table>
+
<a name="IDX74"></a>
<p>The word `Copyright' must always be written in English, even if the
manual is otherwise in another language. This is due to international
@@ -645,6 +653,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@insertcopying
</pre></td></tr></table>
+
<p>It inserts the text previously defined by <code>@copying</code>. Legally,
it
must be used on the copyright page in the printed manual
(see section <a href="#SEC56">Copyright Page</a>).
@@ -838,6 +847,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@titlefont{Texinfo}
</pre></td></tr></table>
+
<p>Use the <code>@center</code> command at the beginning of a line to center
the remaining text on that line. Thus,
</p>
@@ -867,6 +877,7 @@
…
@end titlepage
</pre></td></tr></table>
+
<p>The spacing of the example fits an 8.5 by 11 inch manual.
</p>
@@ -946,6 +957,7 @@
…
@end titlepage
</pre></td></tr></table>
+
<p>You may also combine the <code>@titlefont</code> method described in the
previous section and <code>@title</code> method described in this one. This
may be useful if you have a very long title. Here is a real-life example:
@@ -1011,6 +1023,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@insertcopying
</pre></td></tr></table>
+
<p>Follow the copying text by the publisher, ISBN numbers, cover art
credits, and other such information.
</p>
@@ -1028,6 +1041,7 @@
@end titlepage
</pre></td></tr></table>
+
<hr size="6">
<a name="end-titlepage"></a>
<a name="SEC57"></a>
@@ -1256,6 +1270,7 @@
@end menu
</pre></td></tr></table>
+
<hr size="6">
<a name="Master-Menu-Parts"></a>
<a name="SEC61"></a>
@@ -1335,6 +1350,7 @@
@end menu
</pre></td></tr></table>
+
<hr size="6">
<a name="Global-Document-Commands"></a>
<a name="SEC62"></a>
@@ -1409,6 +1425,7 @@
</p>
<table><tr><td> </td><td><pre class="example"><meta name=description
content="descriptive text.">
</pre></td></tr></table>
+
<p><code>@documentdescription</code> must be specified before the first node of
the document.
</p>
@@ -1454,6 +1471,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@setchapternewpage odd
</pre></td></tr></table>
+
<p>You can specify one of three alternatives with the
<code>@setchapternewpage</code> command:
</p>
@@ -1530,6 +1548,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@paragraphindent
<var>indent</var>
</pre></td></tr></table>
+
<p>The indentation is according to the value of <var>indent</var>:
</p>
<dl compact="compact">
@@ -1590,6 +1609,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@exampleindent
<var>indent</var>
</pre></td></tr></table>
+
<p>The indentation is according to the value of <var>indent</var>:
</p>
<dl compact="compact">
Index: texi2html/Tests/texinfo_res/texinfo_5.html
diff -u texi2html/Tests/texinfo_res/texinfo_5.html:1.21
texi2html/Tests/texinfo_res/texinfo_5.html:1.22
--- texi2html/Tests/texinfo_res/texinfo_5.html:1.21 Mon Nov 14 11:14:01 2005
+++ texi2html/Tests/texinfo_res/texinfo_5.html Sat Mar 25 13:26:48 2006
@@ -96,6 +96,7 @@
@bye
</pre></td></tr></table>
+
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top"><a href="#SEC69">4.1 Printing Indices and
Menus</a></td><td> </td><td align="left" valign="top"> How to
print an index in hardcopy and
generate index menus in Info.
@@ -294,6 +295,7 @@
</p><table><tr><td> </td><td><pre class="example">texi2dvi address@hidden
foo.texi
</pre></td></tr></table>
+
<hr size="6">
<a name="File-End"></a>
<a name="SEC71"></a>
Index: texi2html/Tests/texinfo_res/texinfo_6.html
diff -u texi2html/Tests/texinfo_res/texinfo_6.html:1.24
texi2html/Tests/texinfo_res/texinfo_6.html:1.25
--- texi2html/Tests/texinfo_res/texinfo_6.html:1.24 Mon Nov 14 11:14:01 2005
+++ texi2html/Tests/texinfo_res/texinfo_6.html Sat Mar 25 13:26:48 2006
@@ -167,12 +167,14 @@
1.1 1.2 2.1 2.2 3.1 3.2
</pre></td></tr></table>
+
<p>In a Texinfo file that has this structure, the beginning of Chapter 2
looks like this:
</p>
<table><tr><td> </td><td><pre class="example">@node Chapter 2,
Chapter 3, Chapter 1, top
@chapter Chapter 2
</pre></td></tr></table>
+
<p>The chapter structuring commands are described in the sections that
follow; the <code>@node</code> and <code>@menu</code> commands are described in
following chapters. (See section <a href="texinfo_7.html#SEC85">Nodes</a>, and
see <a href="texinfo_8.html#SEC97">Menus</a>.)
@@ -328,6 +330,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@chapter Chapter Structuring
</pre></td></tr></table>
+
<p>In TeX, the <code>@chapter</code> command creates a chapter in the
document, specifying the chapter title. The chapter is numbered
automatically.
@@ -339,6 +342,7 @@
<table><tr><td> </td><td><pre class="example">Chapter Structuring
*******************
</pre></td></tr></table>
+
<a name="IDX91"></a>
<p>Texinfo also provides a command <code>@centerchap</code>, which is analogous
to <code>@unnumbered</code>, but centers its argument in the printed output.
@@ -450,6 +454,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@section @code{@@section}
</pre></td></tr></table>
+
<p>To create a section, write the <code>@section</code> command at the
beginning of a line and follow it on the same line by the section
title.
@@ -549,6 +554,7 @@
<table><tr><td> </td><td><pre class="example">This is a subsection
--------------------
</pre></td></tr></table>
+
<p>In a printed manual, subsections are listed in the table of contents
and are numbered three levels deep.
</p>
@@ -653,6 +659,7 @@
<table><tr><td> </td><td><pre class="example">This is a subsubsection
.......................
</pre></td></tr></table>
+
<hr size="6">
<a name="Raise_002flower-sections"></a>
<a name="SEC84"></a>
@@ -699,6 +706,7 @@
@heading @chapheading,
etc.
</pre></td></tr></table>
+
<p><code>@lowersections</code> lowers a command one level in the chapter
structuring hierarchy:
</p>
@@ -709,6 +717,7 @@
@heading @subheading,
etc.
</pre></td></tr></table>
+
<p>An <code>@raisesections</code> or <code>@lowersections</code> command
changes only
those structuring commands that follow the command in the Texinfo file.
Write an <code>@raisesections</code> or <code>@lowersections</code> command on
a
@@ -721,6 +730,7 @@
@include somefile.texi
@raisesections
</pre></td></tr></table>
+
<p>Without the <code>@raisesections</code>, all the subsequent sections in your
document will be lowered.
</p>
Index: texi2html/Tests/texinfo_res/texinfo_7.html
diff -u texi2html/Tests/texinfo_res/texinfo_7.html:1.25
texi2html/Tests/texinfo_res/texinfo_7.html:1.26
--- texi2html/Tests/texinfo_res/texinfo_7.html:1.25 Mon Nov 14 11:14:01 2005
+++ texi2html/Tests/texinfo_res/texinfo_7.html Sat Mar 25 13:26:48 2006
@@ -194,6 +194,7 @@
Section Section Section Section Section Section
1.1 1.2 2.1 2.2 3.1 3.2
</pre></td></tr></table>
+
<p>The fully-written command to start Chapter 2 would be this:
</p>
<table><tr><td> </td><td><pre class="example">@node Chapter 2,
Chapter 3, Chapter 1, Top
@@ -227,11 +228,13 @@
* Sect. 2.2::
@end menu
</pre></td></tr></table>
+
<p>Write the node for Sect. 2.1 like this:
</p>
<table><tr><td> </td><td><pre class="example"> @node Sect. 2.1,
Sect. 2.2, Chapter 2, Chapter 2
@comment node-name, next, previous, up
</pre></td></tr></table>
+
<p>In Info format, the `Next' and `Previous' pointers of a node usually
lead to other nodes at the same level—from chapter to chapter or from
section to section (sometimes, as shown, the `Previous' pointer points
@@ -257,6 +260,7 @@
@cindex File ending
</pre></td></tr></table>
+
<hr size="6">
<a name="node"></a>
<a name="SEC88"></a>
@@ -411,6 +415,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@node <var>node-name</var>
</pre></td></tr></table>
+
<p>If you are using GNU Emacs, you can use the update node commands
provided by Texinfo mode to insert the names of the pointers; or you
can leave the pointers out of the Texinfo file and let <code>makeinfo</code>
@@ -429,6 +434,7 @@
</p>
<table><tr><td> </td><td><pre class="example">@node <var>node-name</var>,
<var>next</var>, <var>previous</var>, <var>up</var>
</pre></td></tr></table>
+
<p>If you wish, you can ignore <code>@node</code> lines altogether in your
first
draft and then use the <code>texinfo-insert-node-lines</code> command to
create <code>@node</code> lines for you. However, we do not recommend this
@@ -548,6 +554,7 @@
@section @code{@@chapter}
@findex chapter
</pre></td></tr></table>
+
</li><li>
<a name="IDX98"></a>
You cannot use parentheses in node names, because a node name such as
@@ -573,6 +580,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">unnumberedsec
appendixsec heading
</pre></td></tr></table>
+
<a name="IDX105"></a>
</li><li>
Case is significant.
@@ -646,6 +654,7 @@
<table><tr><td> </td><td><pre class="example">@node Top
</pre></td></tr></table>
+
<hr size="6">
<a name="makeinfo-top-command"></a>
<a name="SEC94"></a>
@@ -694,6 +703,7 @@
@top Your Manual Title
</pre></td></tr></table>
+
<hr size="6">
<a name="makeinfo-Pointer-Creation"></a>
<a name="SEC95"></a>
@@ -774,12 +784,14 @@
…
@xref{x-spot,,the spot}.
</pre></td></tr></table>
+
<p>produces:
</p>
<table><tr><td> </td><td><pre class="example">This marks the spot.
…
See [the spot], page 1.
</pre></td></tr></table>
+
<p>As you can see, the <code>@anchor</code> command itself produces no output.
This example defines an anchor `x-spot' just before the word `spot'.
You can refer to it later with an <code>@xref</code> or other cross-reference
Index: texi2html/Tests/texinfo_res/texinfo_8.html
diff -u texi2html/Tests/texinfo_res/texinfo_8.html:1.24
texi2html/Tests/texinfo_res/texinfo_8.html:1.25
--- texi2html/Tests/texinfo_res/texinfo_8.html:1.24 Mon Nov 14 11:14:01 2005
+++ texi2html/Tests/texinfo_res/texinfo_8.html Sat Mar 25 13:26:48 2006
@@ -137,6 +137,7 @@
@heading Menus Need Short Nodes
@end ifinfo
</pre></td></tr></table>
+
<p>The Texinfo file for this document contains a number of
examples of this procedure; one is at the beginning of this chapter.
</p>
@@ -177,6 +178,7 @@
several files at once.
@end menu
</pre></td></tr></table>
+
<p>In a menu, every line that begins with an <samp>`* '</samp> is a <em>menu
entry</em>. (Note the space after the asterisk.) A line that does not
start with an <samp>`* '</samp> may also appear in a menu. Such a line is
@@ -226,6 +228,7 @@
</p>
<table><tr><td> </td><td><pre class="example">*
<var>menu-entry-name</var>: <var>node-name</var>. <var>description</var>
</pre></td></tr></table>
+
<p>Follow the menu entry name with a single colon and follow the node name
with tab, comma, period, or newline.
</p>
@@ -276,6 +279,7 @@
</p>
<table><tr><td> </td><td><pre class="example">* Name: Name.
<var>description</var>
</pre></td></tr></table>
+
<p>You should use the node name for the menu entry name whenever possible,
since it reduces visual clutter in the menu.
</p>
@@ -315,6 +319,7 @@
* menu entry name: Node name. A short description.
* Node name:: This form is preferred.
</pre></td></tr></table>
+
<p>Here is an example as you might see it in a Texinfo file:
</p>
<table><tr><td> </td><td><pre class="example">@menu
@@ -335,6 +340,7 @@
* Multiples: Buffers. Multiple buffers; editing
several files at once.
</pre></td></tr></table>
+
<p>In this example, the menu has two entries. <samp>`Files'</samp> is both a
menu
entry name and the name of the node referred to by that name.
<samp>`Multiples'</samp> is the menu entry name; it refers to the node named
@@ -379,6 +385,7 @@
* <var>second-entry-name</var>:(<var>filename</var>)<var>second-node</var>.
<var>description</var>
@end menu
</pre></td></tr></table>
+
<p>For example, to refer directly to the <samp>`Outlining'</samp> and
<samp>`Rebinding'</samp> nodes in the <cite>Emacs Manual</cite>, you would
write a
menu like this:
@@ -390,6 +397,7 @@
meaning of a key.
@end menu
</pre></td></tr></table>
+
<p>If you do not list the node name, but only name the file, then Info
presumes that you are referring to the `Top' node.
</p>
Index: texi2html/Tests/texinfo_res/texinfo_9.html
diff -u texi2html/Tests/texinfo_res/texinfo_9.html:1.27
texi2html/Tests/texinfo_res/texinfo_9.html:1.28
--- texi2html/Tests/texinfo_res/texinfo_9.html:1.27 Mon Nov 14 11:14:01 2005
+++ texi2html/Tests/texinfo_res/texinfo_9.html Sat Mar 25 13:26:48 2006
@@ -187,7 +187,6 @@
</p></dd>
</dl>
-
<p>(The <code>@cite</code> command is used to make references to books and
manuals for which there is no corresponding Info file and, therefore,
no node to which to point. See section <a
href="texinfo_10.html#SEC133"><code>@cite</code></a>.)
@@ -253,7 +252,6 @@
<blockquote><p>See section “Particular Topic” in <i>A Printed
Manual</i>, for details.
</p></blockquote>
-
<p>in a printed book.
</p>
<p>The five possible arguments for a cross reference are:
@@ -291,6 +289,7 @@
<table><tr><td> </td><td><pre class="example">@xref{<var>node-name</var>,
<var>cross-reference-name</var>, <var>title-or-topic</var>,
<var>info-file-name</var>, <var>printed-manual-title</var>}.
</pre></td></tr></table>
+
<p>Cross references with one, two, three, four, and five arguments are
described separately following the description of <code>@xref</code>.
</p>
@@ -363,7 +362,6 @@
<blockquote><p>See Section <var>section-number</var> [<var>node-name</var>],
page <var>page</var>.
</p></blockquote>
-
<p>or like this
</p>
<blockquote><p>See Section <var>section-number</var>
[<var>title-or-topic</var>], page <var>page</var>.
@@ -422,7 +420,6 @@
output that the Info readers can use to jump to the reference; TeX
produces output that specifies the page and section number for you.
</p>
-
<p>For example,
</p>
<table><tr><td> </td><td><pre class="example">@xref{Tropical Storms}.
@@ -438,7 +435,6 @@
<blockquote><p>See Section 3.1 [Tropical Storms], page 24.
</p></blockquote>
-
<p>(Note that in the preceding example the closing brace is followed by a
period.)
</p>
@@ -457,7 +453,6 @@
<blockquote><p>See Section 3.1 [Tropical Storms], page 24, for more info.
</p></blockquote>
-
<p>(Note that in the preceding example the closing brace is followed by a
comma, and then by the clause, which is followed by a period.)
</p>
@@ -486,7 +481,6 @@
reference, while the first is still the name of the node to which the
cross reference points.
</p>
-
<p>The template is like this:
</p>
<table><tr><td> </td><td><pre class="example">@xref{<var>node-name</var>,
<var>cross-reference-name</var>}.
@@ -507,7 +501,6 @@
<blockquote><p>See Section 5.2 [Electrical Effects], page 57.
</p></blockquote>
-
<p>(Note that in the preceding example the closing brace is followed by a
period; and that the node name is printed, not the cross reference name.)
</p>
@@ -525,7 +518,6 @@
<blockquote><p>See Section 5.2 [Electrical Effects], page 57, for more info.
</p></blockquote>
-
<p>(Note that in the preceding example the closing brace is followed by a
comma, and then by the clause, which is followed by a period.)
</p>
@@ -569,7 +561,6 @@
examples, a clause follows a terminating comma.
</p>
-
<p>The template is like this:
</p>
<table><tr><td> </td><td><pre class="example">@xref{<var>node-name</var>,
<var>cross-reference-name</var>, <var>title-or-topic</var>}.
@@ -623,6 +614,7 @@
for more information.
@xref{Regexp, , Regular Expressions as Patterns}.
</pre></td></tr></table>
+
<hr size="6">
<a name="Four-and-Five-Arguments"></a>
<a name="SEC113"></a>
@@ -652,7 +644,6 @@
<code>@xref</code> command to terminate the cross reference. In the
following examples, a clause follows a terminating comma.
</p>
-
<p>The template is:
</p>
<table><tr><td> </td><td><pre class="example">@xref{<var>node-name</var>,
<var>cross-reference-name</var>, <var>title-or-topic</var>,
@@ -673,14 +664,12 @@
<p>The name of the Info file is enclosed in parentheses and precedes
the name of the node.
</p>
-
<p>In a printed manual, the reference looks like this:
</p>
<blockquote><p>See section “Thunder and Lightning” in <i>An
Introduction to
Meteorology</i>, for details.
</p></blockquote>
-
<p>The title of the printed manual is typeset in italics; and the
reference lacks a page number since TeX cannot know to which page a
reference refers when that reference is to another manual.
@@ -689,7 +678,6 @@
version of <code>@xref</code>. In this case, the third argument, the topic
description, will be used as the cross reference name in Info.
</p>
-
<p>The template looks like this:
</p>
<table><tr><td> </td><td><pre class="example">@xref{<var>node-name</var>,
, <var>title-or-topic</var>, <var>info-file-name</var>,
@@ -706,7 +694,6 @@
<blockquote><p>See section <var>title-or-topic</var> in
<var>printed-manual-title</var>, for details.
</p></blockquote>
-
<p>For example,
</p>
<table><tr><td> </td><td><pre class="example">@xref{Electrical Effects, ,
Thunder and Lightning,
@@ -761,7 +748,6 @@
entry for the third argument to the <code>@xref</code> command.
</p>
-
<p>Thus, to make a cross reference to <cite>The GNU Make Manual</cite>,
write:
</p>
@@ -778,7 +764,6 @@
<blockquote><p>See section “Overview” in <i>The GNU Make
Manual</i>.
</p></blockquote>
-
<p>In this example, <samp>`Top'</samp> is the name of the first node, and
<samp>`Overview'</samp> is the name of the first section of the manual.
</p><hr size="6">
@@ -806,7 +791,6 @@
not generate a `See' in the printed output, just the reference itself.
This makes it useful as the last part of a sentence.
</p>
-
<p>For example,
</p>
<a name="IDX111"></a>
@@ -828,7 +812,6 @@
in the Info format. Bear in mind that your audience will be using
both the printed and the Info format.
</p>
-
<p>For example,
</p>
<a name="IDX112"></a>
@@ -840,11 +823,11 @@
<blockquote><p>Sea surges are described in Section 6.7 [Hurricanes], page 72.
</p></blockquote>
-
<p>in a printed document, and the following in Info:
</p>
<table><tr><td> </td><td><pre class="example">Sea surges are described in
*Note Hurricanes::.
</pre></td></tr></table>
+
<blockquote><p><strong>Caution:</strong> You <em>must</em> write a period,
comma, or right
parenthesis immediately after an <code>@ref</code> command with two or more
arguments. Otherwise, Info will not find the end of the cross reference
@@ -906,7 +889,6 @@
the need to use complicated methods to put a terminator into one form
of the output and not the other.
</p>
-
<p>With one argument, a parenthetical cross reference looks like
this:
</p>
@@ -993,12 +975,10 @@
The Info file name.
</li></ol>
-
<p>Separate the arguments with commas, as with <code>@xref</code>. Also, you
must terminate the reference with a comma or period after the
<samp>`}'</samp>, as you do with <code>@xref</code>.
</p>
-
<p>The template is:
</p>
<table><tr><td> </td><td><pre
class="example">@inforef{<var>node-name</var>, <var>cross-reference-name</var>,
<var>info-file-name</var>},
@@ -1021,7 +1001,6 @@
<blockquote><p>See Info file <tt>`info'</tt>, node <samp>`Expert'</samp>, for
more information.
</p></blockquote>
-
<p>Similarly,
</p>
<table><tr><td> </td><td><pre class="example">@inforef{Expert, , info},
for more information.
@@ -1082,36 +1061,45 @@
</p>
<table><tr><td> </td><td><pre class="example">The official GNU ftp site
is @uref{ftp://ftp.gnu.org/gnu}.
</pre></td></tr></table>
+
<p>produces:
</p><table><tr><td> </td><td><pre class="display">The official GNU ftp
site is <a href="ftp://ftp.gnu.org/gnu">ftp://ftp.gnu.org/gnu</a>.
</pre></td></tr></table>
+
<p>An example of the two-argument form:
</p><table><tr><td> </td><td><pre class="example">The official
@uref{ftp://ftp.gnu.org/gnu, GNU ftp site}
holds programs and texts.
</pre></td></tr></table>
+
<p>produces:
</p><table><tr><td> </td><td><pre class="display">The official <a
href="ftp://ftp.gnu.org/gnu">GNU ftp site</a>
holds programs and texts.
</pre></td></tr></table>
+
<p>that is, the Info output is this:
</p><table><tr><td> </td><td><pre class="example">The official GNU ftp
site (ftp://ftp.gnu.org/gnu)
holds programs and texts.
</pre></td></tr></table>
+
<p>and the HTML output is this:
</p><table><tr><td> </td><td><pre class="example">The official <a
href="ftp://ftp.gnu.org/gnu">GNU ftp site</a>
holds programs and texts.
</pre></td></tr></table>
+
<p>An example of the three-argument form:
</p><table><tr><td> </td><td><pre class="example">The
@uref{/man.cgi/1/ls,,ls(1)} program …
</pre></td></tr></table>
+
<p>produces:
</p><table><tr><td> </td><td><pre class="display">The <a
href="/man.cgi/1/ls">ls(1)</a> program …
</pre></td></tr></table>
+
<p>but with HTML:
</p><table><tr><td> </td><td><pre class="example">The <a
href="/man.cgi/1/ls">ls(1)</a> program …
</pre></td></tr></table>
+
<p>To merely indicate a url without creating a link people can follow, use
<code>@url</code> (see section <a
href="texinfo_10.html#SEC135"><code>@url</code></a>).
</p>
Index: texi2html/Tests/viper_monolithic_res/viper.html
diff -u texi2html/Tests/viper_monolithic_res/viper.html:1.32
texi2html/Tests/viper_monolithic_res/viper.html:1.33
--- texi2html/Tests/viper_monolithic_res/viper.html:1.32 Tue Aug 23
23:51:16 2005
+++ texi2html/Tests/viper_monolithic_res/viper.html Sat Mar 25 13:26:48 2006
@@ -59,7 +59,6 @@
</tr></table>
<h1 class="unnumbered"> Distribution </h1>
-
<p>Copyright © 1995, 1996, 1997, 2001, 2002 Free Software Foundation, Inc.
</p>
<p>Permission is granted to copy, distribute and/or modify this document
@@ -108,6 +107,7 @@
it is a VI Plan for Emacs Rescue
and/or a venomous VI PERil.
</pre></td></tr></table>
+
<p>Technically speaking, Viper is a Vi emulation package for Emacs. It
implements all Vi and Ex commands, occasionally improving on them and
adding many new features. It gives the user the best of both worlds: Vi
@@ -410,6 +410,7 @@
</p>
<table><tr><td> </td><td><pre class="lisp">M-x viper-mode
</pre></td></tr></table>
+
<p>When Emacs first comes up, if you have not specified a file on the
command line, it will show the <samp>`*scratch*'</samp> buffer, in the
<samp>`Lisp Interaction'</samp> mode. After you invoke Viper, you can start
@@ -674,7 +675,6 @@
Or you can use the MULE menu in the menubar.
</p></dd>
</dl>
-
<p>Other differences are mostly improvements. The ones you should know
about are:
</p>
@@ -767,7 +767,6 @@
</p></dd>
</dl>
-
<p>As Vi, Viper's destructive commands can be re-executed by typing
`<kbd>.</kbd>'.
However, in addition, Viper keeps track of the history of such commands. This
history can be perused by typing <kbd>C-c M-p</kbd> and <kbd>C-c M-n</kbd>.
@@ -1060,7 +1059,6 @@
</p></dd>
</dl>
-
<p>Currently undisplayed files can be listed using the <kbd>:ar</kbd> command.
The
command <kbd>:n</kbd> can be given counts from the <kbd>:ar</kbd> list to
switch to
other files. For example, use `:n3' to move to the third file in that list.
@@ -1203,7 +1201,6 @@
<a name="IDX42"></a>
<a name="IDX43"></a>
-
<p>If a point command is given as an argument to a modifying command, the
region determined by the point command will be affected by the modifying
command. On the other hand, if a line command is given as an argument to a
@@ -1499,8 +1496,8 @@
variable that controls how search patterns are highlighted is
<code>viper-search-face</code>. If you don't want any highlighting at all, put
</p><table><tr><td> </td><td><pre class="example">(copy-face 'default
'viper-search-face)
-</pre></td></tr></table><a name="IDX56"></a>
-
+</pre></td></tr></table>
+<a name="IDX56"></a>
<p>in <tt>`~/.viper'</tt>. If you want to change how patterns are
highlighted, you
will have to change <code>viper-search-face</code> to your liking. The easiest
way to do this is to use Emacs customization widget, which is accessible
@@ -1624,6 +1621,7 @@
</p>
<table><tr><td> </td><td><pre
class="example">(viper-set-syntax-preference nil "emacs")
</pre></td></tr></table>
+
<a name="IDX60"></a>
<p>The above discussion of the meaning of Viper's words concerns only Viper's
@@ -1967,7 +1965,6 @@
</p></dd>
</dl>
-
<p>Emacs Lisp archives exist on
<samp>`archive.cis.ohio-state.edu'</samp>
and <samp>`wuarchive.wustl.edu'</samp>
@@ -2337,7 +2334,8 @@
usually most effective:
</p><table><tr><td> </td><td><pre class="example">(set-face-foreground
viper-replace-overlay-face "DarkSlateBlue")
(set-face-background viper-replace-overlay-face "yellow")
-</pre></td></tr></table><p>For a complete list of colors available to you,
evaluate the expression
+</pre></td></tr></table>
+<p>For a complete list of colors available to you, evaluate the expression
<code>(x-defined-colors)</code>. (Type it in the buffer
<code>*scratch*</code> and then
hit the <kbd>C-j</kbd> key.
</p>
@@ -2420,12 +2418,12 @@
the last chance to do customization before Viper is up and running.
</p></dd>
</dl>
-
<p>You can reset some of these constants in Viper with the Ex command
<kbd>:set</kbd>
(when so indicated in the table). Or you
can include a line like this in your <tt>`.viper'</tt> file:
</p><table><tr><td> </td><td><pre class="example">(setq
viper-case-fold-search t)
-</pre></td></tr></table><a name="IDX136"></a>
+</pre></td></tr></table>
+<a name="IDX136"></a>
<a name="IDX137"></a>
<a name="IDX138"></a>
<a name="IDX139"></a>
@@ -2518,6 +2516,7 @@
(define-key function-key-map "\e[192z" [f11]) ; L1
(define-key function-key-map "\e[195z" [f14]) ; L4, Undo
</pre></td></tr></table>
+
<p>The above illustrates how to do this for Xterm. On VT100, you would have to
replace "xterm" with "vt100" and also change the key
sequences (the same
key may emit different sequences on different types of terminals).
@@ -2543,7 +2542,6 @@
The keymap <code>viper-insert-global-user-map</code> also affects Viper's
Replace
state.
</p>
-
<p>If you want to
bind a key, say <kbd>C-v</kbd>, to the function that scrolls
page down and to make <kbd>0</kbd> display information on the current buffer,
@@ -2596,6 +2594,7 @@
(define-key my-dired-modifier-map "u" 'dired-unmark)
(viper-modify-major-mode 'dired-mode 'vi-state my-dired-modifier-map)
</pre></td></tr></table>
+
<p>A Vi purist may want to modify Emacs state under Dired mode so that
<kbd>k</kbd>, <kbd>l</kbd>, etc., will move around in directory buffers, as in
Vi. Although this is not recommended, as these keys are bound to useful
@@ -2606,6 +2605,7 @@
(define-key my-dired-vi-purist-map "l" 'viper-forward-char)
(viper-modify-major-mode 'dired-mode 'emacs-state my-dired-vi-purist-map)
</pre></td></tr></table>
+
<p>Yet another way to customize key bindings in a major mode is to edit the
list <code>viper-major-mode-modifier-list</code> using the customization
widget.
<a name="IDX178"></a>
@@ -2669,6 +2669,7 @@
(viper-add-local-keys 'vi-state '(("ZZ" . mh-send-letter))))
(add-hook 'mh-letter-mode-hook 'mh-add-vi-keys)
</pre></td></tr></table>
+
<p>You can also use <code>viper-add-local-keys</code> to set per buffer
bindings in Insert state and Emacs state by passing as a parameter the
symbols <code>insert-state</code> and <code>emacs-state</code>, respectively.
@@ -2883,7 +2884,8 @@
<tt>`~/.viper'</tt> file. For instance, if you don't like the above feature,
put
this in <tt>`~/.viper'</tt>:
</p><table><tr><td> </td><td><pre
class="example">(viper-set-searchstyle-toggling-macros 'undefine)
-</pre></td></tr></table><a name="IDX199"></a>
+</pre></td></tr></table>
+<a name="IDX199"></a>
</dd>
<dt> <code>Vi-isms in Emacs state</code></dt>
@@ -2908,7 +2910,8 @@
non-nil argument. This can be done either interactively, by supplying a
prefix argument, or by placing
</p><table><tr><td> </td><td><pre
class="example">(viper-set-emacs-state-searchstyle-macros 'undefine)
-</pre></td></tr></table><a name="IDX202"></a>
+</pre></td></tr></table>
+<a name="IDX202"></a>
<p>in the hook to the major mode (e.g., <code>dired-mode-hook</code>).
See section <a href="#SEC30">Vi Macros</a>, for more information on Vi macros.
</p>
@@ -2966,7 +2969,8 @@
user should bind a function key, such as <kbd>f31</kbd>, as follows:
</p><table><tr><td> </td><td><pre class="example">(define-key
viper-insert-global-user-map [f31]
'viper-insert-prev-from-insertion-ring)
-</pre></td></tr></table><p>This binds <kbd>f31</kbd> (which is usually
<kbd>R11</kbd> on a Sun workstation)
+</pre></td></tr></table>
+<p>This binds <kbd>f31</kbd> (which is usually <kbd>R11</kbd> on a Sun
workstation)
to the function that inserts the previous string in the insertion history.
To rotate the history in the opposite
direction, you can either bind an unused key to
@@ -2996,7 +3000,8 @@
key. For instance, the following
</p><table><tr><td> </td><td><pre class="example">(define-key
viper-vi-global-user-map [f31]
'viper-prev-destructive-command)
-</pre></td></tr></table><p>binds the key <kbd>f31</kbd> (which is usually
<kbd>R11</kbd> on a Sun workstation)
+</pre></td></tr></table>
+<p>binds the key <kbd>f31</kbd> (which is usually <kbd>R11</kbd> on a Sun
workstation)
to the function that searches the command history in the direction of older
commands. To search in the opposite
direction, you can either bind an unused key to
@@ -3027,7 +3032,8 @@
</p><table><tr><td> </td><td><pre class="example">(copy-face 'default
'viper-minibuffer-vi-face)
(copy-face 'default 'viper-minibuffer-insert-face)
(copy-face 'default 'viper-minibuffer-emacs-face)
-</pre></td></tr></table><p>in the <tt>`~/.viper'</tt> file or through the
customization widget, as
+</pre></td></tr></table>
+<p>in the <tt>`~/.viper'</tt> file or through the customization widget, as
described above. However, in that case, the user will not have any
indication of the current Viper state in the minibuffer. (This is important
if the user accidentally switches to another Viper state by typing
<kbd>ESC</kbd> or
@@ -3103,7 +3109,8 @@
<code>viper-mouse-search-key</code> to something else in your
<code>~/.viper</code>
file:
</p><table><tr><td> </td><td><pre class="lisp">(setq
viper-mouse-search-key '(meta 1))
-</pre></td></tr></table><p>This would bind mouse search to the action invoked
by pressing the
+</pre></td></tr></table>
+<p>This would bind mouse search to the action invoked by pressing the
Meta key and clicking mouse button 1. The allowed values of
<code>viper-mouse-search-key</code> are lists that contain a mouse-button
number
(1,2, or 3) and any combination of the words `control', `meta', and
@@ -3114,6 +3121,7 @@
command in <code>~/.viper</code> after setting
<code>viper-mouse-search-key</code>:
</p><table><tr><td> </td><td><pre
class="lisp">(viper-bind-mouse-search-key 'force)
</pre></td></tr></table>
+
<p>You can also change this setting interactively, through the customization
widget of Emacs (type <kbd>:customize</kbd>).
</p>
@@ -3154,11 +3162,13 @@
default mouse action is already bound, you can rebind mouse-insert by
placing this command in <code>~/.viper</code>:
</p><table><tr><td> </td><td><pre class="lisp">(setq
viper-mouse-insert-key '(meta 2))
-</pre></td></tr></table><p>If you want to bind mouse-insert to an action even
if this action is
+</pre></td></tr></table>
+<p>If you want to bind mouse-insert to an action even if this action is
already taked for other purposes in Emacs, then you should add this command
to <code>~/.viper</code>, after setting <code>viper-mouse-insert-key</code>:
</p><table><tr><td> </td><td><pre
class="lisp">(viper-bind-mouse-insert-key 'force)
</pre></td></tr></table>
+
<p>This value can also be changed via the Emacs customization widget at the
menubar.
</p>
@@ -3279,6 +3289,7 @@
</p>
<table><tr><td> </td><td><pre class="example">[l up (meta x) n e x t - l
i n e return]
</pre></td></tr></table>
+
<p>Second, Viper macros are defined in a WYSIWYG style. This means that
commands are executed as you type them, so you can see precisely what is
being defined. Third, macros can be bound to arbitrary sequences of keys,
@@ -3419,6 +3430,7 @@
[(meta x) e v a l - l a s t - s e x p]
'lisp-interaction-mode)
</pre></td></tr></table>
+
<p>To illustrate the above point, Viper provides two canned macros, which, by
default, are bound to <kbd>[f12 \1]</kbd> and <kbd>[f12 \2]</kbd> (invoked by
typing
<kbd>f12</kbd> then <kbd>1</kbd> and <kbd>2</kbd>, respectively). These
macros are useful
@@ -3435,6 +3447,7 @@
t)
</pre></td></tr></table>
+
<p>Note that even though the macro uses the function key <kbd>f12</kbd>, the
key is
actually free and can still be bound to some Emacs function via
<code>define-key</code> or <code>global-set-key</code>.
@@ -3591,7 +3604,6 @@
<kbd>}</kbd>, <kbd>G</kbd>, <kbd>'</kbd>, <kbd>[[</kbd>, <kbd>]]</kbd>,
<kbd>[]</kbd>
</p></blockquote>
-
<p>Text Deletion Commands (see section <a href="#SEC38">Deleting Text</a>),
Change commands
(see section <a href="#SEC39">Changing Text</a>), even Shell Commands (see
section <a href="#SEC46">Shell Commands</a>)
use these commands to describe a region of text to operate on.
@@ -3670,11 +3682,9 @@
<a name="IDX248"></a>
<a name="IDX249"></a>
<a name="IDX250"></a>
-
<p>Others like <samp>`<args> -- arguments'</samp>, <samp>`<cmd> --
command'</samp> etc.
should be fairly obvious.
</p>
-
<p>Common characters referred to include:
</p>
<dl compact="compact">
@@ -3754,6 +3764,7 @@
</p>
<table><tr><td> </td><td><pre
class="example">(viper-set-syntax-preference nil "extended")
</pre></td></tr></table>
+
<p>in the appropriate major mode hooks.
</p>
<a name="IDX260"></a>
@@ -4013,7 +4024,8 @@
don't want this macro, put
</p>
<table><tr><td> </td><td><pre
class="example">(viper-set-parsing-style-toggling-macro 'undefine)
-</pre></td></tr></table><a name="IDX267"></a>
+</pre></td></tr></table>
+<a name="IDX267"></a>
<p>in your <tt>`~/.viper'</tt> file.
</p>
@@ -5619,6 +5631,7 @@
address@hidden (Jason Zapman II),
</pre></td></tr></table>
+
<hr size="6">
<a name="Key-Index"></a>
<a name="SEC51"></a>
Index: texi2html/Tests/viper_res/viper.html
diff -u texi2html/Tests/viper_res/viper.html:1.17
texi2html/Tests/viper_res/viper.html:1.18
--- texi2html/Tests/viper_res/viper.html:1.17 Tue Aug 23 23:51:16 2005
+++ texi2html/Tests/viper_res/viper.html Sat Mar 25 13:26:48 2006
@@ -68,6 +68,7 @@
it is a VI Plan for Emacs Rescue
and/or a venomous VI PERil.
</pre></td></tr></table>
+
<p>Technically speaking, Viper is a Vi emulation package for Emacs. It
implements all Vi and Ex commands, occasionally improving on them and
adding many new features. It gives the user the best of both worlds: Vi
Index: texi2html/Tests/viper_res/viper_0.html
diff -u texi2html/Tests/viper_res/viper_0.html:1.13
texi2html/Tests/viper_res/viper_0.html:1.14
--- texi2html/Tests/viper_res/viper_0.html:1.13 Tue Aug 23 23:51:16 2005
+++ texi2html/Tests/viper_res/viper_0.html Sat Mar 25 13:26:48 2006
@@ -59,7 +59,6 @@
</tr></table>
<h1 class="unnumbered"> Distribution </h1>
-
<p>Copyright © 1995, 1996, 1997, 2001, 2002 Free Software Foundation, Inc.
</p>
<p>Permission is granted to copy, distribute and/or modify this document
Index: texi2html/Tests/viper_res/viper_2.html
diff -u texi2html/Tests/viper_res/viper_2.html:1.24
texi2html/Tests/viper_res/viper_2.html:1.25
--- texi2html/Tests/viper_res/viper_2.html:1.24 Tue Aug 23 23:51:16 2005
+++ texi2html/Tests/viper_res/viper_2.html Sat Mar 25 13:26:48 2006
@@ -283,6 +283,7 @@
</p>
<table><tr><td> </td><td><pre class="lisp">M-x viper-mode
</pre></td></tr></table>
+
<p>When Emacs first comes up, if you have not specified a file on the
command line, it will show the <samp>`*scratch*'</samp> buffer, in the
<samp>`Lisp Interaction'</samp> mode. After you invoke Viper, you can start
@@ -547,7 +548,6 @@
Or you can use the MULE menu in the menubar.
</p></dd>
</dl>
-
<p>Other differences are mostly improvements. The ones you should know
about are:
</p>
@@ -640,7 +640,6 @@
</p></dd>
</dl>
-
<p>As Vi, Viper's destructive commands can be re-executed by typing
`<kbd>.</kbd>'.
However, in addition, Viper keeps track of the history of such commands. This
history can be perused by typing <kbd>C-c M-p</kbd> and <kbd>C-c M-n</kbd>.
@@ -933,7 +932,6 @@
</p></dd>
</dl>
-
<p>Currently undisplayed files can be listed using the <kbd>:ar</kbd> command.
The
command <kbd>:n</kbd> can be given counts from the <kbd>:ar</kbd> list to
switch to
other files. For example, use `:n3' to move to the third file in that list.
Index: texi2html/Tests/viper_res/viper_3.html
diff -u texi2html/Tests/viper_res/viper_3.html:1.23
texi2html/Tests/viper_res/viper_3.html:1.24
--- texi2html/Tests/viper_res/viper_3.html:1.23 Tue Aug 23 23:51:16 2005
+++ texi2html/Tests/viper_res/viper_3.html Sat Mar 25 13:26:48 2006
@@ -138,7 +138,6 @@
<a name="IDX42"></a>
<a name="IDX43"></a>
-
<p>If a point command is given as an argument to a modifying command, the
region determined by the point command will be affected by the modifying
command. On the other hand, if a line command is given as an argument to a
@@ -434,8 +433,8 @@
variable that controls how search patterns are highlighted is
<code>viper-search-face</code>. If you don't want any highlighting at all, put
</p><table><tr><td> </td><td><pre class="example">(copy-face 'default
'viper-search-face)
-</pre></td></tr></table><a name="IDX56"></a>
-
+</pre></td></tr></table>
+<a name="IDX56"></a>
<p>in <tt>`~/.viper'</tt>. If you want to change how patterns are
highlighted, you
will have to change <code>viper-search-face</code> to your liking. The easiest
way to do this is to use Emacs customization widget, which is accessible
@@ -559,6 +558,7 @@
</p>
<table><tr><td> </td><td><pre
class="example">(viper-set-syntax-preference nil "emacs")
</pre></td></tr></table>
+
<a name="IDX60"></a>
<p>The above discussion of the meaning of Viper's words concerns only Viper's
@@ -902,7 +902,6 @@
</p></dd>
</dl>
-
<p>Emacs Lisp archives exist on
<samp>`archive.cis.ohio-state.edu'</samp>
and <samp>`wuarchive.wustl.edu'</samp>
Index: texi2html/Tests/viper_res/viper_4.html
diff -u texi2html/Tests/viper_res/viper_4.html:1.23
texi2html/Tests/viper_res/viper_4.html:1.24
--- texi2html/Tests/viper_res/viper_4.html:1.23 Tue Aug 23 23:51:16 2005
+++ texi2html/Tests/viper_res/viper_4.html Sat Mar 25 13:26:48 2006
@@ -403,7 +403,8 @@
usually most effective:
</p><table><tr><td> </td><td><pre class="example">(set-face-foreground
viper-replace-overlay-face "DarkSlateBlue")
(set-face-background viper-replace-overlay-face "yellow")
-</pre></td></tr></table><p>For a complete list of colors available to you,
evaluate the expression
+</pre></td></tr></table>
+<p>For a complete list of colors available to you, evaluate the expression
<code>(x-defined-colors)</code>. (Type it in the buffer
<code>*scratch*</code> and then
hit the <kbd>C-j</kbd> key.
</p>
@@ -486,12 +487,12 @@
the last chance to do customization before Viper is up and running.
</p></dd>
</dl>
-
<p>You can reset some of these constants in Viper with the Ex command
<kbd>:set</kbd>
(when so indicated in the table). Or you
can include a line like this in your <tt>`.viper'</tt> file:
</p><table><tr><td> </td><td><pre class="example">(setq
viper-case-fold-search t)
-</pre></td></tr></table><a name="IDX136"></a>
+</pre></td></tr></table>
+<a name="IDX136"></a>
<a name="IDX137"></a>
<a name="IDX138"></a>
<a name="IDX139"></a>
@@ -584,6 +585,7 @@
(define-key function-key-map "\e[192z" [f11]) ; L1
(define-key function-key-map "\e[195z" [f14]) ; L4, Undo
</pre></td></tr></table>
+
<p>The above illustrates how to do this for Xterm. On VT100, you would have to
replace "xterm" with "vt100" and also change the key
sequences (the same
key may emit different sequences on different types of terminals).
@@ -609,7 +611,6 @@
The keymap <code>viper-insert-global-user-map</code> also affects Viper's
Replace
state.
</p>
-
<p>If you want to
bind a key, say <kbd>C-v</kbd>, to the function that scrolls
page down and to make <kbd>0</kbd> display information on the current buffer,
@@ -662,6 +663,7 @@
(define-key my-dired-modifier-map "u" 'dired-unmark)
(viper-modify-major-mode 'dired-mode 'vi-state my-dired-modifier-map)
</pre></td></tr></table>
+
<p>A Vi purist may want to modify Emacs state under Dired mode so that
<kbd>k</kbd>, <kbd>l</kbd>, etc., will move around in directory buffers, as in
Vi. Although this is not recommended, as these keys are bound to useful
@@ -672,6 +674,7 @@
(define-key my-dired-vi-purist-map "l" 'viper-forward-char)
(viper-modify-major-mode 'dired-mode 'emacs-state my-dired-vi-purist-map)
</pre></td></tr></table>
+
<p>Yet another way to customize key bindings in a major mode is to edit the
list <code>viper-major-mode-modifier-list</code> using the customization
widget.
<a name="IDX178"></a>
@@ -735,6 +738,7 @@
(viper-add-local-keys 'vi-state '(("ZZ" . mh-send-letter))))
(add-hook 'mh-letter-mode-hook 'mh-add-vi-keys)
</pre></td></tr></table>
+
<p>You can also use <code>viper-add-local-keys</code> to set per buffer
bindings in Insert state and Emacs state by passing as a parameter the
symbols <code>insert-state</code> and <code>emacs-state</code>, respectively.
@@ -949,7 +953,8 @@
<tt>`~/.viper'</tt> file. For instance, if you don't like the above feature,
put
this in <tt>`~/.viper'</tt>:
</p><table><tr><td> </td><td><pre
class="example">(viper-set-searchstyle-toggling-macros 'undefine)
-</pre></td></tr></table><a name="IDX199"></a>
+</pre></td></tr></table>
+<a name="IDX199"></a>
</dd>
<dt> <code>Vi-isms in Emacs state</code></dt>
@@ -974,7 +979,8 @@
non-nil argument. This can be done either interactively, by supplying a
prefix argument, or by placing
</p><table><tr><td> </td><td><pre
class="example">(viper-set-emacs-state-searchstyle-macros 'undefine)
-</pre></td></tr></table><a name="IDX202"></a>
+</pre></td></tr></table>
+<a name="IDX202"></a>
<p>in the hook to the major mode (e.g., <code>dired-mode-hook</code>).
See section <a href="#SEC30">Vi Macros</a>, for more information on Vi macros.
</p>
@@ -1032,7 +1038,8 @@
user should bind a function key, such as <kbd>f31</kbd>, as follows:
</p><table><tr><td> </td><td><pre class="example">(define-key
viper-insert-global-user-map [f31]
'viper-insert-prev-from-insertion-ring)
-</pre></td></tr></table><p>This binds <kbd>f31</kbd> (which is usually
<kbd>R11</kbd> on a Sun workstation)
+</pre></td></tr></table>
+<p>This binds <kbd>f31</kbd> (which is usually <kbd>R11</kbd> on a Sun
workstation)
to the function that inserts the previous string in the insertion history.
To rotate the history in the opposite
direction, you can either bind an unused key to
@@ -1062,7 +1069,8 @@
key. For instance, the following
</p><table><tr><td> </td><td><pre class="example">(define-key
viper-vi-global-user-map [f31]
'viper-prev-destructive-command)
-</pre></td></tr></table><p>binds the key <kbd>f31</kbd> (which is usually
<kbd>R11</kbd> on a Sun workstation)
+</pre></td></tr></table>
+<p>binds the key <kbd>f31</kbd> (which is usually <kbd>R11</kbd> on a Sun
workstation)
to the function that searches the command history in the direction of older
commands. To search in the opposite
direction, you can either bind an unused key to
@@ -1093,7 +1101,8 @@
</p><table><tr><td> </td><td><pre class="example">(copy-face 'default
'viper-minibuffer-vi-face)
(copy-face 'default 'viper-minibuffer-insert-face)
(copy-face 'default 'viper-minibuffer-emacs-face)
-</pre></td></tr></table><p>in the <tt>`~/.viper'</tt> file or through the
customization widget, as
+</pre></td></tr></table>
+<p>in the <tt>`~/.viper'</tt> file or through the customization widget, as
described above. However, in that case, the user will not have any
indication of the current Viper state in the minibuffer. (This is important
if the user accidentally switches to another Viper state by typing
<kbd>ESC</kbd> or
@@ -1169,7 +1178,8 @@
<code>viper-mouse-search-key</code> to something else in your
<code>~/.viper</code>
file:
</p><table><tr><td> </td><td><pre class="lisp">(setq
viper-mouse-search-key '(meta 1))
-</pre></td></tr></table><p>This would bind mouse search to the action invoked
by pressing the
+</pre></td></tr></table>
+<p>This would bind mouse search to the action invoked by pressing the
Meta key and clicking mouse button 1. The allowed values of
<code>viper-mouse-search-key</code> are lists that contain a mouse-button
number
(1,2, or 3) and any combination of the words `control', `meta', and
@@ -1180,6 +1190,7 @@
command in <code>~/.viper</code> after setting
<code>viper-mouse-search-key</code>:
</p><table><tr><td> </td><td><pre
class="lisp">(viper-bind-mouse-search-key 'force)
</pre></td></tr></table>
+
<p>You can also change this setting interactively, through the customization
widget of Emacs (type <kbd>:customize</kbd>).
</p>
@@ -1220,11 +1231,13 @@
default mouse action is already bound, you can rebind mouse-insert by
placing this command in <code>~/.viper</code>:
</p><table><tr><td> </td><td><pre class="lisp">(setq
viper-mouse-insert-key '(meta 2))
-</pre></td></tr></table><p>If you want to bind mouse-insert to an action even
if this action is
+</pre></td></tr></table>
+<p>If you want to bind mouse-insert to an action even if this action is
already taked for other purposes in Emacs, then you should add this command
to <code>~/.viper</code>, after setting <code>viper-mouse-insert-key</code>:
</p><table><tr><td> </td><td><pre
class="lisp">(viper-bind-mouse-insert-key 'force)
</pre></td></tr></table>
+
<p>This value can also be changed via the Emacs customization widget at the
menubar.
</p>
@@ -1345,6 +1358,7 @@
</p>
<table><tr><td> </td><td><pre class="example">[l up (meta x) n e x t - l
i n e return]
</pre></td></tr></table>
+
<p>Second, Viper macros are defined in a WYSIWYG style. This means that
commands are executed as you type them, so you can see precisely what is
being defined. Third, macros can be bound to arbitrary sequences of keys,
@@ -1485,6 +1499,7 @@
[(meta x) e v a l - l a s t - s e x p]
'lisp-interaction-mode)
</pre></td></tr></table>
+
<p>To illustrate the above point, Viper provides two canned macros, which, by
default, are bound to <kbd>[f12 \1]</kbd> and <kbd>[f12 \2]</kbd> (invoked by
typing
<kbd>f12</kbd> then <kbd>1</kbd> and <kbd>2</kbd>, respectively). These
macros are useful
@@ -1501,6 +1516,7 @@
t)
</pre></td></tr></table>
+
<p>Note that even though the macro uses the function key <kbd>f12</kbd>, the
key is
actually free and can still be bound to some Emacs function via
<code>define-key</code> or <code>global-set-key</code>.
Index: texi2html/Tests/viper_res/viper_5.html
diff -u texi2html/Tests/viper_res/viper_5.html:1.23
texi2html/Tests/viper_res/viper_5.html:1.24
--- texi2html/Tests/viper_res/viper_5.html:1.23 Tue Aug 23 23:51:16 2005
+++ texi2html/Tests/viper_res/viper_5.html Sat Mar 25 13:26:48 2006
@@ -129,7 +129,6 @@
<kbd>}</kbd>, <kbd>G</kbd>, <kbd>'</kbd>, <kbd>[[</kbd>, <kbd>]]</kbd>,
<kbd>[]</kbd>
</p></blockquote>
-
<p>Text Deletion Commands (see section <a href="#SEC38">Deleting Text</a>),
Change commands
(see section <a href="#SEC39">Changing Text</a>), even Shell Commands (see
section <a href="#SEC46">Shell Commands</a>)
use these commands to describe a region of text to operate on.
@@ -208,11 +207,9 @@
<a name="IDX248"></a>
<a name="IDX249"></a>
<a name="IDX250"></a>
-
<p>Others like <samp>`<args> -- arguments'</samp>, <samp>`<cmd> --
command'</samp> etc.
should be fairly obvious.
</p>
-
<p>Common characters referred to include:
</p>
<dl compact="compact">
@@ -292,6 +289,7 @@
</p>
<table><tr><td> </td><td><pre
class="example">(viper-set-syntax-preference nil "extended")
</pre></td></tr></table>
+
<p>in the appropriate major mode hooks.
</p>
<a name="IDX260"></a>
@@ -551,7 +549,8 @@
don't want this macro, put
</p>
<table><tr><td> </td><td><pre
class="example">(viper-set-parsing-style-toggling-macro 'undefine)
-</pre></td></tr></table><a name="IDX267"></a>
+</pre></td></tr></table>
+<a name="IDX267"></a>
<p>in your <tt>`~/.viper'</tt> file.
</p>
Index: texi2html/Tests/viper_res/viper_6.html
diff -u texi2html/Tests/viper_res/viper_6.html:1.14
texi2html/Tests/viper_res/viper_6.html:1.15
--- texi2html/Tests/viper_res/viper_6.html:1.14 Tue Aug 9 17:19:25 2005
+++ texi2html/Tests/viper_res/viper_6.html Sat Mar 25 13:26:48 2006
@@ -126,6 +126,7 @@
address@hidden (Jason Zapman II),
</pre></td></tr></table>
+
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="viper_5.html#SEC31"
title="Beginning of this chapter or previous chapter"> << </a>]</td>
Index: texi2html/Tests/xemacs_frame_res/xemacs_1.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_1.html:1.18
texi2html/Tests/xemacs_frame_res/xemacs_1.html:1.19
--- texi2html/Tests/xemacs_frame_res/xemacs_1.html:1.18 Tue Aug 23 23:51:16 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_1.html Sat Mar 25 13:26:48 2006
@@ -69,6 +69,7 @@
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
</pre></td></tr></table>
+
<hr size="6">
<a name="SEC2"></a>
<table cellpadding="1" cellspacing="1" border="0">
@@ -343,6 +344,7 @@
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
</pre></td></tr></table>
+
<p>Also add information on how to contact you by electronic and paper mail.
</p>
<p>If the program is interactive, make it output a short notice like this
@@ -353,6 +355,7 @@
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
</pre></td></tr></table>
+
<p>The hypothetical commands `show w' and `show c' should show the
appropriate parts of the General Public License. Of course, the
commands you use may be called something other than `show w' and `show
@@ -371,6 +374,7 @@
<var>signature of Ty Coon</var>, 1 April 1989
Ty Coon, President of Vice
</pre></td></tr></table>
+
<p>That's all there is to it!
</p>
<hr size="6">
Index: texi2html/Tests/xemacs_frame_res/xemacs_10.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_10.html:1.16
texi2html/Tests/xemacs_frame_res/xemacs_10.html:1.17
--- texi2html/Tests/xemacs_frame_res/xemacs_10.html:1.16 Tue Aug 23
23:51:16 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_10.html Sat Mar 25 13:26:48 2006
@@ -89,7 +89,8 @@
invoke the command <code>forward-char</code>, type:
</p>
<table><tr><td> </td><td><pre class="example">M-x forward-char
<kbd>RET</kbd>
-</pre></td></tr></table><p>or
+</pre></td></tr></table>
+<p>or
</p><table><tr><td> </td><td><pre class="example">M-x fo <kbd>TAB</kbd> c
<kbd>RET</kbd>
</pre></td></tr></table>
@@ -113,6 +114,7 @@
</p>
<table><tr><td> </td><td><pre class="example"> (defun foo (arg)
"Doc string" (interactive "p") ...use arg...)
</pre></td></tr></table>
+
<p>to make <code>arg</code> be the prefix argument when <code>foo</code> is
called as a
command. The call to <code>interactive</code> is actually a declaration
rather than a function; it tells <code>call-interactively</code> how to read
Index: texi2html/Tests/xemacs_frame_res/xemacs_11.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_11.html:1.19
texi2html/Tests/xemacs_frame_res/xemacs_11.html:1.20
--- texi2html/Tests/xemacs_frame_res/xemacs_11.html:1.19 Tue Aug 23
23:51:16 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_11.html Sat Mar 25 13:26:48 2006
@@ -486,6 +486,7 @@
vms support code for vms
wp word processing
</pre></td></tr></table>
+
<hr size="6">
<a name="Help-Mode"></a>
<a name="SEC77"></a>
Index: texi2html/Tests/xemacs_frame_res/xemacs_12.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_12.html:1.21
texi2html/Tests/xemacs_frame_res/xemacs_12.html:1.22
--- texi2html/Tests/xemacs_frame_res/xemacs_12.html:1.21 Tue Aug 23
23:51:16 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_12.html Sat Mar 25 13:26:48 2006
@@ -498,6 +498,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(global-set-key '(shift
button1) 'mouse-del-char)
</pre></td></tr></table>
+
<a name="IDX310"></a>
<a name="IDX311"></a>
<a name="IDX312"></a>
Index: texi2html/Tests/xemacs_frame_res/xemacs_15.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_15.html:1.23
texi2html/Tests/xemacs_frame_res/xemacs_15.html:1.24
--- texi2html/Tests/xemacs_frame_res/xemacs_15.html:1.23 Tue Aug 23
23:51:16 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_15.html Sat Mar 25 13:26:48 2006
@@ -244,6 +244,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(define-key
isearch-mode-map "\C-b" 'isearch-repeat-backward)
</pre></td></tr></table>
+
<p>These are the default bindings of isearch-mode:
</p>
<a name="IDX412"></a>
Index: texi2html/Tests/xemacs_frame_res/xemacs_17.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_17.html:1.20
texi2html/Tests/xemacs_frame_res/xemacs_17.html:1.21
--- texi2html/Tests/xemacs_frame_res/xemacs_17.html:1.20 Tue Aug 23
23:51:16 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_17.html Sat Mar 25 13:26:48 2006
@@ -465,6 +465,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(No changes need to be
saved)
</pre></td></tr></table>
+
<a name="IDX561"></a>
<a name="IDX562"></a>
<p> The command <kbd>C-x s</kbd> (<code>save-some-buffers</code>) can save
any or all
@@ -650,7 +651,6 @@
</p></dd>
</dl>
-
<p><code>version-control</code> may be set locally in an individual buffer to
control the making of backups for that buffer's file. For example,
Rmail mode locally sets <code>version-control</code> to <code>never</code> to
make sure
@@ -1092,6 +1092,7 @@
<table><tr><td> </td><td><pre class="example">M-x recover-file
<kbd>RET</kbd> foo.c <kbd>RET</kbd>
C-x C-s
</pre></td></tr></table>
+
<p> Before asking for confirmation, <kbd>M-x recover-file</kbd> displays a
directory listing describing the specified file and the auto-save file,
so you can compare their sizes and dates. If the auto-save file
@@ -1273,7 +1274,6 @@
</p></dd>
</dl>
-
<p>(<kbd>C-x v</kbd> is the prefix key for version control commands; all of
these
commands except for <kbd>C-x C-q</kbd> start with <kbd>C-x v</kbd>.)
</p>
@@ -1541,6 +1541,7 @@
* vc.el (vc-do-command): Check call-process status.
</pre></td></tr></table>
+
<p> When <kbd>C-x v a</kbd> adds several change log entries at once, it groups
related log entries together if they all are checked in by the same
author at nearly the same time. If the log entries for several such
@@ -1555,6 +1556,7 @@
For <tt>`vc-hooks.el'</tt>:
Don't call expand-file-name.
</pre></td></tr></table>
+
<p> They appear like this in <tt>`ChangeLog'</tt>:
</p>
<table><tr><td> </td><td><pre class="smallexample">Wed Apr 1 08:57:59
1992 Nathaniel Bowditch (address@hidden)
@@ -1563,6 +1565,7 @@
* vc.el, vc-hooks.el: Don't call expand-file-name.
</pre></td></tr></table>
+
<p> Normally, <kbd>C-x v a</kbd> separates log entries by a blank line, but
you
can mark several related log entries to be clumped together (without an
intervening blank line) by starting the text of each related log entry
@@ -1585,6 +1588,7 @@
* vc.texinfo: Fix expansion typos.
* vc.el, vc-hooks.el: Don't call expand-file-name.
</pre></td></tr></table>
+
<p> A log entry whose text begins with <samp>`#'</samp> is not copied to
<tt>`ChangeLog'</tt>. For example, if you merely fix some misspellings in
comments, you can log the change with an entry beginning with <samp>`#'</samp>
@@ -1975,6 +1979,7 @@
static char vcid[] = "<var>string</var>";
#endif /* lint */
</pre></td></tr></table>
+
<hr size="6">
<a name="ListDir"></a>
<a name="SEC161"></a>
@@ -2025,6 +2030,7 @@
</p>
<table><tr><td> </td><td><pre class="example">C-x C-d /u2/emacs/src/*.c
<kbd>RET</kbd>
</pre></td></tr></table>
+
<p> Normally, <kbd>C-x C-d</kbd> prints a brief directory listing containing
just
file names. A numeric argument (regardless of value) tells it to print a
verbose listing (like <code>ls -l</code>).
Index: texi2html/Tests/xemacs_frame_res/xemacs_20.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_20.html:1.22
texi2html/Tests/xemacs_frame_res/xemacs_20.html:1.23
--- texi2html/Tests/xemacs_frame_res/xemacs_20.html:1.22 Tue Aug 23
23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_20.html Sat Mar 25 13:26:48 2006
@@ -468,6 +468,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(set-charset-registry
'cyrillic-iso8859-5 "koi8-r")
</pre></td></tr></table>
+
<p>(Please note that you probably also want to set font registry for
<samp>`ascii'</samp> charset so that mixed English/Cyrillic texts be displayed
using the same font.)
@@ -488,6 +489,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(set-charset-ccl-program
'cyrillic-iso8859-5 'ccl-encode-koi8-r-font)
</pre></td></tr></table>
+
<p>There are several more uses for CCL programs, not related to fonts, but
those uses are not described here.
</p>
Index: texi2html/Tests/xemacs_frame_res/xemacs_22.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_22.html:1.18
texi2html/Tests/xemacs_frame_res/xemacs_22.html:1.19
--- texi2html/Tests/xemacs_frame_res/xemacs_22.html:1.18 Tue Aug 23
23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_22.html Sat Mar 25 13:26:48 2006
@@ -260,6 +260,7 @@
0123456789012345678901234567890123456789012345678
To install changes, type C-c C-c
</pre></td></tr></table>
+
<p> The first line contains a colon at each tab stop. The remaining lines
help you see where the colons are and tell you what to do.
</p>
Index: texi2html/Tests/xemacs_frame_res/xemacs_23.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_23.html:1.19
texi2html/Tests/xemacs_frame_res/xemacs_23.html:1.20
--- texi2html/Tests/xemacs_frame_res/xemacs_23.html:1.19 Tue Aug 23
23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_23.html Sat Mar 25 13:26:48 2006
@@ -633,6 +633,7 @@
A second first-level topic with its header line.
</pre></td></tr></table>
+
<p> A heading line together with all following body lines is called
collectively an <em>entry</em>. A heading line together with all following
deeper heading lines and their body lines is called a <em>subtree</em>.
Index: texi2html/Tests/xemacs_frame_res/xemacs_24.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_24.html:1.22
texi2html/Tests/xemacs_frame_res/xemacs_24.html:1.23
--- texi2html/Tests/xemacs_frame_res/xemacs_24.html:1.22 Tue Aug 23
23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_24.html Sat Mar 25 13:26:48 2006
@@ -706,7 +706,6 @@
<dd><p>The position at which the line being indented begins.
</p></dd>
</dl>
-
<p>It should return either a number, which is the number of columns of
indentation for that line, or a list whose first element is such a
number. The difference between returning a number and returning a list
@@ -822,6 +821,7 @@
do_it ();
}
</pre></td></tr></table>
+
<p> When <code>c-indent-level</code> is zero, the statements inside most
braces
line up exactly under the open brace. An exception are braces in column
zero, like those surrounding a function's body. The statements inside
@@ -866,6 +866,7 @@
<table><tr><td> </td><td><pre class="example">if (x == y)
{
</pre></td></tr></table>
+
<a name="IDX946"></a>
<p> <code>c-argdecl-indent</code> controls the indentation of declarations of
the
arguments of a C function. It is absolute: argument declarations receive
@@ -877,6 +878,7 @@
char *string;
int char;
</pre></td></tr></table>
+
<a name="IDX947"></a>
<p> <code>c-label-offset</code> is the extra indentation given to a line that
contains a label, a case statement, or a <code>default:</code> statement. Its
@@ -1021,6 +1023,7 @@
;; The following line adds one.
(1+ x)) ; This line adds one.
</pre></td></tr></table>
+
<p> In C code, a comment preceded on its line by nothing but whitespace
is indented like a line of code.
</p>
@@ -1343,6 +1346,7 @@
(case where line is killed, point is at eob and that line is
not displayed), set it again in final compute_motion.
</pre></td></tr></table>
+
<hr size="6">
<a name="Tags"></a>
<a name="SEC232"></a>
@@ -1665,6 +1669,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">find . -name
"*.[chCH]" -print | etags -
</pre></td></tr></table>
+
<p> Use the option <samp>`--language=<var>name</var>'</samp> to specify the
language
explicitly. You can intermix these options with file names; each one
applies to the file names that follow it. Specify
@@ -1787,6 +1792,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">etags address@hidden
*.[ch] */*.[ch]
</pre></td></tr></table>
+
<p> Here are some more examples. The regexps are quoted to protect them
from shell interpretation.
</p>
@@ -1810,6 +1816,7 @@
<table><tr><td> </td><td><pre class="smallexample">etags --language=none
--regex='/proc[ \t]+\([^ \t]+\)/\1/' *.tcl
</pre></td></tr></table>
+
</li><li>
Tag VHDL files:
@@ -1817,7 +1824,8 @@
--regex='/[ \t]*\(ARCHITECTURE\|CONFIGURATION\) +[^ ]* +OF/' \
--regex='/[ \t]*\(ATTRIBUTE\|ENTITY\|FUNCTION\|PACKAGE\
\( BODY\)?\|PROCEDURE\|PROCESS\|TYPE\)[ \t]+\([^ \t(]+\)/\3/'
-</pre></td></tr></table></li></ul>
+</pre></td></tr></table>
+</li></ul>
<hr size="6">
<a name="Select-Tags-Table"></a>
@@ -1873,6 +1881,7 @@
("" . "/usr/local/emacs/src/")
))
</pre></td></tr></table>
+
<p>The example defines the tags table alist in the following way:
</p>
<ul>
@@ -2459,7 +2468,6 @@
By default, this character is <samp>`$'</samp>.
</li></ul>
-
<p>If you fail to follow these conventions, the indentation commands may
indent some lines unaesthetically. However, a correct Fortran program will
retain its meaning when reindented even if the conventions are not
Index: texi2html/Tests/xemacs_frame_res/xemacs_25.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_25.html:1.25
texi2html/Tests/xemacs_frame_res/xemacs_25.html:1.26
--- texi2html/Tests/xemacs_frame_res/xemacs_25.html:1.25 Tue Aug 23
23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_25.html Sat Mar 25 13:26:48 2006
@@ -207,6 +207,7 @@
</p>
<table><tr><td> </td><td><pre class="example">if ($?prompt) set prompt =
...
</pre></td></tr></table>
+
<hr size="6">
<a name="Lisp-Modes"></a>
<a name="SEC253"></a>
@@ -494,6 +495,7 @@
</p>
<table><tr><td> </td><td><pre class="example">emacs -batch -f
batch-byte-compile <var>files</var>...
</pre></td></tr></table>
+
<p> Directory names may also be given as arguments; in that case,
<code>byte-recompile-directory</code> is invoked on each such directory.
<code>batch-byte-compile</code> uses all remaining command-line arguments as
@@ -1098,10 +1100,12 @@
</p>
<table><tr><td> </td><td><pre class="example"> Tools ->
Packages -> List and Install
</pre></td></tr></table>
+
<p>Or, you can get to it via the keyboard:
</p>
<table><tr><td> </td><td><pre class="example">M-x pui-list-packages
</pre></td></tr></table>
+
<p>Hint to system administrators of multi-user systems: it might be a good
idea to install all packages and not interfere with the wishes of your
users.
@@ -1112,6 +1116,7 @@
</p>
<table><tr><td> </td><td><pre class="example">M-x
package-get-package-provider RET thingatpt
</pre></td></tr></table>
+
<p>which will return something like (fsf-compat "1.08"). You can the
use
one of the methods above for installing the package you want.
</p>
@@ -1199,6 +1204,7 @@
tar zxvf /path/to/xemacs-base-1.48-pkg.tar.gz RET
</pre></td></tr></table>
+
<p>For MULE related packages, it is best to untar into the mule-packages
hierarchy, i.e. for the <tt>`mule-base'</tt> package, version 1.37:
</p>
@@ -1210,6 +1216,7 @@
tar zxvf /path/to/mule-base-1.37-pkg.tar.gz RET
</pre></td></tr></table>
+
<a name="Automatically"></a>
<a name="SEC274"></a>
<h2 class="heading"> Automatic Package Installation: </h2>
@@ -1229,6 +1236,7 @@
mule-base - Needed if you want to use XEmacs with MULE.
</pre></td></tr></table>
+
<p>After installing these by hand, fire up XEmacs and follow these
steps.
</p>
@@ -1344,6 +1352,7 @@
</p>
<table><tr><td> </td><td><pre class="example">M-x package-get-all
<return>
</pre></td></tr></table>
+
<p>Enter the name of the package (e.g., <code>prog-modes</code>), and XEmacs
will search for the latest version and install it and any packages that
it depends upon.
@@ -1534,6 +1543,7 @@
want to install. eg:
</p><table><tr><td> </td><td><pre class="example"> XEMACS_PACKAGES =
xemacs-packages/xemacs-base xemacs-packages/bbdb
</pre></td></tr></table>
+
</dd>
<dt> <var>XEMACS_STAGING = ${XEMACS_PACKAGES_BASE}/../Packages</var></dt>
<dd><p>Set this to where you want normal packages to be
@@ -1555,6 +1565,7 @@
packages you want to install here. eg:
</p><table><tr><td> </td><td><pre class="example"> MULE_PACKAGES =
mule-packages/mule-base mule-packages/skk
</pre></td></tr></table>
+
</dd>
<dt> <var>MULE_STAGING = ${XEMACS_PACKAGES_BASE}/../Mule-Packages</var></dt>
<dd><p>Set this to where you want Mule packages installed
@@ -1619,6 +1630,7 @@
type regular
))
</pre></td></tr></table>
+
<p>You must fill in the four commented lines. The value of <code>name</code>
is
the name of your package as an unquoted symbol. Normally it is the name
of the main Lisp file or principal feature provided. The allowed values
@@ -1670,6 +1682,7 @@
<p>The include is simply
</p><table><tr><td> </td><td><pre class="example">include
../../XEmacs.rules
</pre></td></tr></table>
+
<p>The standard targets follow. These are
</p>
<table><tr><td> </td><td><pre class="example">all:: $(ELCS)
auto-autoloads.elc
@@ -1678,6 +1691,7 @@
binkit: binkit-alias
</pre></td></tr></table>
+
<p>Other targets (such as Texinfo sources) may need to be added as
dependencies for the <code>all</code> target. Dependencies for
<code>srckit</code>
and <code>binkit</code> (that is, values for <var>srckit-alias</var> and
Index: texi2html/Tests/xemacs_frame_res/xemacs_28.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_28.html:1.18
texi2html/Tests/xemacs_frame_res/xemacs_28.html:1.19
--- texi2html/Tests/xemacs_frame_res/xemacs_28.html:1.18 Tue Aug 23
23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_28.html Sat Mar 25 13:26:48 2006
@@ -143,8 +143,8 @@
</p>
<table><tr><td> </td><td><pre class="example">--text follows this line--
</pre></td></tr></table>
-<a name="IDX1117"></a>
+<a name="IDX1117"></a>
<p>is a special delimiter that separates the headers you have specified from
the text. Whatever follows this line is the text of the message; the
headers precede it. The delimiter line itself does not appear in the
@@ -160,6 +160,7 @@
--Text follows this line--
Please ignore this message.
</pre></td></tr></table>
+
<hr size="6">
<a name="Mail-Headers"></a>
<a name="SEC298"></a>
@@ -240,11 +241,9 @@
</p></dd>
</dl>
-
<p>The <samp>`To'</samp>, <samp>`CC'</samp>, <samp>`BCC'</samp> and
<samp>`FCC'</samp> fields can appear
any number of times, to specify many places to send the message.
</p>
-
<p>The <samp>`To'</samp>, <samp>`CC'</samp>, and <samp>`BCC'</samp>, fields
can have continuation
lines. All the lines starting with whitespace, following the line on
which the field starts, are considered part of the field. For
@@ -302,6 +301,7 @@
</p>
<table><tr><td> </td><td><pre class="example"> alias someone
"John Doe <address@hidden>"
</pre></td></tr></table>
+
<p>That is, if you want an address to have embedded spaces, simply surround
it with double-quotes. The quotes are necessary because the format of
the <tt>`.mailrc'</tt> file uses spaces as address delimiters.
@@ -312,9 +312,11 @@
alias group2 larry curly moe
alias everybody group1 group2
</pre></td></tr></table>
+
<p>When you now type <samp>`everybody'</samp> on the <samp>`To'</samp> line,
it will expand to:
</p><table><tr><td> </td><td><pre class="example"> fred, ethyl,
larry, curly, moe
</pre></td></tr></table>
+
<p>Aliases may contain forward references; the alias of
<samp>`everybody'</samp> in the
example above can precede the aliases of <samp>`group1'</samp> and
<samp>`group2'</samp>.
</p>
Index: texi2html/Tests/xemacs_frame_res/xemacs_29.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_29.html:1.21
texi2html/Tests/xemacs_frame_res/xemacs_29.html:1.22
--- texi2html/Tests/xemacs_frame_res/xemacs_29.html:1.21 Tue Aug 23
23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_29.html Sat Mar 25 13:26:48 2006
@@ -1361,9 +1361,9 @@
<table><tr><td> </td><td><pre class="display">1 kin = 1
day 1 uinal = 20 kin 1 tun = 18 uinal
1 katun = 20 tun 1 baktun = 20 katun
</pre></td></tr></table>
+
<a name="IDX1266"></a>
<a name="IDX1267"></a>
-
<p>Thus, the long count date 12.16.11.16.6 means 12 baktun, 16 katun, 11
tun, 16 uinal, and 6 kin. The Emacs calendar can handle Mayan long
count dates as early as 7.17.18.13.1, but no earlier. When you use the
@@ -1697,6 +1697,7 @@
*/25 Monthly cycle finishes
Friday Don't leave without backing up files
</pre></td></tr></table>
+
<p> The first entry appears only once, on April 20, 1993. The second and
third appear every year on the specified dates, and the fourth uses a
wildcard (asterisk) for the month, so it appears on the 25th of every
@@ -2113,7 +2114,6 @@
terminal.
</p>
<a name="IDX1320"></a>
-
<p> A similar normal hook, <code>today-invisible-calendar-hook</code> is run
if
the current date is <em>not</em> visible in the window.
</p>
@@ -2238,9 +2238,9 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">(setq other-holidays
'((holiday-fixed 7 14 "Bastille Day")))
</pre></td></tr></table>
+
<p>See section <a href="xemacs_30.html#SEC377">The Init File</a>.
</p>
-
<p>The holiday form <code>(holiday-fixed 7 14 "Bastille Day")</code>
specifies the
fourteenth day of the seventh month (July).
</p>
@@ -2296,6 +2296,7 @@
(list 11 1 displayed-year)))))))
"US Presidential Election"))
</pre></td></tr></table>
+
<p> Some holidays just don't fit into any of these forms because special
calculations are involved in their determination. In such cases you
must write a Lisp function to do the calculation. To include eclipses,
@@ -2306,6 +2307,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">(((6 27 1991)
"Lunar Eclipse") ((7 11 1991) "Solar Eclipse") ... )
</pre></td></tr></table>
+
<hr size="6">
<a name="Date-Display-Format"></a>
<a name="SEC327"></a>
@@ -2342,8 +2344,8 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">((if dayname (concat
dayname ", ")) day " " monthname " " year)
</pre></td></tr></table>
-<p>+
-The ISO standard date representation is this:
+
+<p>+The ISO standard date representation is this:
</p>
<table><tr><td> </td><td><pre class="smallexample">(year "-"
month "-" day)
</pre></td></tr></table>
@@ -2352,6 +2354,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">(month "/"
day "/" (substring year -2))
</pre></td></tr></table>
+
<hr size="6">
<a name="Time-Display-Format"></a>
<a name="SEC328"></a>
@@ -2462,6 +2465,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(list 10 1 year)
</pre></td></tr></table>
+
<p> For a more complex example, suppose daylight savings time begins on
the first of Nisan on the Hebrew calendar. You should set
<code>calendar-daylight-savings-starts</code> to this value:
@@ -2649,6 +2653,7 @@
<table><tr><td> </td><td><pre class="smallexample">(add-hook
'nongregorian-diary-listing-hook 'list-islamic-diary-entries)
(add-hook 'nongregorian-diary-marking-hook 'mark-islamic-diary-entries)
</pre></td></tr></table>
+
<p> Hebrew- and Islamic-date diary entries have the same formats as
Gregorian-date diary entries, except that <samp>`H'</samp> precedes a Hebrew
date and <samp>`I'</samp> precedes an Islamic date. Moreover, because the
@@ -2778,9 +2783,9 @@
<a name="IDX1352"></a>
<table><tr><td> </td><td><pre class="example">(add-hook
'list-diary-entries-hook 'sort-diary-entries t)
</pre></td></tr></table>
+
<p>See section <a href="xemacs_30.html#SEC377">The Init File</a>.
</p>
-
<p>For each day, this sorts diary entries that begin with a recognizable
time of day according to their times. Diary entries without times come
first within each day.
@@ -2826,6 +2831,7 @@
<table><tr><td> </td><td><pre class="smallexample">(add-hook
'list-diary-entries-hook 'include-other-diary-files)
(add-hook 'mark-diary-entries-hook 'mark-included-diary-files)
</pre></td></tr></table>
+
<p>The include mechanism works only with the fancy diary display, because
ordinary diary display shows the entries directly from your diary file.
</p>
@@ -2876,6 +2882,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">Arthur's 42nd birthday
</pre></td></tr></table>
+
<p> Similarly, cyclic diary entries can interpolate the number of repetitions
that have occurred:
</p>
@@ -2964,7 +2971,6 @@
</p></dd>
</dl>
-
<p>Thus including the diary entry
</p>
<table><tr><td> </td><td><pre
class="smallexample">&%%(diary-hebrew-date)
@@ -4089,6 +4095,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(viper-mode)
</pre></td></tr></table>
+
<p>in your init file. See section <a href="xemacs_30.html#SEC377">The Init
File</a>.
</p>
<p>Viper comes with a separate manual that is provided standard
Index: texi2html/Tests/xemacs_frame_res/xemacs_30.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_30.html:1.23
texi2html/Tests/xemacs_frame_res/xemacs_30.html:1.24
--- texi2html/Tests/xemacs_frame_res/xemacs_30.html:1.23 Tue Aug 23
23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_30.html Sat Mar 25 13:26:48 2006
@@ -269,8 +269,8 @@
*Column beyond which automatic line-wrapping should happen.
Automatically becomes local when set in any fashion.
</pre></td></tr></table>
-<a name="IDX1475"></a>
+<a name="IDX1475"></a>
<p>The star at the beginning of the documentation indicates that this variable
is an option. <kbd>C-h v</kbd> is not restricted to options; it allows any
variable name.
@@ -448,6 +448,7 @@
[State]: this option is unchanged from its standard setting.
Maximum length of kill ring before oldest elements are thrown away.
</pre></td></tr></table>
+
<p> The text following <samp>`[Hide]'</samp>, <samp>`30'</samp> in this case,
indicates
the current value of the option. If you see <samp>`[Show]'</samp> instead of
<samp>`[Hide]'</samp>, it means that the value is hidden; the customization
@@ -475,6 +476,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">[State]: you have
edited the value as text, but not set the option.
</pre></td></tr></table>
+
<a name="IDX1480"></a>
<p> Editing the value does not actually set the option variable. To do
that, you must <em>set</em> the option. To do this, invoke the word
@@ -484,6 +486,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">[State]: you have set
this option, but not saved it for future sessions.
</pre></td></tr></table>
+
<p> You don't have to worry about specifying a value that is not valid;
setting the option checks for validity and will not really install an
unacceptable value.
@@ -634,6 +637,7 @@
[ ] Size:
[ ] Strikethru: off
</pre></td></tr></table>
+
<p> Each face attribute has its own line. The <samp>`[<var>x</var>]'</samp>
field
before the attribute name indicates whether the attribute is
<em>enabled</em>; <samp>`X'</samp> means that it is. You can enable or
disable the
@@ -785,6 +789,7 @@
Automatically becomes local when set in any fashion.
;;
</pre></td></tr></table>
+
<a name="IDX1495"></a>
<p> <kbd>M-x edit-options</kbd> goes one step further and immediately selects
the
<samp>`*List Options*'</samp> buffer; this buffer uses the major mode Options
mode,
@@ -914,6 +919,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(default-value 'fill-column)
</pre></td></tr></table>
+
<hr size="6">
<a name="File-Variables"></a>
<a name="SEC362"></a>
@@ -974,6 +980,7 @@
;;; comment-end:"***" ***
;;; End: ***
</pre></td></tr></table>
+
<p> Note that the prefix is <samp>`;;; '</samp> and the suffix is <samp>`
***'</samp>.
Note also that comments in the file begin with and end with the same
strings. Presumably the file contains code in a language which is
@@ -1009,11 +1016,13 @@
;;; -*- mode: postscript; version-control: never -*-
;;; -*- tags-file-name: "/foo/bar/TAGS" -*-
</pre></td></tr></table>
+
<p>For historical reasons, the syntax <code>`-*- modename -*-'</code> is
allowed
as well; for example, you can use:
</p>
<table><tr><td> </td><td><pre class="example"> ;;; -*- emacs-lisp
-*-
</pre></td></tr></table>
+
<a name="IDX1503"></a>
<p>The variable <code>enable-local-variables</code> controls the use of local
variables lists in files you visit. The value can be <code>t</code>,
@@ -1642,6 +1651,7 @@
</pre></td></tr></table>
+
<hr size="6">
<a name="Key-Bindings-Using-Strings"></a>
<a name="SEC372"></a>
@@ -1669,6 +1679,7 @@
<table><tr><td> </td><td><pre class="example">;;; Bind
<code>end-of-line</code> to <kbd>C-f</kbd>
(global-set-key "\C-f" 'end-of-line)
</pre></td></tr></table>
+
<p>Note, however, that in some cases you may be binding more than one
key sequence by using a single command. This situation can
arise because in ASCII, <kbd>C-i</kbd> and <kbd>TAB</kbd> have
@@ -1676,6 +1687,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(global-set-key
"\C-i" 'end-of-line)
</pre></td></tr></table>
+
<p>it is unclear whether the user intended to bind <kbd>C-i</kbd> or
<kbd>TAB</kbd>.
The solution XEmacs adopts is to bind both of these key
sequences.
@@ -1685,11 +1697,13 @@
</p>
<table><tr><td> </td><td><pre class="example"> (define-key
global-map "\^X\^I" 'command-1)
</pre></td></tr></table>
+
<p>it is possible to redefine only one of those sequences like so:
</p>
<table><tr><td> </td><td><pre class="example"> (define-key
global-map [(control x) (control i)] 'command-2)
(define-key global-map [(control x) tab] 'command-3)
</pre></td></tr></table>
+
<p>This applies only when running under a window system. If you are
talking to Emacs through an ASCII-only channel, you do not get any of
these features.
@@ -1705,6 +1719,7 @@
control [ escape
control @ control space
</pre></td></tr></table>
+
<hr size="6">
<a name="Disabling"></a>
<a name="SEC373"></a>
@@ -1737,6 +1752,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(put 'delete-region
'disabled t)
</pre></td></tr></table>
+
<p>See section <a href="#SEC377">The Init File</a>.
</p>
<p> If the value of the <code>disabled</code> property is a string, that
string
@@ -1745,6 +1761,7 @@
<table><tr><td> </td><td><pre class="example">(put 'delete-region
'disabled
"Text deleted this way cannot be yanked back!\n")
</pre></td></tr></table>
+
<a name="IDX1526"></a>
<a name="IDX1527"></a>
<p> You can disable a command either by editing the init file
@@ -2172,6 +2189,7 @@
<table><tr><td> </td><td><pre class="example">(setq c-tab-always-indent
nil)
</pre></td></tr></table>
+
<p>Here we have a variable whose value is normally <code>t</code> for `true'
and the alternative is <code>nil</code> for `false'.
</p>
@@ -2181,6 +2199,7 @@
<table><tr><td> </td><td><pre class="example">(setq-default
case-fold-search nil)
</pre></td></tr></table>
+
<p>This sets the default value, which is effective in all buffers that do
not have local values for the variable. Setting <code>case-fold-search</code>
with <code>setq</code> affects only the current buffer's local value, which
@@ -2191,6 +2210,7 @@
<table><tr><td> </td><td><pre class="example">(setq default-major-mode
'text-mode)
</pre></td></tr></table>
+
<p>Note that <code>text-mode</code> is used because it is the command for
entering
the mode we want. A single-quote is written before it to make a symbol
constant; otherwise, <code>text-mode</code> would be treated as a variable
name.
@@ -2201,6 +2221,7 @@
<table><tr><td> </td><td><pre class="example">(setq text-mode-hook
'(lambda () (auto-fill-mode 1)))
</pre></td></tr></table>
+
<p>Here we have a variable whose value should be a Lisp function. The
function we supply is a list starting with <code>lambda</code>, and a single
quote is written in front of it to make it (for the purpose of this
@@ -2212,6 +2233,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(setq text-mode-hook
'turn-on-auto-fill)
</pre></td></tr></table>
+
<p>This is another way to accomplish the same result.
<code>turn-on-auto-fill</code> is a symbol whose function definition is
<code>(lambda () (auto-fill-mode 1))</code>.
@@ -2222,6 +2244,7 @@
<table><tr><td> </td><td><pre class="example">(load "foo")
</pre></td></tr></table>
+
<p>When the argument to <code>load</code> is a relative pathname, not starting
with <samp>`/'</samp> or <samp>`~'</samp>, <code>load</code> searches the
directories in
<code>load-path</code> (see section <a href="xemacs_25.html#SEC255">Loading
Libraries</a>).
@@ -2231,6 +2254,7 @@
<table><tr><td> </td><td><pre class="example">(load "~/foo.elc")
</pre></td></tr></table>
+
<p>Here an absolute file name is used, so no searching is done.
</p>
</li><li>
@@ -2238,10 +2262,12 @@
<table><tr><td> </td><td><pre class="example">(global-set-key
"\C-xl" 'make-symbolic-link)
</pre></td></tr></table>
+
<p>or
</p>
<table><tr><td> </td><td><pre class="example">(define-key global-map
"\C-xl" 'make-symbolic-link)
</pre></td></tr></table>
+
<p>Note once again the single-quote used to refer to the symbol
<code>make-symbolic-link</code> instead of its value as a variable.
</p>
@@ -2250,17 +2276,20 @@
<table><tr><td> </td><td><pre class="example">(define-key c-mode-map
"\C-xl" 'make-symbolic-link)
</pre></td></tr></table>
+
</li><li>
Bind the function key <kbd>F1</kbd> to a command in C mode.
Note that the names of function keys must be lower case.
<table><tr><td> </td><td><pre class="example">(define-key c-mode-map 'f1
'make-symbolic-link)
</pre></td></tr></table>
+
</li><li>
Bind the shifted version of <kbd>F1</kbd> to a command.
<table><tr><td> </td><td><pre class="example">(define-key c-mode-map
'(shift f1) 'make-symbolic-link)
</pre></td></tr></table>
+
</li><li>
Redefine all keys which now run <code>next-line</code> in Fundamental mode
to run <code>forward-line</code> instead.
@@ -2268,11 +2297,13 @@
<table><tr><td> </td><td><pre class="example">(substitute-key-definition
'next-line 'forward-line
global-map)
</pre></td></tr></table>
+
</li><li>
Make <kbd>C-x C-v</kbd> undefined.
<table><tr><td> </td><td><pre class="example">(global-unset-key
"\C-x\C-v")
</pre></td></tr></table>
+
<p>One reason to undefine a key is so that you can make it a prefix.
Simply defining <kbd>C-x C-v <var>anything</var></kbd> would make <kbd>C-x
C-v</kbd>
a prefix, but <kbd>C-x C-v</kbd> must be freed of any non-prefix definition
@@ -2284,11 +2315,13 @@
<table><tr><td> </td><td><pre class="example">(modify-syntax-entry ?\$
"." text-mode-syntax-table)
</pre></td></tr></table>
+
</li><li>
Enable the use of the command <code>eval-expression</code> without
confirmation.
<table><tr><td> </td><td><pre class="example">(put 'eval-expression
'disabled nil)
-</pre></td></tr></table></li></ul>
+</pre></td></tr></table>
+</li></ul>
<hr size="6">
<a name="Terminal-Init"></a>
@@ -2406,6 +2439,7 @@
<table><tr><td> </td><td><pre class="example">( <var>sound-name</var> .
<var><sound></var> )
( <var>sound-name</var> <var><volume></var> <var><sound></var> )
</pre></td></tr></table>
+
<p>You should probably add things to this list by calling the function
<code>load-sound-file</code>.
</p>
@@ -3201,6 +3235,7 @@
fixed
9x13
</pre></td></tr></table>
+
<p>then XEmacs won't be able to guess the names of the bold and italic
versions. All X fonts can be referred to via XLFD-style names, so you
should use those forms. See the man pages for <samp>`X(1)'</samp>,
@@ -3239,6 +3274,7 @@
<table><tr><td> </td><td><pre class="example">INVOCATION-NAME
"shell" "container" FRAME-NAME
x-emacs-application-class "EmacsShell" "EmacsManager"
"EmacsFrame"
</pre></td></tr></table>
+
<p>where INVOCATION-NAME is the terminal component of the name of the
XEmacs executable (usually <samp>`xemacs'</samp>), and
<samp>`x-emacs-application-class'</samp> is generally <samp>`Emacs'</samp>.
@@ -3274,12 +3310,14 @@
</p>
<table><tr><td> </td><td><pre class="example">Emacs*menubar*font:
*-courier-medium-r-*-*-*-120-*-*-*-*-*-*
</pre></td></tr></table>
+
<p>If both the Lucid Motif-lookalike menu widgets and X Font Sets are
configured to allow multilingual menubars, then one uses
</p>
<table><tr><td> </td><td><pre class="example">*menubar*FontSet:
-*-helvetica-bold-r-*-*-*-120-*-*-*-*-iso8859-*, \
-*-*-*-*-*-*-*-120-*-jisx0208.1983-0
</pre></td></tr></table>
+
<p>That would specify fonts for a Japanese menubar. Specifying only one
XLFD is acceptable; specifying more than one for a given registry
(language) is also allowed. When X Font Sets are configured, some .font
@@ -3290,6 +3328,7 @@
</p>
<table><tr><td> </td><td><pre class="example">Emacs*menubar*fontList:
*-courier-medium-r-*-*-*-120-*-*-*-*-*-*
</pre></td></tr></table>
+
<p>because the Motif library uses the <code>fontList</code> resource name
instead
of <code>font</code>, which has subtly different semantics.
</p>
@@ -3866,6 +3905,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(open-termscript
"~/termscript")
</pre></td></tr></table>
+
<p>using <kbd>Meta-<kbd>ESC</kbd></kbd> or from the <samp>`*scratch*'</samp>
buffer
just after starting Emacs. From then on, all output from Emacs to the
terminal will be written in the specified termscript file as well, until
Index: texi2html/Tests/xemacs_frame_res/xemacs_4.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_4.html:1.22
texi2html/Tests/xemacs_frame_res/xemacs_4.html:1.23
--- texi2html/Tests/xemacs_frame_res/xemacs_4.html:1.22 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_4.html Sat Mar 25 13:26:48 2006
@@ -779,6 +779,7 @@
</p>
<table><tr><td> </td><td><pre class="example"> (setq default-frame-plist
'(width 80 height 55))
</pre></td></tr></table>
+
<p>This variable has replaced <code>default-frame-alist</code>, which is
considered obsolete.
</p>
Index: texi2html/Tests/xemacs_frame_res/xemacs_5.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_5.html:1.22
texi2html/Tests/xemacs_frame_res/xemacs_5.html:1.23
--- texi2html/Tests/xemacs_frame_res/xemacs_5.html:1.22 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_5.html Sat Mar 25 13:26:48 2006
@@ -269,6 +269,7 @@
</p>
<table><tr><td> </td><td><pre class="example"> [(modifier .. modifier
keysym) ... (modifier .. modifier keysym)]
</pre></td></tr></table>
+
<p> Here are some examples of complete key sequences:
</p>
<dl compact="compact">
@@ -457,6 +458,7 @@
keysym Caps_Lock = Super_L
add Mod2 = Super_L
</pre></td></tr></table>
+
<p>The first line says that the key that is currently called
<code>Caps_Lock</code>
should no longer behave as a “lock” key. The second line says that
this should now be called <code>Super_L</code> instead. The third line says
that
@@ -1406,6 +1408,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(add-menu-item
'("File") "Rename File" 'rename-file t)
</pre></td></tr></table>
+
<p>To add a submenu of file management commands using a <b>File Management</b>
item, use the following code:
</p>
@@ -1413,6 +1416,7 @@
(add-menu-item '("File" "File Management") "Delete
File" 'delete-file t)
(add-menu-item '("File" "File Management") "Rename
File" 'rename-file t)
</pre></td></tr></table>
+
<p>The optional <var>before</var> argument is the name of a menu item before
which the new item should be added. If the item is already present, it
is not moved.
Index: texi2html/Tests/xemacs_frame_res/xemacs_6.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_6.html:1.22
texi2html/Tests/xemacs_frame_res/xemacs_6.html:1.23
--- texi2html/Tests/xemacs_frame_res/xemacs_6.html:1.22 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_6.html Sat Mar 25 13:26:48 2006
@@ -363,6 +363,7 @@
<table><tr><td> </td><td><pre class="example">% xemacs -version
XEmacs 19.13 of Mon Aug 21 1995 on willow (usg-unix-v) [formerly Lucid Emacs]
</pre></td></tr></table>
+
</dd>
<dt> <samp>`-help'</samp></dt>
<dd><p>Prints a summary of command-line options and then exits.
Index: texi2html/Tests/xemacs_frame_res/xemacs_7.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_7.html:1.20
texi2html/Tests/xemacs_frame_res/xemacs_7.html:1.21
--- texi2html/Tests/xemacs_frame_res/xemacs_7.html:1.20 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_7.html Sat Mar 25 13:26:48 2006
@@ -178,7 +178,6 @@
overwriting with it.)
</li></ul>
-
<p>A numeric argument to <kbd>C-q</kbd> specifies how many copies of the quoted
character should be inserted (see section <a href="#SEC58">Numeric
Arguments</a>).
</p>
@@ -744,6 +743,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">point=563026 of
563025(100%) column 0
</pre></td></tr></table>
+
<hr size="6">
<a name="Arguments"></a>
<a name="SEC58"></a>
Index: texi2html/Tests/xemacs_frame_res/xemacs_9.html
diff -u texi2html/Tests/xemacs_frame_res/xemacs_9.html:1.19
texi2html/Tests/xemacs_frame_res/xemacs_9.html:1.20
--- texi2html/Tests/xemacs_frame_res/xemacs_9.html:1.19 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_frame_res/xemacs_9.html Sat Mar 25 13:26:48 2006
@@ -247,7 +247,8 @@
you typed. For example, if you attempted to visit a non-existent file,
the minibuffer might read:
</p><table><tr><td> </td><td><pre class="example"> Find File:
chocolate_bar.c [no completions, confirm]
-</pre></td></tr></table><p>If you press <kbd>Return</kbd> again, that confirms
the filename. Otherwise,
+</pre></td></tr></table>
+<p>If you press <kbd>Return</kbd> again, that confirms the filename. Otherwise,
you can continue editing it.
</p>
<p> XEmacs supports recursive use of the minibuffer. However, it is easy
Index: texi2html/Tests/xemacs_res/xemacs_1.html
diff -u texi2html/Tests/xemacs_res/xemacs_1.html:1.22
texi2html/Tests/xemacs_res/xemacs_1.html:1.23
--- texi2html/Tests/xemacs_res/xemacs_1.html:1.22 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_res/xemacs_1.html Sat Mar 25 13:26:48 2006
@@ -69,6 +69,7 @@
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
</pre></td></tr></table>
+
<hr size="6">
<a name="SEC2"></a>
<table cellpadding="1" cellspacing="1" border="0">
@@ -343,6 +344,7 @@
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
</pre></td></tr></table>
+
<p>Also add information on how to contact you by electronic and paper mail.
</p>
<p>If the program is interactive, make it output a short notice like this
@@ -353,6 +355,7 @@
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
</pre></td></tr></table>
+
<p>The hypothetical commands `show w' and `show c' should show the
appropriate parts of the General Public License. Of course, the
commands you use may be called something other than `show w' and `show
@@ -371,6 +374,7 @@
<var>signature of Ty Coon</var>, 1 April 1989
Ty Coon, President of Vice
</pre></td></tr></table>
+
<p>That's all there is to it!
</p>
<hr size="6">
Index: texi2html/Tests/xemacs_res/xemacs_10.html
diff -u texi2html/Tests/xemacs_res/xemacs_10.html:1.20
texi2html/Tests/xemacs_res/xemacs_10.html:1.21
--- texi2html/Tests/xemacs_res/xemacs_10.html:1.20 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_res/xemacs_10.html Sat Mar 25 13:26:48 2006
@@ -89,7 +89,8 @@
invoke the command <code>forward-char</code>, type:
</p>
<table><tr><td> </td><td><pre class="example">M-x forward-char
<kbd>RET</kbd>
-</pre></td></tr></table><p>or
+</pre></td></tr></table>
+<p>or
</p><table><tr><td> </td><td><pre class="example">M-x fo <kbd>TAB</kbd> c
<kbd>RET</kbd>
</pre></td></tr></table>
@@ -113,6 +114,7 @@
</p>
<table><tr><td> </td><td><pre class="example"> (defun foo (arg)
"Doc string" (interactive "p") ...use arg...)
</pre></td></tr></table>
+
<p>to make <code>arg</code> be the prefix argument when <code>foo</code> is
called as a
command. The call to <code>interactive</code> is actually a declaration
rather than a function; it tells <code>call-interactively</code> how to read
Index: texi2html/Tests/xemacs_res/xemacs_11.html
diff -u texi2html/Tests/xemacs_res/xemacs_11.html:1.24
texi2html/Tests/xemacs_res/xemacs_11.html:1.25
--- texi2html/Tests/xemacs_res/xemacs_11.html:1.24 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_res/xemacs_11.html Sat Mar 25 13:26:48 2006
@@ -486,6 +486,7 @@
vms support code for vms
wp word processing
</pre></td></tr></table>
+
<hr size="6">
<a name="Help-Mode"></a>
<a name="SEC77"></a>
Index: texi2html/Tests/xemacs_res/xemacs_12.html
diff -u texi2html/Tests/xemacs_res/xemacs_12.html:1.26
texi2html/Tests/xemacs_res/xemacs_12.html:1.27
--- texi2html/Tests/xemacs_res/xemacs_12.html:1.26 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_res/xemacs_12.html Sat Mar 25 13:26:48 2006
@@ -498,6 +498,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(global-set-key '(shift
button1) 'mouse-del-char)
</pre></td></tr></table>
+
<a name="IDX310"></a>
<a name="IDX311"></a>
<a name="IDX312"></a>
Index: texi2html/Tests/xemacs_res/xemacs_15.html
diff -u texi2html/Tests/xemacs_res/xemacs_15.html:1.28
texi2html/Tests/xemacs_res/xemacs_15.html:1.29
--- texi2html/Tests/xemacs_res/xemacs_15.html:1.28 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_res/xemacs_15.html Sat Mar 25 13:26:48 2006
@@ -244,6 +244,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(define-key
isearch-mode-map "\C-b" 'isearch-repeat-backward)
</pre></td></tr></table>
+
<p>These are the default bindings of isearch-mode:
</p>
<a name="IDX412"></a>
Index: texi2html/Tests/xemacs_res/xemacs_17.html
diff -u texi2html/Tests/xemacs_res/xemacs_17.html:1.25
texi2html/Tests/xemacs_res/xemacs_17.html:1.26
--- texi2html/Tests/xemacs_res/xemacs_17.html:1.25 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_res/xemacs_17.html Sat Mar 25 13:26:48 2006
@@ -465,6 +465,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(No changes need to be
saved)
</pre></td></tr></table>
+
<a name="IDX561"></a>
<a name="IDX562"></a>
<p> The command <kbd>C-x s</kbd> (<code>save-some-buffers</code>) can save
any or all
@@ -650,7 +651,6 @@
</p></dd>
</dl>
-
<p><code>version-control</code> may be set locally in an individual buffer to
control the making of backups for that buffer's file. For example,
Rmail mode locally sets <code>version-control</code> to <code>never</code> to
make sure
@@ -1092,6 +1092,7 @@
<table><tr><td> </td><td><pre class="example">M-x recover-file
<kbd>RET</kbd> foo.c <kbd>RET</kbd>
C-x C-s
</pre></td></tr></table>
+
<p> Before asking for confirmation, <kbd>M-x recover-file</kbd> displays a
directory listing describing the specified file and the auto-save file,
so you can compare their sizes and dates. If the auto-save file
@@ -1273,7 +1274,6 @@
</p></dd>
</dl>
-
<p>(<kbd>C-x v</kbd> is the prefix key for version control commands; all of
these
commands except for <kbd>C-x C-q</kbd> start with <kbd>C-x v</kbd>.)
</p>
@@ -1541,6 +1541,7 @@
* vc.el (vc-do-command): Check call-process status.
</pre></td></tr></table>
+
<p> When <kbd>C-x v a</kbd> adds several change log entries at once, it groups
related log entries together if they all are checked in by the same
author at nearly the same time. If the log entries for several such
@@ -1555,6 +1556,7 @@
For <tt>`vc-hooks.el'</tt>:
Don't call expand-file-name.
</pre></td></tr></table>
+
<p> They appear like this in <tt>`ChangeLog'</tt>:
</p>
<table><tr><td> </td><td><pre class="smallexample">Wed Apr 1 08:57:59
1992 Nathaniel Bowditch (address@hidden)
@@ -1563,6 +1565,7 @@
* vc.el, vc-hooks.el: Don't call expand-file-name.
</pre></td></tr></table>
+
<p> Normally, <kbd>C-x v a</kbd> separates log entries by a blank line, but
you
can mark several related log entries to be clumped together (without an
intervening blank line) by starting the text of each related log entry
@@ -1585,6 +1588,7 @@
* vc.texinfo: Fix expansion typos.
* vc.el, vc-hooks.el: Don't call expand-file-name.
</pre></td></tr></table>
+
<p> A log entry whose text begins with <samp>`#'</samp> is not copied to
<tt>`ChangeLog'</tt>. For example, if you merely fix some misspellings in
comments, you can log the change with an entry beginning with <samp>`#'</samp>
@@ -1975,6 +1979,7 @@
static char vcid[] = "<var>string</var>";
#endif /* lint */
</pre></td></tr></table>
+
<hr size="6">
<a name="ListDir"></a>
<a name="SEC161"></a>
@@ -2025,6 +2030,7 @@
</p>
<table><tr><td> </td><td><pre class="example">C-x C-d /u2/emacs/src/*.c
<kbd>RET</kbd>
</pre></td></tr></table>
+
<p> Normally, <kbd>C-x C-d</kbd> prints a brief directory listing containing
just
file names. A numeric argument (regardless of value) tells it to print a
verbose listing (like <code>ls -l</code>).
Index: texi2html/Tests/xemacs_res/xemacs_20.html
diff -u texi2html/Tests/xemacs_res/xemacs_20.html:1.26
texi2html/Tests/xemacs_res/xemacs_20.html:1.27
--- texi2html/Tests/xemacs_res/xemacs_20.html:1.26 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_res/xemacs_20.html Sat Mar 25 13:26:48 2006
@@ -468,6 +468,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(set-charset-registry
'cyrillic-iso8859-5 "koi8-r")
</pre></td></tr></table>
+
<p>(Please note that you probably also want to set font registry for
<samp>`ascii'</samp> charset so that mixed English/Cyrillic texts be displayed
using the same font.)
@@ -488,6 +489,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(set-charset-ccl-program
'cyrillic-iso8859-5 'ccl-encode-koi8-r-font)
</pre></td></tr></table>
+
<p>There are several more uses for CCL programs, not related to fonts, but
those uses are not described here.
</p>
Index: texi2html/Tests/xemacs_res/xemacs_22.html
diff -u texi2html/Tests/xemacs_res/xemacs_22.html:1.22
texi2html/Tests/xemacs_res/xemacs_22.html:1.23
--- texi2html/Tests/xemacs_res/xemacs_22.html:1.22 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_res/xemacs_22.html Sat Mar 25 13:26:48 2006
@@ -260,6 +260,7 @@
0123456789012345678901234567890123456789012345678
To install changes, type C-c C-c
</pre></td></tr></table>
+
<p> The first line contains a colon at each tab stop. The remaining lines
help you see where the colons are and tell you what to do.
</p>
Index: texi2html/Tests/xemacs_res/xemacs_23.html
diff -u texi2html/Tests/xemacs_res/xemacs_23.html:1.25
texi2html/Tests/xemacs_res/xemacs_23.html:1.26
--- texi2html/Tests/xemacs_res/xemacs_23.html:1.25 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_res/xemacs_23.html Sat Mar 25 13:26:48 2006
@@ -633,6 +633,7 @@
A second first-level topic with its header line.
</pre></td></tr></table>
+
<p> A heading line together with all following body lines is called
collectively an <em>entry</em>. A heading line together with all following
deeper heading lines and their body lines is called a <em>subtree</em>.
Index: texi2html/Tests/xemacs_res/xemacs_24.html
diff -u texi2html/Tests/xemacs_res/xemacs_24.html:1.27
texi2html/Tests/xemacs_res/xemacs_24.html:1.28
--- texi2html/Tests/xemacs_res/xemacs_24.html:1.27 Tue Aug 23 23:51:17 2005
+++ texi2html/Tests/xemacs_res/xemacs_24.html Sat Mar 25 13:26:48 2006
@@ -706,7 +706,6 @@
<dd><p>The position at which the line being indented begins.
</p></dd>
</dl>
-
<p>It should return either a number, which is the number of columns of
indentation for that line, or a list whose first element is such a
number. The difference between returning a number and returning a list
@@ -822,6 +821,7 @@
do_it ();
}
</pre></td></tr></table>
+
<p> When <code>c-indent-level</code> is zero, the statements inside most
braces
line up exactly under the open brace. An exception are braces in column
zero, like those surrounding a function's body. The statements inside
@@ -866,6 +866,7 @@
<table><tr><td> </td><td><pre class="example">if (x == y)
{
</pre></td></tr></table>
+
<a name="IDX946"></a>
<p> <code>c-argdecl-indent</code> controls the indentation of declarations of
the
arguments of a C function. It is absolute: argument declarations receive
@@ -877,6 +878,7 @@
char *string;
int char;
</pre></td></tr></table>
+
<a name="IDX947"></a>
<p> <code>c-label-offset</code> is the extra indentation given to a line that
contains a label, a case statement, or a <code>default:</code> statement. Its
@@ -1021,6 +1023,7 @@
;; The following line adds one.
(1+ x)) ; This line adds one.
</pre></td></tr></table>
+
<p> In C code, a comment preceded on its line by nothing but whitespace
is indented like a line of code.
</p>
@@ -1343,6 +1346,7 @@
(case where line is killed, point is at eob and that line is
not displayed), set it again in final compute_motion.
</pre></td></tr></table>
+
<hr size="6">
<a name="Tags"></a>
<a name="SEC232"></a>
@@ -1665,6 +1669,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">find . -name
"*.[chCH]" -print | etags -
</pre></td></tr></table>
+
<p> Use the option <samp>`--language=<var>name</var>'</samp> to specify the
language
explicitly. You can intermix these options with file names; each one
applies to the file names that follow it. Specify
@@ -1787,6 +1792,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">etags address@hidden
*.[ch] */*.[ch]
</pre></td></tr></table>
+
<p> Here are some more examples. The regexps are quoted to protect them
from shell interpretation.
</p>
@@ -1810,6 +1816,7 @@
<table><tr><td> </td><td><pre class="smallexample">etags --language=none
--regex='/proc[ \t]+\([^ \t]+\)/\1/' *.tcl
</pre></td></tr></table>
+
</li><li>
Tag VHDL files:
@@ -1817,7 +1824,8 @@
--regex='/[ \t]*\(ARCHITECTURE\|CONFIGURATION\) +[^ ]* +OF/' \
--regex='/[ \t]*\(ATTRIBUTE\|ENTITY\|FUNCTION\|PACKAGE\
\( BODY\)?\|PROCEDURE\|PROCESS\|TYPE\)[ \t]+\([^ \t(]+\)/\3/'
-</pre></td></tr></table></li></ul>
+</pre></td></tr></table>
+</li></ul>
<hr size="6">
<a name="Select-Tags-Table"></a>
@@ -1873,6 +1881,7 @@
("" . "/usr/local/emacs/src/")
))
</pre></td></tr></table>
+
<p>The example defines the tags table alist in the following way:
</p>
<ul>
@@ -2459,7 +2468,6 @@
By default, this character is <samp>`$'</samp>.
</li></ul>
-
<p>If you fail to follow these conventions, the indentation commands may
indent some lines unaesthetically. However, a correct Fortran program will
retain its meaning when reindented even if the conventions are not
Index: texi2html/Tests/xemacs_res/xemacs_25.html
diff -u texi2html/Tests/xemacs_res/xemacs_25.html:1.29
texi2html/Tests/xemacs_res/xemacs_25.html:1.30
--- texi2html/Tests/xemacs_res/xemacs_25.html:1.29 Tue Aug 23 23:51:18 2005
+++ texi2html/Tests/xemacs_res/xemacs_25.html Sat Mar 25 13:26:48 2006
@@ -207,6 +207,7 @@
</p>
<table><tr><td> </td><td><pre class="example">if ($?prompt) set prompt =
...
</pre></td></tr></table>
+
<hr size="6">
<a name="Lisp-Modes"></a>
<a name="SEC253"></a>
@@ -494,6 +495,7 @@
</p>
<table><tr><td> </td><td><pre class="example">emacs -batch -f
batch-byte-compile <var>files</var>...
</pre></td></tr></table>
+
<p> Directory names may also be given as arguments; in that case,
<code>byte-recompile-directory</code> is invoked on each such directory.
<code>batch-byte-compile</code> uses all remaining command-line arguments as
@@ -1098,10 +1100,12 @@
</p>
<table><tr><td> </td><td><pre class="example"> Tools ->
Packages -> List and Install
</pre></td></tr></table>
+
<p>Or, you can get to it via the keyboard:
</p>
<table><tr><td> </td><td><pre class="example">M-x pui-list-packages
</pre></td></tr></table>
+
<p>Hint to system administrators of multi-user systems: it might be a good
idea to install all packages and not interfere with the wishes of your
users.
@@ -1112,6 +1116,7 @@
</p>
<table><tr><td> </td><td><pre class="example">M-x
package-get-package-provider RET thingatpt
</pre></td></tr></table>
+
<p>which will return something like (fsf-compat "1.08"). You can the
use
one of the methods above for installing the package you want.
</p>
@@ -1199,6 +1204,7 @@
tar zxvf /path/to/xemacs-base-1.48-pkg.tar.gz RET
</pre></td></tr></table>
+
<p>For MULE related packages, it is best to untar into the mule-packages
hierarchy, i.e. for the <tt>`mule-base'</tt> package, version 1.37:
</p>
@@ -1210,6 +1216,7 @@
tar zxvf /path/to/mule-base-1.37-pkg.tar.gz RET
</pre></td></tr></table>
+
<a name="Automatically"></a>
<a name="SEC274"></a>
<h2 class="heading"> Automatic Package Installation: </h2>
@@ -1229,6 +1236,7 @@
mule-base - Needed if you want to use XEmacs with MULE.
</pre></td></tr></table>
+
<p>After installing these by hand, fire up XEmacs and follow these
steps.
</p>
@@ -1344,6 +1352,7 @@
</p>
<table><tr><td> </td><td><pre class="example">M-x package-get-all
<return>
</pre></td></tr></table>
+
<p>Enter the name of the package (e.g., <code>prog-modes</code>), and XEmacs
will search for the latest version and install it and any packages that
it depends upon.
@@ -1534,6 +1543,7 @@
want to install. eg:
</p><table><tr><td> </td><td><pre class="example"> XEMACS_PACKAGES =
xemacs-packages/xemacs-base xemacs-packages/bbdb
</pre></td></tr></table>
+
</dd>
<dt> <var>XEMACS_STAGING = ${XEMACS_PACKAGES_BASE}/../Packages</var></dt>
<dd><p>Set this to where you want normal packages to be
@@ -1555,6 +1565,7 @@
packages you want to install here. eg:
</p><table><tr><td> </td><td><pre class="example"> MULE_PACKAGES =
mule-packages/mule-base mule-packages/skk
</pre></td></tr></table>
+
</dd>
<dt> <var>MULE_STAGING = ${XEMACS_PACKAGES_BASE}/../Mule-Packages</var></dt>
<dd><p>Set this to where you want Mule packages installed
@@ -1619,6 +1630,7 @@
type regular
))
</pre></td></tr></table>
+
<p>You must fill in the four commented lines. The value of <code>name</code>
is
the name of your package as an unquoted symbol. Normally it is the name
of the main Lisp file or principal feature provided. The allowed values
@@ -1670,6 +1682,7 @@
<p>The include is simply
</p><table><tr><td> </td><td><pre class="example">include
../../XEmacs.rules
</pre></td></tr></table>
+
<p>The standard targets follow. These are
</p>
<table><tr><td> </td><td><pre class="example">all:: $(ELCS)
auto-autoloads.elc
@@ -1678,6 +1691,7 @@
binkit: binkit-alias
</pre></td></tr></table>
+
<p>Other targets (such as Texinfo sources) may need to be added as
dependencies for the <code>all</code> target. Dependencies for
<code>srckit</code>
and <code>binkit</code> (that is, values for <var>srckit-alias</var> and
Index: texi2html/Tests/xemacs_res/xemacs_28.html
diff -u texi2html/Tests/xemacs_res/xemacs_28.html:1.22
texi2html/Tests/xemacs_res/xemacs_28.html:1.23
--- texi2html/Tests/xemacs_res/xemacs_28.html:1.22 Tue Aug 23 23:51:18 2005
+++ texi2html/Tests/xemacs_res/xemacs_28.html Sat Mar 25 13:26:48 2006
@@ -143,8 +143,8 @@
</p>
<table><tr><td> </td><td><pre class="example">--text follows this line--
</pre></td></tr></table>
-<a name="IDX1117"></a>
+<a name="IDX1117"></a>
<p>is a special delimiter that separates the headers you have specified from
the text. Whatever follows this line is the text of the message; the
headers precede it. The delimiter line itself does not appear in the
@@ -160,6 +160,7 @@
--Text follows this line--
Please ignore this message.
</pre></td></tr></table>
+
<hr size="6">
<a name="Mail-Headers"></a>
<a name="SEC298"></a>
@@ -240,11 +241,9 @@
</p></dd>
</dl>
-
<p>The <samp>`To'</samp>, <samp>`CC'</samp>, <samp>`BCC'</samp> and
<samp>`FCC'</samp> fields can appear
any number of times, to specify many places to send the message.
</p>
-
<p>The <samp>`To'</samp>, <samp>`CC'</samp>, and <samp>`BCC'</samp>, fields
can have continuation
lines. All the lines starting with whitespace, following the line on
which the field starts, are considered part of the field. For
@@ -302,6 +301,7 @@
</p>
<table><tr><td> </td><td><pre class="example"> alias someone
"John Doe <address@hidden>"
</pre></td></tr></table>
+
<p>That is, if you want an address to have embedded spaces, simply surround
it with double-quotes. The quotes are necessary because the format of
the <tt>`.mailrc'</tt> file uses spaces as address delimiters.
@@ -312,9 +312,11 @@
alias group2 larry curly moe
alias everybody group1 group2
</pre></td></tr></table>
+
<p>When you now type <samp>`everybody'</samp> on the <samp>`To'</samp> line,
it will expand to:
</p><table><tr><td> </td><td><pre class="example"> fred, ethyl,
larry, curly, moe
</pre></td></tr></table>
+
<p>Aliases may contain forward references; the alias of
<samp>`everybody'</samp> in the
example above can precede the aliases of <samp>`group1'</samp> and
<samp>`group2'</samp>.
</p>
Index: texi2html/Tests/xemacs_res/xemacs_29.html
diff -u texi2html/Tests/xemacs_res/xemacs_29.html:1.27
texi2html/Tests/xemacs_res/xemacs_29.html:1.28
--- texi2html/Tests/xemacs_res/xemacs_29.html:1.27 Tue Aug 23 23:51:18 2005
+++ texi2html/Tests/xemacs_res/xemacs_29.html Sat Mar 25 13:26:48 2006
@@ -1361,9 +1361,9 @@
<table><tr><td> </td><td><pre class="display">1 kin = 1
day 1 uinal = 20 kin 1 tun = 18 uinal
1 katun = 20 tun 1 baktun = 20 katun
</pre></td></tr></table>
+
<a name="IDX1266"></a>
<a name="IDX1267"></a>
-
<p>Thus, the long count date 12.16.11.16.6 means 12 baktun, 16 katun, 11
tun, 16 uinal, and 6 kin. The Emacs calendar can handle Mayan long
count dates as early as 7.17.18.13.1, but no earlier. When you use the
@@ -1697,6 +1697,7 @@
*/25 Monthly cycle finishes
Friday Don't leave without backing up files
</pre></td></tr></table>
+
<p> The first entry appears only once, on April 20, 1993. The second and
third appear every year on the specified dates, and the fourth uses a
wildcard (asterisk) for the month, so it appears on the 25th of every
@@ -2113,7 +2114,6 @@
terminal.
</p>
<a name="IDX1320"></a>
-
<p> A similar normal hook, <code>today-invisible-calendar-hook</code> is run
if
the current date is <em>not</em> visible in the window.
</p>
@@ -2238,9 +2238,9 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">(setq other-holidays
'((holiday-fixed 7 14 "Bastille Day")))
</pre></td></tr></table>
+
<p>See section <a href="xemacs_30.html#SEC377">The Init File</a>.
</p>
-
<p>The holiday form <code>(holiday-fixed 7 14 "Bastille Day")</code>
specifies the
fourteenth day of the seventh month (July).
</p>
@@ -2296,6 +2296,7 @@
(list 11 1 displayed-year)))))))
"US Presidential Election"))
</pre></td></tr></table>
+
<p> Some holidays just don't fit into any of these forms because special
calculations are involved in their determination. In such cases you
must write a Lisp function to do the calculation. To include eclipses,
@@ -2306,6 +2307,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">(((6 27 1991)
"Lunar Eclipse") ((7 11 1991) "Solar Eclipse") ... )
</pre></td></tr></table>
+
<hr size="6">
<a name="Date-Display-Format"></a>
<a name="SEC327"></a>
@@ -2342,8 +2344,8 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">((if dayname (concat
dayname ", ")) day " " monthname " " year)
</pre></td></tr></table>
-<p>+
-The ISO standard date representation is this:
+
+<p>+The ISO standard date representation is this:
</p>
<table><tr><td> </td><td><pre class="smallexample">(year "-"
month "-" day)
</pre></td></tr></table>
@@ -2352,6 +2354,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">(month "/"
day "/" (substring year -2))
</pre></td></tr></table>
+
<hr size="6">
<a name="Time-Display-Format"></a>
<a name="SEC328"></a>
@@ -2462,6 +2465,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(list 10 1 year)
</pre></td></tr></table>
+
<p> For a more complex example, suppose daylight savings time begins on
the first of Nisan on the Hebrew calendar. You should set
<code>calendar-daylight-savings-starts</code> to this value:
@@ -2649,6 +2653,7 @@
<table><tr><td> </td><td><pre class="smallexample">(add-hook
'nongregorian-diary-listing-hook 'list-islamic-diary-entries)
(add-hook 'nongregorian-diary-marking-hook 'mark-islamic-diary-entries)
</pre></td></tr></table>
+
<p> Hebrew- and Islamic-date diary entries have the same formats as
Gregorian-date diary entries, except that <samp>`H'</samp> precedes a Hebrew
date and <samp>`I'</samp> precedes an Islamic date. Moreover, because the
@@ -2778,9 +2783,9 @@
<a name="IDX1352"></a>
<table><tr><td> </td><td><pre class="example">(add-hook
'list-diary-entries-hook 'sort-diary-entries t)
</pre></td></tr></table>
+
<p>See section <a href="xemacs_30.html#SEC377">The Init File</a>.
</p>
-
<p>For each day, this sorts diary entries that begin with a recognizable
time of day according to their times. Diary entries without times come
first within each day.
@@ -2826,6 +2831,7 @@
<table><tr><td> </td><td><pre class="smallexample">(add-hook
'list-diary-entries-hook 'include-other-diary-files)
(add-hook 'mark-diary-entries-hook 'mark-included-diary-files)
</pre></td></tr></table>
+
<p>The include mechanism works only with the fancy diary display, because
ordinary diary display shows the entries directly from your diary file.
</p>
@@ -2876,6 +2882,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">Arthur's 42nd birthday
</pre></td></tr></table>
+
<p> Similarly, cyclic diary entries can interpolate the number of repetitions
that have occurred:
</p>
@@ -2964,7 +2971,6 @@
</p></dd>
</dl>
-
<p>Thus including the diary entry
</p>
<table><tr><td> </td><td><pre
class="smallexample">&%%(diary-hebrew-date)
@@ -4089,6 +4095,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(viper-mode)
</pre></td></tr></table>
+
<p>in your init file. See section <a href="xemacs_30.html#SEC377">The Init
File</a>.
</p>
<p>Viper comes with a separate manual that is provided standard
Index: texi2html/Tests/xemacs_res/xemacs_30.html
diff -u texi2html/Tests/xemacs_res/xemacs_30.html:1.29
texi2html/Tests/xemacs_res/xemacs_30.html:1.30
--- texi2html/Tests/xemacs_res/xemacs_30.html:1.29 Tue Aug 23 23:51:18 2005
+++ texi2html/Tests/xemacs_res/xemacs_30.html Sat Mar 25 13:26:48 2006
@@ -269,8 +269,8 @@
*Column beyond which automatic line-wrapping should happen.
Automatically becomes local when set in any fashion.
</pre></td></tr></table>
-<a name="IDX1475"></a>
+<a name="IDX1475"></a>
<p>The star at the beginning of the documentation indicates that this variable
is an option. <kbd>C-h v</kbd> is not restricted to options; it allows any
variable name.
@@ -448,6 +448,7 @@
[State]: this option is unchanged from its standard setting.
Maximum length of kill ring before oldest elements are thrown away.
</pre></td></tr></table>
+
<p> The text following <samp>`[Hide]'</samp>, <samp>`30'</samp> in this case,
indicates
the current value of the option. If you see <samp>`[Show]'</samp> instead of
<samp>`[Hide]'</samp>, it means that the value is hidden; the customization
@@ -475,6 +476,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">[State]: you have
edited the value as text, but not set the option.
</pre></td></tr></table>
+
<a name="IDX1480"></a>
<p> Editing the value does not actually set the option variable. To do
that, you must <em>set</em> the option. To do this, invoke the word
@@ -484,6 +486,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">[State]: you have set
this option, but not saved it for future sessions.
</pre></td></tr></table>
+
<p> You don't have to worry about specifying a value that is not valid;
setting the option checks for validity and will not really install an
unacceptable value.
@@ -634,6 +637,7 @@
[ ] Size:
[ ] Strikethru: off
</pre></td></tr></table>
+
<p> Each face attribute has its own line. The <samp>`[<var>x</var>]'</samp>
field
before the attribute name indicates whether the attribute is
<em>enabled</em>; <samp>`X'</samp> means that it is. You can enable or
disable the
@@ -785,6 +789,7 @@
Automatically becomes local when set in any fashion.
;;
</pre></td></tr></table>
+
<a name="IDX1495"></a>
<p> <kbd>M-x edit-options</kbd> goes one step further and immediately selects
the
<samp>`*List Options*'</samp> buffer; this buffer uses the major mode Options
mode,
@@ -914,6 +919,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(default-value 'fill-column)
</pre></td></tr></table>
+
<hr size="6">
<a name="File-Variables"></a>
<a name="SEC362"></a>
@@ -974,6 +980,7 @@
;;; comment-end:"***" ***
;;; End: ***
</pre></td></tr></table>
+
<p> Note that the prefix is <samp>`;;; '</samp> and the suffix is <samp>`
***'</samp>.
Note also that comments in the file begin with and end with the same
strings. Presumably the file contains code in a language which is
@@ -1009,11 +1016,13 @@
;;; -*- mode: postscript; version-control: never -*-
;;; -*- tags-file-name: "/foo/bar/TAGS" -*-
</pre></td></tr></table>
+
<p>For historical reasons, the syntax <code>`-*- modename -*-'</code> is
allowed
as well; for example, you can use:
</p>
<table><tr><td> </td><td><pre class="example"> ;;; -*- emacs-lisp
-*-
</pre></td></tr></table>
+
<a name="IDX1503"></a>
<p>The variable <code>enable-local-variables</code> controls the use of local
variables lists in files you visit. The value can be <code>t</code>,
@@ -1642,6 +1651,7 @@
</pre></td></tr></table>
+
<hr size="6">
<a name="Key-Bindings-Using-Strings"></a>
<a name="SEC372"></a>
@@ -1669,6 +1679,7 @@
<table><tr><td> </td><td><pre class="example">;;; Bind
<code>end-of-line</code> to <kbd>C-f</kbd>
(global-set-key "\C-f" 'end-of-line)
</pre></td></tr></table>
+
<p>Note, however, that in some cases you may be binding more than one
key sequence by using a single command. This situation can
arise because in ASCII, <kbd>C-i</kbd> and <kbd>TAB</kbd> have
@@ -1676,6 +1687,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(global-set-key
"\C-i" 'end-of-line)
</pre></td></tr></table>
+
<p>it is unclear whether the user intended to bind <kbd>C-i</kbd> or
<kbd>TAB</kbd>.
The solution XEmacs adopts is to bind both of these key
sequences.
@@ -1685,11 +1697,13 @@
</p>
<table><tr><td> </td><td><pre class="example"> (define-key
global-map "\^X\^I" 'command-1)
</pre></td></tr></table>
+
<p>it is possible to redefine only one of those sequences like so:
</p>
<table><tr><td> </td><td><pre class="example"> (define-key
global-map [(control x) (control i)] 'command-2)
(define-key global-map [(control x) tab] 'command-3)
</pre></td></tr></table>
+
<p>This applies only when running under a window system. If you are
talking to Emacs through an ASCII-only channel, you do not get any of
these features.
@@ -1705,6 +1719,7 @@
control [ escape
control @ control space
</pre></td></tr></table>
+
<hr size="6">
<a name="Disabling"></a>
<a name="SEC373"></a>
@@ -1737,6 +1752,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(put 'delete-region
'disabled t)
</pre></td></tr></table>
+
<p>See section <a href="#SEC377">The Init File</a>.
</p>
<p> If the value of the <code>disabled</code> property is a string, that
string
@@ -1745,6 +1761,7 @@
<table><tr><td> </td><td><pre class="example">(put 'delete-region
'disabled
"Text deleted this way cannot be yanked back!\n")
</pre></td></tr></table>
+
<a name="IDX1526"></a>
<a name="IDX1527"></a>
<p> You can disable a command either by editing the init file
@@ -2172,6 +2189,7 @@
<table><tr><td> </td><td><pre class="example">(setq c-tab-always-indent
nil)
</pre></td></tr></table>
+
<p>Here we have a variable whose value is normally <code>t</code> for `true'
and the alternative is <code>nil</code> for `false'.
</p>
@@ -2181,6 +2199,7 @@
<table><tr><td> </td><td><pre class="example">(setq-default
case-fold-search nil)
</pre></td></tr></table>
+
<p>This sets the default value, which is effective in all buffers that do
not have local values for the variable. Setting <code>case-fold-search</code>
with <code>setq</code> affects only the current buffer's local value, which
@@ -2191,6 +2210,7 @@
<table><tr><td> </td><td><pre class="example">(setq default-major-mode
'text-mode)
</pre></td></tr></table>
+
<p>Note that <code>text-mode</code> is used because it is the command for
entering
the mode we want. A single-quote is written before it to make a symbol
constant; otherwise, <code>text-mode</code> would be treated as a variable
name.
@@ -2201,6 +2221,7 @@
<table><tr><td> </td><td><pre class="example">(setq text-mode-hook
'(lambda () (auto-fill-mode 1)))
</pre></td></tr></table>
+
<p>Here we have a variable whose value should be a Lisp function. The
function we supply is a list starting with <code>lambda</code>, and a single
quote is written in front of it to make it (for the purpose of this
@@ -2212,6 +2233,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(setq text-mode-hook
'turn-on-auto-fill)
</pre></td></tr></table>
+
<p>This is another way to accomplish the same result.
<code>turn-on-auto-fill</code> is a symbol whose function definition is
<code>(lambda () (auto-fill-mode 1))</code>.
@@ -2222,6 +2244,7 @@
<table><tr><td> </td><td><pre class="example">(load "foo")
</pre></td></tr></table>
+
<p>When the argument to <code>load</code> is a relative pathname, not starting
with <samp>`/'</samp> or <samp>`~'</samp>, <code>load</code> searches the
directories in
<code>load-path</code> (see section <a href="xemacs_25.html#SEC255">Loading
Libraries</a>).
@@ -2231,6 +2254,7 @@
<table><tr><td> </td><td><pre class="example">(load "~/foo.elc")
</pre></td></tr></table>
+
<p>Here an absolute file name is used, so no searching is done.
</p>
</li><li>
@@ -2238,10 +2262,12 @@
<table><tr><td> </td><td><pre class="example">(global-set-key
"\C-xl" 'make-symbolic-link)
</pre></td></tr></table>
+
<p>or
</p>
<table><tr><td> </td><td><pre class="example">(define-key global-map
"\C-xl" 'make-symbolic-link)
</pre></td></tr></table>
+
<p>Note once again the single-quote used to refer to the symbol
<code>make-symbolic-link</code> instead of its value as a variable.
</p>
@@ -2250,17 +2276,20 @@
<table><tr><td> </td><td><pre class="example">(define-key c-mode-map
"\C-xl" 'make-symbolic-link)
</pre></td></tr></table>
+
</li><li>
Bind the function key <kbd>F1</kbd> to a command in C mode.
Note that the names of function keys must be lower case.
<table><tr><td> </td><td><pre class="example">(define-key c-mode-map 'f1
'make-symbolic-link)
</pre></td></tr></table>
+
</li><li>
Bind the shifted version of <kbd>F1</kbd> to a command.
<table><tr><td> </td><td><pre class="example">(define-key c-mode-map
'(shift f1) 'make-symbolic-link)
</pre></td></tr></table>
+
</li><li>
Redefine all keys which now run <code>next-line</code> in Fundamental mode
to run <code>forward-line</code> instead.
@@ -2268,11 +2297,13 @@
<table><tr><td> </td><td><pre class="example">(substitute-key-definition
'next-line 'forward-line
global-map)
</pre></td></tr></table>
+
</li><li>
Make <kbd>C-x C-v</kbd> undefined.
<table><tr><td> </td><td><pre class="example">(global-unset-key
"\C-x\C-v")
</pre></td></tr></table>
+
<p>One reason to undefine a key is so that you can make it a prefix.
Simply defining <kbd>C-x C-v <var>anything</var></kbd> would make <kbd>C-x
C-v</kbd>
a prefix, but <kbd>C-x C-v</kbd> must be freed of any non-prefix definition
@@ -2284,11 +2315,13 @@
<table><tr><td> </td><td><pre class="example">(modify-syntax-entry ?\$
"." text-mode-syntax-table)
</pre></td></tr></table>
+
</li><li>
Enable the use of the command <code>eval-expression</code> without
confirmation.
<table><tr><td> </td><td><pre class="example">(put 'eval-expression
'disabled nil)
-</pre></td></tr></table></li></ul>
+</pre></td></tr></table>
+</li></ul>
<hr size="6">
<a name="Terminal-Init"></a>
@@ -2406,6 +2439,7 @@
<table><tr><td> </td><td><pre class="example">( <var>sound-name</var> .
<var><sound></var> )
( <var>sound-name</var> <var><volume></var> <var><sound></var> )
</pre></td></tr></table>
+
<p>You should probably add things to this list by calling the function
<code>load-sound-file</code>.
</p>
@@ -3201,6 +3235,7 @@
fixed
9x13
</pre></td></tr></table>
+
<p>then XEmacs won't be able to guess the names of the bold and italic
versions. All X fonts can be referred to via XLFD-style names, so you
should use those forms. See the man pages for <samp>`X(1)'</samp>,
@@ -3239,6 +3274,7 @@
<table><tr><td> </td><td><pre class="example">INVOCATION-NAME
"shell" "container" FRAME-NAME
x-emacs-application-class "EmacsShell" "EmacsManager"
"EmacsFrame"
</pre></td></tr></table>
+
<p>where INVOCATION-NAME is the terminal component of the name of the
XEmacs executable (usually <samp>`xemacs'</samp>), and
<samp>`x-emacs-application-class'</samp> is generally <samp>`Emacs'</samp>.
@@ -3274,12 +3310,14 @@
</p>
<table><tr><td> </td><td><pre class="example">Emacs*menubar*font:
*-courier-medium-r-*-*-*-120-*-*-*-*-*-*
</pre></td></tr></table>
+
<p>If both the Lucid Motif-lookalike menu widgets and X Font Sets are
configured to allow multilingual menubars, then one uses
</p>
<table><tr><td> </td><td><pre class="example">*menubar*FontSet:
-*-helvetica-bold-r-*-*-*-120-*-*-*-*-iso8859-*, \
-*-*-*-*-*-*-*-120-*-jisx0208.1983-0
</pre></td></tr></table>
+
<p>That would specify fonts for a Japanese menubar. Specifying only one
XLFD is acceptable; specifying more than one for a given registry
(language) is also allowed. When X Font Sets are configured, some .font
@@ -3290,6 +3328,7 @@
</p>
<table><tr><td> </td><td><pre class="example">Emacs*menubar*fontList:
*-courier-medium-r-*-*-*-120-*-*-*-*-*-*
</pre></td></tr></table>
+
<p>because the Motif library uses the <code>fontList</code> resource name
instead
of <code>font</code>, which has subtly different semantics.
</p>
@@ -3866,6 +3905,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(open-termscript
"~/termscript")
</pre></td></tr></table>
+
<p>using <kbd>Meta-<kbd>ESC</kbd></kbd> or from the <samp>`*scratch*'</samp>
buffer
just after starting Emacs. From then on, all output from Emacs to the
terminal will be written in the specified termscript file as well, until
Index: texi2html/Tests/xemacs_res/xemacs_4.html
diff -u texi2html/Tests/xemacs_res/xemacs_4.html:1.26
texi2html/Tests/xemacs_res/xemacs_4.html:1.27
--- texi2html/Tests/xemacs_res/xemacs_4.html:1.26 Tue Aug 23 23:51:18 2005
+++ texi2html/Tests/xemacs_res/xemacs_4.html Sat Mar 25 13:26:48 2006
@@ -779,6 +779,7 @@
</p>
<table><tr><td> </td><td><pre class="example"> (setq default-frame-plist
'(width 80 height 55))
</pre></td></tr></table>
+
<p>This variable has replaced <code>default-frame-alist</code>, which is
considered obsolete.
</p>
Index: texi2html/Tests/xemacs_res/xemacs_5.html
diff -u texi2html/Tests/xemacs_res/xemacs_5.html:1.27
texi2html/Tests/xemacs_res/xemacs_5.html:1.28
--- texi2html/Tests/xemacs_res/xemacs_5.html:1.27 Tue Aug 23 23:51:18 2005
+++ texi2html/Tests/xemacs_res/xemacs_5.html Sat Mar 25 13:26:48 2006
@@ -269,6 +269,7 @@
</p>
<table><tr><td> </td><td><pre class="example"> [(modifier .. modifier
keysym) ... (modifier .. modifier keysym)]
</pre></td></tr></table>
+
<p> Here are some examples of complete key sequences:
</p>
<dl compact="compact">
@@ -457,6 +458,7 @@
keysym Caps_Lock = Super_L
add Mod2 = Super_L
</pre></td></tr></table>
+
<p>The first line says that the key that is currently called
<code>Caps_Lock</code>
should no longer behave as a “lock” key. The second line says that
this should now be called <code>Super_L</code> instead. The third line says
that
@@ -1406,6 +1408,7 @@
</p>
<table><tr><td> </td><td><pre class="example">(add-menu-item
'("File") "Rename File" 'rename-file t)
</pre></td></tr></table>
+
<p>To add a submenu of file management commands using a <b>File Management</b>
item, use the following code:
</p>
@@ -1413,6 +1416,7 @@
(add-menu-item '("File" "File Management") "Delete
File" 'delete-file t)
(add-menu-item '("File" "File Management") "Rename
File" 'rename-file t)
</pre></td></tr></table>
+
<p>The optional <var>before</var> argument is the name of a menu item before
which the new item should be added. If the item is already present, it
is not moved.
Index: texi2html/Tests/xemacs_res/xemacs_6.html
diff -u texi2html/Tests/xemacs_res/xemacs_6.html:1.27
texi2html/Tests/xemacs_res/xemacs_6.html:1.28
--- texi2html/Tests/xemacs_res/xemacs_6.html:1.27 Tue Aug 23 23:51:18 2005
+++ texi2html/Tests/xemacs_res/xemacs_6.html Sat Mar 25 13:26:48 2006
@@ -363,6 +363,7 @@
<table><tr><td> </td><td><pre class="example">% xemacs -version
XEmacs 19.13 of Mon Aug 21 1995 on willow (usg-unix-v) [formerly Lucid Emacs]
</pre></td></tr></table>
+
</dd>
<dt> <samp>`-help'</samp></dt>
<dd><p>Prints a summary of command-line options and then exits.
Index: texi2html/Tests/xemacs_res/xemacs_7.html
diff -u texi2html/Tests/xemacs_res/xemacs_7.html:1.25
texi2html/Tests/xemacs_res/xemacs_7.html:1.26
--- texi2html/Tests/xemacs_res/xemacs_7.html:1.25 Tue Aug 23 23:51:18 2005
+++ texi2html/Tests/xemacs_res/xemacs_7.html Sat Mar 25 13:26:48 2006
@@ -178,7 +178,6 @@
overwriting with it.)
</li></ul>
-
<p>A numeric argument to <kbd>C-q</kbd> specifies how many copies of the quoted
character should be inserted (see section <a href="#SEC58">Numeric
Arguments</a>).
</p>
@@ -744,6 +743,7 @@
</p>
<table><tr><td> </td><td><pre class="smallexample">point=563026 of
563025(100%) column 0
</pre></td></tr></table>
+
<hr size="6">
<a name="Arguments"></a>
<a name="SEC58"></a>
Index: texi2html/Tests/xemacs_res/xemacs_9.html
diff -u texi2html/Tests/xemacs_res/xemacs_9.html:1.24
texi2html/Tests/xemacs_res/xemacs_9.html:1.25
--- texi2html/Tests/xemacs_res/xemacs_9.html:1.24 Tue Aug 23 23:51:18 2005
+++ texi2html/Tests/xemacs_res/xemacs_9.html Sat Mar 25 13:26:48 2006
@@ -247,7 +247,8 @@
you typed. For example, if you attempted to visit a non-existent file,
the minibuffer might read:
</p><table><tr><td> </td><td><pre class="example"> Find File:
chocolate_bar.c [no completions, confirm]
-</pre></td></tr></table><p>If you press <kbd>Return</kbd> again, that confirms
the filename. Otherwise,
+</pre></td></tr></table>
+<p>If you press <kbd>Return</kbd> again, that confirms the filename. Otherwise,
you can continue editing it.
</p>
<p> XEmacs supports recursive use of the minibuffer. However, it is easy
Index: texi2html/doc/texi2html.html
diff -u texi2html/doc/texi2html.html:1.32 texi2html/doc/texi2html.html:1.33
--- texi2html/doc/texi2html.html:1.32 Sat Jan 28 22:02:26 2006
+++ texi2html/doc/texi2html.html Sat Mar 25 13:26:48 2006
@@ -31,7 +31,7 @@
permission notice may be stated in a translation approved
by the Free Software Foundation.
-->
-<!-- Created on January, 28 2006 by texi2html 1.77 -->
+<!-- Created on March, 25 2006 by texi2html @PACKAGE_VERSION@ -->
<!--
Written by: Lionel Cons <address@hidden> (original author)
Karl Berry <address@hidden>
@@ -48,7 +48,7 @@
<meta name="keywords" content="Texi2HTML – Texinfo to HTML v1.77:
Texi2HTML">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
-<meta name="Generator" content="texi2html 1.77">
+<meta name="Generator" content="texi2html @PACKAGE_VERSION@">
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<style type="text/css">
<!--
@@ -141,6 +141,7 @@
<table><tr><td> </td><td><pre class="example"><strong>This manual is
currently under construction and of course incomplete. ;-)</strong>
</pre></td></tr></table>
+
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top"><a href="#SEC1">1.
Overview</a></td><td> </td><td align="left" valign="top">
</td></tr>
@@ -527,6 +528,7 @@
cd texi2html_build
../texi2html-1.77/configure && make
</pre></td></tr></table>
+
<p>All these features enables to build <code>texi2html</code> on a platform
in order to run it on another platform, a kind of cross-building. The
<code>./configure</code> switches and <code>$PERL</code> allows to specify
@@ -558,6 +560,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ texi2html texi2html.texi
</pre></td></tr></table>
+
<p>The behaviour of <code>texi2html</code> may be changed with command line
options. These command line options are always associated with corresponding
<code>perl</code> variables which may appear in init files, and these
@@ -684,7 +687,8 @@
node3 text
@chapter node 3
chapter text
-</pre></td></tr></table></td><td>
+</pre></td></tr></table>
+</td><td>
</td><td>
<p>first element:
</p>
@@ -695,6 +699,7 @@
@node node2
node2 text
</pre></td></tr></table>
+
<p>second element:
</p>
<table><tr><td> </td><td><pre class="example">@node node3
@@ -702,6 +707,7 @@
@chapter node 3
chapter text
</pre></td></tr></table>
+
</td><td>
</td><td>
<p>first element:
@@ -710,11 +716,13 @@
@chapter node 1
node1 text
</pre></td></tr></table>
+
<p>second element:
</p>
<table><tr><td> </td><td><pre class="example">@node node2
node2 text
</pre></td></tr></table>
+
<p>third element:
</p>
<table><tr><td> </td><td><pre class="example">@node node3
@@ -722,6 +730,7 @@
@chapter node 3
chapter text
</pre></td></tr></table>
+
</td></tr>
</table>
@@ -774,6 +783,7 @@
afile_toc.html --> Table of Contents
afile_abt.html --> About Page
</pre></td></tr></table>
+
<p>This default behavior may be modified by several command line options. If
the
output isn't split, the prefix file name may be overrided by the
<a name="IDX12"></a>
@@ -804,6 +814,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$ texi2html -split chapter
-prefix manual -short-ext -top-file index.htm -toc-file contents.htm afile.texi
</pre></td></tr></table>
+
<p>we get, in <tt>`manual'</tt>:
</p>
<table><tr><td> </td><td><pre class="example">index.htm -->
<code>@node Top</code> or <code>@top</code> section
@@ -812,6 +823,7 @@
contents.htm --> Table of Contents
manual_abt.htm --> About Page
</pre></td></tr></table>
+
<p>The file names generated by <code>texi2html</code> differ from those
generated
by <code>makeinfo</code>. <code>makeinfo</code> uses the node name to construct
the file names while splitting at nodes. It is possible to get the same
@@ -1012,9 +1024,11 @@
</p>
<p>The default for the document doctype is:
</p><table><tr><td> </td><td><pre class="example"><!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html401/loose.dtd">
-</pre></td></tr></table><p>And for the frameset doctype:
+</pre></td></tr></table>
+<p>And for the frameset doctype:
</p><table><tr><td> </td><td><pre class="example"><!DOCTYPE html
PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"
"http://www.w3.org/TR/html401/frameset.dtd">
</pre></td></tr></table>
+
</dd>
<dt> <a name="IDX49"></a>
<p><samp>`--iso'</samp>
@@ -1297,6 +1311,7 @@
# process arguments and return an html anchor
}
</pre></td></tr></table>
+
<hr size="6">
<a name="Function-prototypes"></a>
<a name="SEC20"></a>
@@ -1348,6 +1363,7 @@
return $formatted_text
}
</pre></td></tr></table>
+
<hr size="6">
<a name="Changing-the-page-layout"></a>
<a name="SEC21"></a>
@@ -1506,6 +1522,7 @@
$BIG_RULE = '<hr size="6">';
</pre></td></tr></table>
+
<p>In the header some important meta data may be defined, like the
title or style information, and textual informations may be present
in comments. All this doesn't appear directly in the displayed
@@ -1773,6 +1790,7 @@
<p>For example if the buttons array element is
</p><table><tr><td> </td><td><pre class="example">[ 'Next',
\$Texi2HTML::NODE{Next} ]
</pre></td></tr></table>
+
<p>The button will be a link to the next section with text
<a name="IDX93"></a>
<code>$Texi2HTML::NODE{Next}</code>.
@@ -2189,6 +2207,7 @@
return $encoding;
}
</pre></td></tr></table>
+
<hr size="6">
<a name="Output-finalization"></a>
<a name="SEC37"></a>
@@ -2259,6 +2278,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$CSS_LINES = '';
</pre></td></tr></table>
+
<p>Another possiblility is to modify the array corresponding with the array
reference <code>$Texi2HTML::THISDOC{'css_import_lines'}</code> that contains
the
<code>@import</code> lines of <acronym>CSS</acronym> files, and similarly it
is possible
@@ -3215,9 +3235,11 @@
associated with accentted letters like <code>@AA{}</code>. If there happens to
be something within the braces, it is put after the command, thus
</p><table><tr><td> </td><td><pre class="example">@TeX{something}
-</pre></td></tr></table><p>leads to the same than
+</pre></td></tr></table>
+<p>leads to the same than
</p><table><tr><td> </td><td><pre class="example">@TeX{} something
</pre></td></tr></table>
+
<p>Each of these categories of commands have three associated hashes, one
for normal
context, the other for preformatted context and the last in strings. The
@@ -3247,6 +3269,7 @@
<table><tr><td> </td><td><pre class="example">$simple_map{'-'} =
'&shy;';
$simple_map_pre{'-'} = '&shy;';
</pre></td></tr></table>
+
<hr size="6">
<a name="Style-and-accent-commands"></a>
<a name="SEC54"></a>
@@ -3337,6 +3360,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$style_map{'command'} = {
'args' => ['code'], 'attribute' => 'code'};
</pre></td></tr></table>
+
<p>the arguments for <code>@command</code> are interpreted as specified by
the values associated with the <samp>`args'</samp> key while the attribute
associated
with that command is <samp>`code'</samp>.
@@ -3366,6 +3390,7 @@
<p>For example, we have
</p><table><tr><td> </td><td><pre
class="example">$style_map{'email'}->{'args'} = ['code', 'normal'];
</pre></td></tr></table>
+
<p>because <samp>`---'</samp>, <samp>`--'</samp>, <samp>`'''</samp> and
<samp>```'</samp> should be kept as is in
the first argument of <code>@email</code>.
</p>
@@ -3491,14 +3516,17 @@
return "$args[0]";
}
</pre></td></tr></table>
+
<p>The result of
</p><table><tr><td> </td><td><pre class="example">@foo{truc, 1}
@foo{truc, bidule}
</pre></td></tr></table>
+
<p>will be
</p><table><tr><td> </td><td><pre class="example">foo: truc
truc
-</pre></td></tr></table></li><li>
+</pre></td></tr></table>
+</li><li>
If the text is a word, it is considered to be an <acronym>HTML</acronym>
element
name, and the argument is enclosed between the element opening
and the element closing. For example, if the value is <code>elem</code>, the
@@ -3770,6 +3798,7 @@
' Up ' => 'Plus haut',
};
</pre></td></tr></table>
+
<p>It means that whenever the string <samp>` Up '</samp> is to be
written
and the language is <samp>`fr'</samp>, <samp>`Plus haut'</samp> is written. It
is possible
to customize the english strings by redefining the <samp>`en'</samp> language
hash.
@@ -3782,6 +3811,7 @@
'See %{node_file_href}' => 'Voir %{node_file_href}',
};
</pre></td></tr></table>
+
<p><samp>`%{node_file_href}'</samp> will be expanded to an href for a node in
a
file by <code>texi2html</code> in the string. A <samp>`%%'</samp> will be
expanded
as <samp>`%'</samp>.
@@ -4013,13 +4043,15 @@
by function references:
</p>
<dl>
-<dt><u>Function Reference:</u> $paragraph_text <b>paragraph</b><i> $text
$alignement $formatting_command $formatting_command_formatted
\$paragraph_number $format $item_number $enumerate_style $number</i>
+<dt><u>Function Reference:</u> $paragraph_text <b>paragraph</b><i> $text
$alignement $index $formatting_command $formatting_command_formatted
\$paragraph_number $format $item_number $enumerate_style $number</i>
<a name="IDX220"></a>
</dt>
<dd><p>This function formats a paragraph. <var>$text</var> is the text of the
paragraph,
<var>$alignement</var> is the empty string when no alignement command has
been seen, otherwise it is the current alignement command name.
See section <a href="#SEC64">Commands used for centering and flushing of
text</a>.
+<var>$indent</var> holds <samp>`noindent'</samp> or <samp>`indent'</samp> if
the corresponding
address@hidden appeared in the paragraph.
</p>
<p>The remaining arguments are usefull when the paragraph appears within a
list or table. It is usefull whenever the paragraph has to be formatted
@@ -4238,6 +4270,7 @@
For example <code>@minus</code> is the formatting command here:
</p><table><tr><td> </td><td><pre class="example">@table @minus
</pre></td></tr></table>
+
<p>The default is to apply the command to the text item, however it is possible
to avoid it.
The hash <a name="IDX225"></a>
@@ -4248,11 +4281,13 @@
</p>
<table><tr><td> </td><td><pre
class="example">$special_list_commands{'itemize'} = { 'bullet' => '' };
</pre></td></tr></table>
+
<p>and we have the following <code>@itemize</code>:
</p><table><tr><td> </td><td><pre class="example">@itemize @bullet
@item an item
@end itemize
</pre></td></tr></table>
+
<p>then <code>@bullet</code> will not be applied to <code>an item</code>.
</p>
<dl compact="compact">
@@ -4464,12 +4499,15 @@
<p>For example if we have:
</p><table><tr><td> </td><td><pre class="example">$def_map{'deftruc'} =
'@defvr {A truc}';
</pre></td></tr></table>
+
<p>and a line like
</p><table><tr><td> </td><td><pre class="example">@deftruc var
</pre></td></tr></table>
+
<p>the line will be transformed in
</p><table><tr><td> </td><td><pre class="example">@defvr {A truc} var
</pre></td></tr></table>
+
</li><li>
If the command isn't a shortcut, it is associated with an array
reference. The first element is <samp>`f'</samp>, <samp>`v'</samp> or
<samp>`t'</samp> corresponding
@@ -4485,6 +4523,7 @@
<p>For example if we have
</p><table><tr><td> </td><td><pre class="example">def_map{'defvr'} = [
'v', 'category', 'name' ];
</pre></td></tr></table>
+
<p>The first bracketed item following <code>@defvr</code> is considered
to be the category and the next one is the name. The index associated
with the definition line is the variables index.
@@ -4786,6 +4825,7 @@
because we are in @emph}.
@end menu
</pre></td></tr></table>
+
<hr size="6">
<a name="Menu-components-formatting"></a>
<a name="SEC79"></a>
@@ -4884,6 +4924,7 @@
<table><tr><td> </td><td><pre
class="example">$complex_format_map->{'menu'} = { 'begin' => q{''} ,
'end' => q{''},
'pre_style' => "$MENU_PRE_STYLE", 'class' =>
'menu-preformatted' };
</pre></td></tr></table>
+
<hr size="6">
<a name="Table-menu-formatting"></a>
<a name="SEC81"></a>
@@ -5436,6 +5477,7 @@
'expand' => \&Texi2HTML::LaTeX2HTML::do_tex
};
</pre></td></tr></table>
+
<p>And an example for a raw region @-command:
</p>
<table><tr><td> </td><td><pre class="example">$command_handler{'tex'} =
@@ -5443,6 +5485,7 @@
'expand' => \&Texi2HTML::LaTeX2HTML::do_tex
};
</pre></td></tr></table>
+
<p>The function references are called like:
</p>
<dl>
@@ -5497,6 +5540,7 @@
push @command_handler_finish, \&Texi2HTML::LaTeX2HTML::finish;
</pre></td></tr></table>
+
<hr size="6">
<a name="Other-and-unknown-commands"></a>
<a name="SEC90"></a>
@@ -5546,6 +5590,7 @@
</p>
<table><tr><td> </td><td><pre class="example">$misc_command{'command'} =
{'arg' => 'line', 'skip' => 'space'};
</pre></td></tr></table>
+
<p>The properties and possible values are:
</p>
<dl compact="compact">
@@ -5809,6 +5854,7 @@
<table><tr><td> </td><td><pre class="example">return &$I('%{name} of
%{class}',
{ 'name' => $name, 'class' => $class });
</pre></td></tr></table>
+
<p>In that case <code>%{name}</code> is substituted by <code>$name</code> in
the translated
string.
</p>
@@ -5820,12 +5866,14 @@
<table><tr><td> </td><td><pre class="example">./manage_i18n.pl template
./manage_i18n.pl update
</pre></td></tr></table>
+
<p>These two commands won't work if you don't have the
<code>Data::Dumper</code> module installed.
And to merge the new translation files in <tt>`translations.pl'</tt>, do
</p>
<table><tr><td> </td><td><pre class="example">./manage_i18n.pl merge
</pre></td></tr></table>
+
<p>All these steps may be performed by <code>make</code>, once the language
file
is added to <tt>`Makefile.am'</tt> in the <code>i18n_files</code> variable.
</p>
@@ -5955,6 +6003,7 @@
</p>
<table><tr><td> </td><td><pre class="example">something @example the
example @end example after the example
</pre></td></tr></table>
+
<p><code>makeinfo</code> and <code>texi2dvi</code> may also accept text before
the command and text after the <code>@end</code> command, sometimes ignoring
it after the <code>@end</code>.
@@ -5997,7 +6046,8 @@
to implement it.
</li><li> It is possible to escape the end of a macro definition with
<table><tr><td> </td><td><pre class="example">address@hidden macro
-</pre></td></tr></table><p>with the <samp>`\'</samp> being removed after the
first expansion. Otherwise
+</pre></td></tr></table>
+<p>with the <samp>`\'</samp> being removed after the first expansion. Otherwise
it is not possible to produce a <code>address@hidden macro</code> in a macro.
</p></li><li> <code>@unmacro</code> is interpreted during the macro argument
expansion.
Don't know what <code>makeinfo</code> exactly do.
@@ -6030,6 +6080,7 @@
@end ignore
@end ifset
</pre></td></tr></table>
+
<p>In <code>@ifset</code> and <code>@ifclear</code> texi2html also accepts
a lot more of invalid constructs. For example the following is accepted
by <code>texi2html</code> but not by <code>makeinfo</code>:
@@ -6043,7 +6094,8 @@
@ifset flag
@end itemize
@end ifset
-</pre></td></tr></table></dd>
+</pre></td></tr></table>
+</dd>
</dl>
<hr size="6">
@@ -6725,7 +6777,7 @@
</tr></table>
<h1>About This Document</h1>
<p>
- This document was generated by <em>Patrice Dumas</em> on <em>January, 28
2006</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html
1.77</em></a>.
+ This document was generated by <em>Patrice Dumas</em> on <em>March, 25
2006</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html
@PACKAGE_VERSION@</em></a>.
</p>
<p>
The buttons in the navigation panels have the following meaning:
@@ -6827,7 +6879,7 @@
<hr size="1">
<p>
<font size="-1">
- This document was generated by <em>Patrice Dumas</em> on <em>January, 28
2006</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html
1.77</em></a>.
+ This document was generated by <em>Patrice Dumas</em> on <em>March, 25
2006</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html
@PACKAGE_VERSION@</em></a>.
</font>
<br>
Index: texi2html/doc/texi2html.texi
diff -u texi2html/doc/texi2html.texi:1.44 texi2html/doc/texi2html.texi:1.45
--- texi2html/doc/texi2html.texi:1.44 Fri Jan 27 21:33:22 2006
+++ texi2html/doc/texi2html.texi Sat Mar 25 13:26:48 2006
@@ -2574,11 +2574,13 @@
The formatting of a paragraph region or a preformatted region, is controlled
by function references:
address@hidden {Function Reference} $paragraph_text paragraph $text $alignement
$formatting_command $formatting_command_formatted \$paragraph_number $format
$item_number $enumerate_style $number
address@hidden {Function Reference} $paragraph_text paragraph $text $alignement
$index $formatting_command $formatting_command_formatted \$paragraph_number
$format $item_number $enumerate_style $number
This function formats a paragraph. @var{$text} is the text of the paragraph,
@var{$alignement} is the empty string when no alignement command has
been seen, otherwise it is the current alignement command name.
@xref{Alignement commands}.
address@hidden holds @samp{noindent} or @samp{indent} if the corresponding
+@@-command appeared in the paragraph.
The remaining arguments are usefull when the paragraph appears within a
list or table. It is usefull whenever the paragraph has to be formatted
@@ -3780,9 +3782,9 @@
@option{-subdir} with a unique option.
More precisely @option{-out-file} forces the output to be unsplit
-while @option{--output} behaves differently when split (it specify
+while @option{--output} behaves differently when split (it specifies
the directory
-where the manual files should be outputted) and unsplit (it specify
+where the manual files should be outputted) and unsplit (it specifies
the output file). @option{-subdir} is retained for backward compatibility.
If you want a backward compatibility you can use @option{-subdir}
@@ -3814,6 +3816,12 @@
variables prefixed with @samp{T2H_} or @samp{t2h_}. To cope with
the change the prefix should be removed from variables in init files.
Some variables are now in @code{%Texi2HTML::THISDOC}.
address@hidden API changes between 1.76 and 1.78: paragraph has a new argument
+with indentation information, added as the third argument. normal_text
+changed completely. There
+are much more arguments to give informations about the context, and
+normal_text now does more text manipulation. New argument for image
+(the alt text).
@item @code{@@ifinfo} regions are not expanded by default. This may lead
to warnings or errors especially if the Top node is enclosed in
@code{@@ifinfo}, as some node won't appear in menus. The quick fix
Index: texi2html/examples/roff.init
diff -u texi2html/examples/roff.init:1.10 texi2html/examples/roff.init:1.11
--- texi2html/examples/roff.init:1.10 Tue Aug 23 23:51:18 2005
+++ texi2html/examples/roff.init Sat Mar 25 13:26:48 2006
@@ -774,10 +774,11 @@
}
# a paragraph
-sub t2h_roff_paragraph($$$$$$$$$)
+sub t2h_roff_paragraph($$$$$$$$$$)
{
my $text = shift;
my $align = shift;
+ my $indent = shift;
my $paragraph_command = shift;
my $paragraph_command_formatted = shift;
my $paragraph_number = shift;
Index: texi2html/texi2html.init
diff -u texi2html/texi2html.init:1.95 texi2html/texi2html.init:1.96
--- texi2html/texi2html.init:1.95 Thu Dec 1 08:38:40 2005
+++ texi2html/texi2html.init Sat Mar 25 13:26:46 2006
@@ -12,7 +12,7 @@
# Afterwards, load the file with command-line
# option -init-file <your_init_file>
#
-# $Id: texi2html.init,v 1.95 2005/12/01 08:38:40 pertusus Exp $
+# $Id: texi2html.init,v 1.96 2006/03/25 13:26:46 pertusus Exp $
######################################################################
# The following variables can also be set by command-line options
@@ -2680,28 +2680,27 @@
# an eval of these $complex_format_map->{what}->{'begin'} yields beginning
# an eval of these $complex_format_map->{what}->{'end'} yields end
# $EXAMPLE_INDENT_CELL and SMALL_EXAMPLE_INDENT_CELL can be usefull here
-# FIXME add \n at the end ?
$complex_format_map =
{
'example' =>
{
'begin' => q{"<table><tr>$EXAMPLE_INDENT_CELL<td>"},
- 'end' => q{'</td></tr></table>'},
+ 'end' => q{"</td></tr></table>\n"},
},
'smallexample' =>
{
'begin' => q{"<table><tr>$SMALL_EXAMPLE_INDENT_CELL<td>"},
- 'end' => q{'</td></tr></table>'},
+ 'end' => q{"</td></tr></table>\n"},
},
'display' =>
{
'begin' => q{"<table><tr>$EXAMPLE_INDENT_CELL<td>"},
- 'end' => q{'</td></tr></table>'},
+ 'end' => q{"</td></tr></table>\n"},
},
'smalldisplay' =>
{
'begin' => q{"<table><tr>$SMALL_EXAMPLE_INDENT_CELL<td>"},
- 'end' => q{'</td></tr></table>'},
+ 'end' => q{"</td></tr></table>\n"},
}
};
@@ -2828,7 +2827,8 @@
# formatting
'page' => {}, # no arg (pagebreak)
'refill' => {}, # no arg (obsolete, to be ignored)
- 'noindent' => {'skip' => 'space'}, # no arg
+ 'noindent' => {'skip' => 'whitespace'}, # no arg
+ 'indent' => {'skip' => 'whitespace'},
'need' => {'skip' => 'line', 'arg' => 1}, # one numerical/real arg
'exdent' => {'skip' => 'space'},
# not valid for info (should be in @iftex)
@@ -2836,7 +2836,6 @@
'cropmarks' => {}, # no arg
# miscalleneous
'verbatiminclude'=> {'skip' => 'line'},
- 'noindent' => {'skip' => 'space'},
'documentencoding' => {'arg' => 1}, # makeinfo ignore the whole line
# ???
'filbreak' => {},
@@ -3910,16 +3909,18 @@
# arguments:
# $text of the paragraph
# $align for the alignement
+# $indent for the indent style (indent or noindent)
# The following is usefull if the paragraph is in an itemize.
# $paragraph_command is the leading formatting command (like @minus)
# $paragraph_command_formatted is the leading formatting command formatted
# $paragraph_number is a reference on the number of paragraphs appearing
# in the format. The value should be increased if a paragraph is done
# $format is the format name (@itemize)
-sub t2h_default_paragraph($$$$$$$$$)
+sub t2h_default_paragraph($$$$$$$$$$)
{
my $text = shift;
my $align = shift;
+ my $indent = shift;
my $paragraph_command = shift;
my $paragraph_command_formatted = shift;
my $paragraph_number = shift;
Index: texi2html/texi2html.pl
diff -u texi2html/texi2html.pl:1.157 texi2html/texi2html.pl:1.158
--- texi2html/texi2html.pl:1.157 Sat Jan 28 22:02:26 2006
+++ texi2html/texi2html.pl Sat Mar 25 13:26:46 2006
@@ -53,12 +53,13 @@
# NOTE FOR DEBUGGING THIS SCRIPT:
# You can run 'perl texi2html.pl' directly, provided you have
# the environment variable T2H_HOME set to the directory containing
-# the texi2html.init file
+# the texi2html.init, T2h_i18n.pm, translations.pl, l2h.init,
+# T2h_l2h.pm files
#
#--##########################################################################
# CVS version:
-# $Id: texi2html.pl,v 1.157 2006/01/28 22:02:26 pertusus Exp $
+# $Id: texi2html.pl,v 1.158 2006/03/25 13:26:46 pertusus Exp $
# Homepage:
my $T2H_HOMEPAGE = "http://www.nongnu.org/texi2html/";
@@ -3437,6 +3438,7 @@
return @result;
}
+# handle misc commands and misc command args
sub misc_command_structure($$$$)
{
my $line = shift;
@@ -3756,6 +3758,10 @@
echo_warn ("Bad address@hidden", $line_nr);
}
}
+ elsif ($macro eq 'indent' or $macro eq 'noindent')
+ {
+ $state->{'paragraph_indent'} = $macro;
+ }
($remaining, $skipped, $args) = preserve_command($line, $macro);
return ($skipped) if ($keep);
return $remaining if ($remaining ne '');
@@ -6565,6 +6571,14 @@
my ($format, $paragraph_command, $paragraph_number, $term, $item_nr,
$enumerate_type, $number) = get_format_command ($state->{'paragraph'});
delete $state->{'paragraph'};
+
+ my $indent_style = '';
+ if (exists($state->{'paragraph_indent'}))
+ {
+ $indent_style = $state->{'paragraph_indent'};
+ $state->{'paragraph_indent'} = undef;
+ delete $state->{'paragraph_indent'};
+ }
my $paragraph_command_formatted;
$state->{'paragraph_nr'}--;
(print STDERR "Bug text undef in do_paragraph", return '') unless
defined($text);
@@ -6585,7 +6599,7 @@
{
$paragraph_command_formatted = do_simple($paragraph_command, '',
$state);
}
- return &$Texi2HTML::Config::paragraph($text, $align, $paragraph_command,
$paragraph_command_formatted, $paragraph_number, $format, $item_nr,
$enumerate_type, $number);
+ return &$Texi2HTML::Config::paragraph($text, $align, $indent_style,
$paragraph_command, $paragraph_command_formatted, $paragraph_number, $format,
$item_nr, $enumerate_type, $number);
}
sub do_preformatted($$)
@@ -11101,7 +11115,6 @@
add_prev($text, $stack, do_paragraph($paragraph->{'text'}, $state));
$state->{'paragraph_macros'} = $new_stack;
return 1;
- #return "address@hidden ";
}
elsif ($top_stack and ($top_stack->{'format'} eq 'preformatted'))
{
@@ -11109,7 +11122,6 @@
add_prev($text, $stack, do_preformatted($paragraph->{'text'}, $state));
$state->{'paragraph_macros'} = $new_stack;
return 1;
- #return "address@hidden ";
}
return;
}
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Texi2html-cvs] texi2html ./ChangeLog ./NEWS ./T2h_l2h.pm ./tex...,
Patrice Dumas <=