home *** CD-ROM | disk | FTP | other *** search
Text File | 1990-09-11 | 72.9 KB | 1,761 lines
diff -cr /tmp/old1.3.1/CHANGES ./CHANGES *** /tmp/old1.3.1/CHANGES Wed Jul 25 13:20:48 1990 --- ./CHANGES Sat Aug 25 00:27:40 1990 *************** *** 21,23 **** --- 21,29 ---- 1.3.1 Second Patch - June 24, 1990 Fixed a blunder that broke the description environment. Changed the manual to tell people to use .login instead .cshrc. + + 1.3.2 Third Patch - Auguest 25, 1990 + Fixed bug in synindex + Fixed the description environment. + Changed the manual to incorporate the proofreading from Nelson Beebe. + Added \\ to replace the \* command. diff -cr /tmp/old1.3.1/MANIFEST ./MANIFEST *** /tmp/old1.3.1/MANIFEST Wed Jul 25 13:20:48 1990 --- ./MANIFEST Sat Aug 25 00:27:40 1990 *************** *** 19,28 **** manual/Makefile 1 manual/README 1 manual/latexinfo-aa 7 ! manual/latexinfo-ab 5 ! manual/latexinfo-ac 3 manual/latexinfo-ad 6 ! manual/latexinfo-ae 4 manual/latexinfo.bbl 1 manual/latexinfo.bib 1 manual/makeinfo.el 1 --- 19,28 ---- manual/Makefile 1 manual/README 1 manual/latexinfo-aa 7 ! manual/latexinfo-ab 4 ! manual/latexinfo-ac 3 manual/latexinfo-ad 6 ! manual/latexinfo-ae 5 manual/latexinfo.bbl 1 manual/latexinfo.bib 1 manual/makeinfo.el 1 diff -cr /tmp/old1.3.1/latexinfo.el ./latexinfo.el *** /tmp/old1.3.1/latexinfo.el Wed Jul 25 13:21:42 1990 --- ./latexinfo.el Sat Aug 25 00:28:30 1990 *************** *** 40,46 **** (put 'latexinfoversion 'latexinfo-format 'latexinfo-format-latexinfoversion) (defun latexinfo-format-latexinfoversion () (latexinfo-parse-noarg) ! (insert "1.3.1")) (defvar latexinfo-format-syntax-table nil) --- 40,46 ---- (put 'latexinfoversion 'latexinfo-format 'latexinfo-format-latexinfoversion) (defun latexinfo-format-latexinfoversion () (latexinfo-parse-noarg) ! (insert "1.3.2")) (defvar latexinfo-format-syntax-table nil) *************** *** 761,767 **** (put 'description 'latexinfo-format 'latexinfo-description) (defun latexinfo-description () ! (latexinfo-push-stack 'description 0) (setq fill-column (- fill-column 5)) (latexinfo-discard-line)) --- 761,767 ---- (put 'description 'latexinfo-format 'latexinfo-description) (defun latexinfo-description () ! (latexinfo-push-stack 'description "") (setq fill-column (- fill-column 5)) (latexinfo-discard-line)) *************** *** 773,778 **** --- 773,784 ---- (latexinfo-pop-stack 'description))) (latexinfo-do-itemize (nth 1 stacktop)))) + (put 'description 'latexinfo-item 'latexinfo-description-item) + (defun latexinfo-description-item () + (let ((arg (latexinfo-parse-arg-discard))) + (insert ?\b arg "\n \n")) + (forward-line -2)) + ;; At the \end, indent all the lines within the construct ;; except those marked with backspace. FROM says where ;; construct started. *************** *** 804,816 **** (setcar (cdr (car latexinfo-stack)) next) (insert ?\b (format "%3d. " next) ?\n)) (forward-line -1)) - - (put 'description 'latexinfo-item 'latexinfo-description-item) - (defun latexinfo-description-item () - (let ((arg (latexinfo-parse-arg-discard)) - (itemfont (car (cdr (car latexinfo-stack))))) - (insert ?\b itemfont ?\{ arg "}\n \n")) - (forward-line -2)) (put 'ifinfo 'latexinfo-format 'latexinfo-discard-line) --- 810,815 ---- diff -cr /tmp/old1.3.1/latexinfo.sty ./latexinfo.sty *** /tmp/old1.3.1/latexinfo.sty Wed Jul 25 13:21:10 1990 --- ./latexinfo.sty Sat Aug 25 00:27:57 1990 *************** *** 3,9 **** % Copyright (C) 1985, 1986 Richard M. Stallman % Copyleft (0) 1988, 1989 Michael E. Clarkson ! \def\latexinfoversion{1.3.1} \message{Loading Latexinfo package [Version \latexinfoversion]:} \message{} --- 3,9 ---- % Copyright (C) 1985, 1986 Richard M. Stallman % Copyleft (0) 1988, 1989 Michael E. Clarkson ! \def\latexinfoversion{1.3.2} \message{Loading Latexinfo package [Version \latexinfoversion]:} \message{} *************** *** 338,344 **** % \synindex{foo}{bar} makes index foo feed into index bar. \def\synindex#1#2{\expandafter\xdef \csname @#1index\endcsname{% \noexpand\csname @#2index\endcsname}% ! \expandafter \chardef \csname @#1indfile\endcsname=\csname @#2indfile\endcsname} % Define the macros used in formatting output of the sorted index material. --- 338,344 ---- % \synindex{foo}{bar} makes index foo feed into index bar. \def\synindex#1#2{\expandafter\xdef \csname @#1index\endcsname{% \noexpand\csname @#2index\endcsname}% ! \expandafter \chardef \csname @#1indexfile\endcsname=\csname @#2indexfile\endcsname} % Define the macros used in formatting output of the sorted index material. Common subdirectories: /tmp/old1.3.1/manual and ./manual diff -cr /tmp/old1.3.1/manual/latexinfo.tex ./manual/latexinfo.tex *** /tmp/old1.3.1/manual/latexinfo.tex Wed Jul 25 13:21:56 1990 --- ./manual/latexinfo.tex Sat Aug 25 00:28:49 1990 *************** *** 61,67 **** \begin{ifinfo} This file documents \LaTeX info, a documentation system that uses a single ! source file to produce both on-line help and a printed manual. This is edition \latexinfoversion\ of the \LaTeX info documentation, and is for Version 18 of GNU Emacs.\refill --- 61,67 ---- \begin{ifinfo} This file documents \LaTeX info, a documentation system that uses a single ! source file to produce both on--line help and a printed manual. This is edition \latexinfoversion\ of the \LaTeX info documentation, and is for Version 18 of GNU Emacs.\refill *************** *** 144,156 **** so that any problems introduced by others will not reflect on our reputation. ! The precise conditions of the licenses for the programs currently ! being distributed that relate to \LaTeX info are found in the General Public ! Licenses that accompany them. The programs that are part of GNU Emacs ! are covered by the GNU Emacs copying terms ! (\pxref{License, , , emacs, The GNU Emacs Manual}), ! and other programs are covered by licenses that are contained in their ! source files. \node Overview of LaTeXinfo, Advantages of LaTeXinfo over TeXinfo, Licensing Information, Top \chapter{Overview of LaTeXinfo} --- 144,155 ---- so that any problems introduced by others will not reflect on our reputation. ! The precise conditions of the licenses for the programs currently being ! distributed that relate to \LaTeX info are found in the General Public ! Licenses that accompany them. The programs that are part of GNU Emacs are ! covered by the GNU Emacs copying terms (\pxref{License, , , emacs, The GNU ! Emacs Manual}), and other programs are covered by licenses that are ! contained in their source files. \node Overview of LaTeXinfo, Advantages of LaTeXinfo over TeXinfo, Licensing Information, Top \chapter{Overview of LaTeXinfo} *************** *** 158,165 **** \cindex{LaTeXinfo overview} \LaTeX info is a documentation system that uses a single source file for both ! on-line help and a printed manual. This means that instead of writing two ! different documents, one for the on-line help and the other for the printed manual, only one document needs to be written. When the system is revised, only one file has to be revised.\refill --- 157,164 ---- \cindex{LaTeXinfo overview} \LaTeX info is a documentation system that uses a single source file for both ! on--line help and a printed manual. This means that instead of writing two ! different documents, one for the on--line help and the other for the printed manual, only one document needs to be written. When the system is revised, only one file has to be revised.\refill *************** *** 166,192 **** Using \LaTeX info, you can create a document with the normal features of a book such as chapters, sections, cross references and indices. The chapters and sections of the printed manual can be made to correspond to ! the nodes of the on-line help. The cross references and indices can be ! used in both the on-line help and in the printed document. Indices are generated semi-automatically.\refill To make the printed manual, the \LaTeX info source file is processed by the \LaTeX\ typesetting program; the resulting DVI file can be typeset and ! printed as a book. To make the on-line help, the \LaTeX info source file ! is by processed the \kbd{M-x latexinfo-format-buffer} command in GNU Emacs; ! the resulting Info file should be installed in the \file{info} ! directory.\refill Since the \LaTeX info source file is used for a dual task---to create both ! the on-line help and the printed manual---it must be written in a special format that uses commands (words preceded by a \samp{\back }) to indicate chapters, sections, nodes, examples, index entries and the like.\refill Before writing a \LaTeX info source file, you should be familiar with the ! on-line Info documentation reading program. (\inforef{Info, info, info}, for more information.) If you are writing a document that will be both ! on-line and printed, you will need both Info and \LaTeX. To make a printed manual, you need to use \LaTeX, which is based on the powerful, sophisticated typesetting program written by Donald Knuth, --- 165,191 ---- Using \LaTeX info, you can create a document with the normal features of a book such as chapters, sections, cross references and indices. The chapters and sections of the printed manual can be made to correspond to ! the nodes of the on--line help. The cross references and indices can be ! used in both the on--line help and in the printed document. Indices are generated semi-automatically.\refill To make the printed manual, the \LaTeX info source file is processed by the \LaTeX\ typesetting program; the resulting DVI file can be typeset and ! printed as a book. To make the on--line help file, the \LaTeX info source ! file is by processed the \kbd{M-x latexinfo-format-buffer} command from ! within GNU Emacs; the resulting Info file should then be installed in the ! \file{info} directory.\refill Since the \LaTeX info source file is used for a dual task---to create both ! the on--line help and the printed manual---it must be written in a special format that uses commands (words preceded by a \samp{\back }) to indicate chapters, sections, nodes, examples, index entries and the like.\refill Before writing a \LaTeX info source file, you should be familiar with the ! on--line Info documentation reading program. (\inforef{Info, info, info}, for more information.) If you are writing a document that will be both ! on--line and printed, you will need both Info and \LaTeX. To make a printed manual, you need to use \LaTeX, which is based on the powerful, sophisticated typesetting program written by Donald Knuth, *************** *** 228,234 **** \begin{enumerate} \item ! The point size or layout style of a document can be changed easily using as can the \code{documentstyle} (\t{article, report, book, twoside, \dots}). \item --- 227,233 ---- \begin{enumerate} \item ! The point size or layout style of a document can be changed easily, as can the \code{documentstyle} (\t{article, report, book, twoside, \dots}). \item *************** *** 242,248 **** a \LaTeX info command starts, and where it ends. \item ! Any \LaTeX\ commands not understood by the on-line manual generator (\file{latexinfo.el}) are simply ignored. This means that you are free to add a considerable number of \LaTeX\ commands to make you manual look pretty, as long as you don't care that there will be no action taken by the --- 241,247 ---- a \LaTeX info command starts, and where it ends. \item ! Any \LaTeX\ commands not understood by the on-line manual generator\\ (\file{latexinfo.el}) are simply ignored. This means that you are free to add a considerable number of \LaTeX\ commands to make you manual look pretty, as long as you don't care that there will be no action taken by the *************** *** 253,259 **** by making GNU Emacs handlers for your \LaTeX\ extensions. This is the Emacs counterpart to the \code{documentstyle} options. \LaTeX info looks in a specified directory for GNU Elisp code that corresponds to each ! style file. This makes it easy to modularize you style files. \item \LaTeX\ has many advantages over \TeX, such as being able to incorporate the Bib\TeX\ bibliography formatting program, and is much more --- 252,258 ---- by making GNU Emacs handlers for your \LaTeX\ extensions. This is the Emacs counterpart to the \code{documentstyle} options. \LaTeX info looks in a specified directory for GNU Elisp code that corresponds to each ! style file. This makes it easy to modularize your style files. \item \LaTeX\ has many advantages over \TeX, such as being able to incorporate the Bib\TeX\ bibliography formatting program, and is much more *************** *** 426,439 **** \end{verbatim} \noindent ! The \samp{\back documentstyle[12pt,latexinfo]} line tells ! \LaTeX\ to use the \file{latexinfo.sty} style file. The \code{\back ! pagestyle\{headings\}} command is the \LaTeX\ command to put the chapter ! and section headings and page numbers at the top of each page. The ! \code{\back begin\{document\}} command starts the document, and makes the characters \code{# $ % ^ \& _ |} all begin to print as normal ! characters. This line must be followed (sooner or later) by the ! \samp{\back setfilename\{\var{info-file-name}\}}. It is is needed to provide a name for the Info file to output to.\refill \node A Short Sample LaTeXinfo File, Beginning a LaTeXinfo File, General Syntactic Conventions, Overview of LaTeXinfo --- 425,440 ---- \end{verbatim} \noindent ! The \samp{\back documentstyle[12pt,latexinfo]\{book\}} line tells \LaTeX\ ! to use the \file{latexinfo.sty} and \file{book.sty} style files. The ! \code{\back pagestyle\{headings\}} command is the \LaTeX\ command to put ! the chapter and section headings and page numbers at the top of each page. ! The \code{\back begin\{document\}} command starts the document, and makes the characters \code{# $ % ^ \& _ |} all begin to print as normal ! characters. (These characters retain their normal \LaTeX\ meanings in the ! preamble between the \samp{\back documentstyle} and \code{\back ! begin\{document\}} commands.) This line must be followed (sooner or later) ! by the \samp{\back setfilename\{\var{info-file-name}\}}. It is is needed to provide a name for the Info file to output to.\refill \node A Short Sample LaTeXinfo File, Beginning a LaTeXinfo File, General Syntactic Conventions, Overview of LaTeXinfo *************** *** 441,450 **** \cindex{A Short Sample LaTeXinfo File} \cindex{Sample LaTeXinfo file} A \LaTeX info file looks like the following, which is a complete but very ! short \LaTeX info file. The \code{\back comment} command introduces ! comments that will not appear in either the Info file or the printed ! manual; they are for the person who reads the \LaTeX info file. The first part of the file, from \samp{\back documentstyle} through to \samp{\back setfilename}, looks more intimidating than it is. Most of the --- 442,454 ---- \cindex{A Short Sample LaTeXinfo File} \cindex{Sample LaTeXinfo file} + \findex{c} + \findex{comment} + A \LaTeX info file looks like the following, which is a complete but very ! short \LaTeX info file. The \code{\back comment} or \code{\back c} command ! introduces comments that will not appear in either the Info file or the ! printed manual; they are for the person who reads the \LaTeX info file. The first part of the file, from \samp{\back documentstyle} through to \samp{\back setfilename}, looks more intimidating than it is. Most of the *************** *** 451,457 **** material is standard boilerplate; when you write a manual, you just put in the name of your own manual in this section.\refill ! All the commands that tell \LaTeX\ how to typeset the printed manual and tell\* \code{latexinfo-format-buffer} how to create an Info file are preceded by \samp{\back }; thus, \code{\back node} indicates a node and \code{\back chapter} indicates the start of a chapter.\refill --- 455,461 ---- material is standard boilerplate; when you write a manual, you just put in the name of your own manual in this section.\refill ! All the commands that tell \LaTeX\ how to typeset the printed manual and tell\\ \code{latexinfo-format-buffer} how to create an Info file are preceded by \samp{\back }; thus, \code{\back node} indicates a node and \code{\back chapter} indicates the start of a chapter.\refill *************** *** 477,483 **** \c The following commands start the copyright page for the printed manual. \clearpage ! \vpace{0pt plus 1filll} Copyright \copyright\ year copyright-owner Permission is granted to copy and distribute modified versions of this --- 481,487 ---- \c The following commands start the copyright page for the printed manual. \clearpage ! \vspace{0pt plus 1filll} Copyright \copyright\ year copyright-owner Permission is granted to copy and distribute modified versions of this *************** *** 615,624 **** \cindex{LaTeXinfo file header} \LaTeX info files start with at least three lines that provide Info and ! \LaTeX\ with necessary information. If you want to run \LaTeX\ on just ! a part of the \LaTeX info File, you also have to mark these heading lines ! with start-of-header and end-of-header lines.\refill \begin{menu} * The First Line of a LaTeXinfo File:: * Titlepage:: --- 619,632 ---- \cindex{LaTeXinfo file header} \LaTeX info files start with at least three lines that provide Info and ! \LaTeX\ with necessary information. + \begin{verbatim} + \documentstyle[12pt,latexinfo]{book} + \pagestyle{headings} + \begin{document} + \end{verbatim} + \begin{menu} * The First Line of a LaTeXinfo File:: * Titlepage:: *************** *** 700,706 **** the sample, the \code{\back clearpage} that ends the titlepage is followed by the somewhat mysterious line that reads: \samp{\back vspace*\{0pt plus 1filll\}}. This is a line that uses ! \LaTeX commands to push the copyright notice and the other text on the copyright page towards the bottom of the page. The \code{\back vspace*} command means to put in white space. The \samp{0pt plus 1filll} means to put in zero points of mandatory white space, and as much optional --- 708,714 ---- the sample, the \code{\back clearpage} that ends the titlepage is followed by the somewhat mysterious line that reads: \samp{\back vspace*\{0pt plus 1filll\}}. This is a line that uses ! \LaTeX\ commands to push the copyright notice and the other text on the copyright page towards the bottom of the page. The \code{\back vspace*} command means to put in white space. The \samp{0pt plus 1filll} means to put in zero points of mandatory white space, and as much optional *************** *** 795,801 **** \cindex{Top node} \cindex{Master menu} ! The \samp{Top} node contains an extensive, master menu for the whole Info file. The contents of this node appear only in the Info file. Nothing in this node should appear in the printed file. Since a node line by itself and a menu by itself are not printed, the contents of --- 803,809 ---- \cindex{Top node} \cindex{Master menu} ! The \samp{Top} node contains an extensive master menu for the whole Info file. The contents of this node appear only in the Info file. Nothing in this node should appear in the printed file. Since a node line by itself and a menu by itself are not printed, the contents of *************** *** 812,818 **** \begin{itemize} \item ! The first part contains the major nodes in the \LaTeX info file: the \item The second part contains entries for the indices. In an Info file, it --- 820,826 ---- \begin{itemize} \item ! The first part contains the major nodes in the \LaTeX info file. \item The second part contains entries for the indices. In an Info file, it *************** *** 1158,1164 **** You could put variables into the function index by writing \code{\back findex} commands for them instead of \code{\back vindex} commands, and produce a consistent manual by printing the function index with the title `Function ! and Variable Index' and not printing the `Variable Index' at all; but this is not a robust procedure. It works only as long as your document is never included in part of or together with another document that is designed to have a separate variable index; if you did that, the variables from your --- 1166,1172 ---- You could put variables into the function index by writing \code{\back findex} commands for them instead of \code{\back vindex} commands, and produce a consistent manual by printing the function index with the title `Function ! and Variable Index' and not printing the `Variable Index' at all, but this is not a robust procedure. It works only as long as your document is never included in part of or together with another document that is designed to have a separate variable index; if you did that, the variables from your *************** *** 1188,1204 **** print an index, you must include the \code{\back printindex} command at the place in the document where you want the index to appear. Also, for the case of the printed manual, you must run a program that is supplied ! with GNU Emacs called \code{texindex} to sort the raw data to produce a sorted index file, which is what will actually be used to print the index.\refill The \LaTeX info command that is used to print indices is ! \code{\back printindex}. It takes the two-letter index name (\pxref{Combining Indices}) as an argument without braces, and reads the corresponding sorted index file and formats it appropriately into an index.\refill \begin{ifinfo} ! The two-letter index names are: \begin{description} \item[cp] --- 1196,1212 ---- print an index, you must include the \code{\back printindex} command at the place in the document where you want the index to appear. Also, for the case of the printed manual, you must run a program that is supplied ! with GNU Emacs, called \code{texindex}, to sort the raw data to produce a sorted index file, which is what will actually be used to print the index.\refill The \LaTeX info command that is used to print indices is ! \code{\back printindex}. It takes the two--letter index name (\pxref{Combining Indices}) as an argument without braces, and reads the corresponding sorted index file and formats it appropriately into an index.\refill \begin{ifinfo} ! The two--letter index names are: \begin{description} \item[cp] *************** *** 1270,1281 **** and as a printed manual. The only time you are likely to use the chapter structuring commands without using the node structuring commands is if you are writing a document that will never be put into Info format, for ! example, a novel, a letter, an article or a memorandum. Although a \LaTeX info file can be structured in a variety of ways, it is usually structured like a book with chapters, sections, subsections and the like. This structure can also be visualized as a tree (or rather as an ! upside down tree) with the root at the top and each level corresponding to chapters or sections. In Info format, you reach the nodes on each level by using the the `Next' and `Previous' pointers in the node line. For example, you go from one chapter to the next or previous chapter --- 1278,1289 ---- and as a printed manual. The only time you are likely to use the chapter structuring commands without using the node structuring commands is if you are writing a document that will never be put into Info format, for ! example, a novel, a letter, an article, or a memorandum. Although a \LaTeX info file can be structured in a variety of ways, it is usually structured like a book with chapters, sections, subsections and the like. This structure can also be visualized as a tree (or rather as an ! upside--down tree) with the root at the top and each level corresponding to chapters or sections. In Info format, you reach the nodes on each level by using the the `Next' and `Previous' pointers in the node line. For example, you go from one chapter to the next or previous chapter *************** *** 1326,1336 **** just before Section 2.1. Note that a menu entry has three parts: the menu item name, the name of the menu item name and the name of the node are the same, you can put two ! colons after the item name, as is shown in the example. (If the second part ! is different from the first, the first part is terminated by a colon and ! the second part terminated by a tab, newline, comma or period.) ! (\xref{Menu Environment}.) The node for Sect. 2.1 will look like this: --- 1334,1343 ---- just before Section 2.1. Note that a menu entry has three parts: the menu item name, the name of the + node and, optionally, a description of the item (in that order). If the menu item name and the name of the node are the same, you can put two ! colons after the item name, as is shown in the example. ! \xref{Menu Environment}. The node for Sect. 2.1 will look like this: *************** *** 1352,1358 **** \cindex{File ending} \end{verbatim} ! The \code{\back node} command is the only one in \LaTeX info where its arguments are not delineated by braces. The arguments are separated by commas, and are terminated at the end of the line. This is because the Info format itself requires the \code{node} arguments to be like --- 1359,1365 ---- \cindex{File ending} \end{verbatim} ! The \code{\back node} command is the only one in \LaTeX info where the arguments are not delineated by braces. The arguments are separated by commas, and are terminated at the end of the line. This is because the Info format itself requires the \code{node} arguments to be like *************** *** 1523,1535 **** In \LaTeX, \code{\back node} is nearly ignored. It generates no text. Its only function is to identify the name to use for cross-references to the chapter or section which follows the \code{\back node} command and ! which which makes up the body of the node. (Cross references are made with \code{\back xref}. \xref{Making Cross References}.) \code{\back node} should be followed immediately by a chapter-structuring command such as \code{\back chapter}, \code{\back section}, \code{\back subsection} or \code{\back subsubsection}.\refill ! The easiest way to write a node is to use the LaTeXinfo Mode keyboard command \ctrl{c} \ctrl{c} \key{n} to insert \samp{\back node} and a comment line listing the names of each of the pointers in their proper order. This way you won't lose track of which arguments are for which --- 1530,1542 ---- In \LaTeX, \code{\back node} is nearly ignored. It generates no text. Its only function is to identify the name to use for cross-references to the chapter or section which follows the \code{\back node} command and ! which makes up the body of the node. (Cross references are made with \code{\back xref}. \xref{Making Cross References}.) \code{\back node} should be followed immediately by a chapter-structuring command such as \code{\back chapter}, \code{\back section}, \code{\back subsection} or \code{\back subsubsection}.\refill ! The easiest way to write a node is to use the \LaTeX info Mode keyboard command \ctrl{c} \ctrl{c} \key{n} to insert \samp{\back node} and a comment line listing the names of each of the pointers in their proper order. This way you won't lose track of which arguments are for which *************** *** 1625,1630 **** --- 1632,1638 ---- newline; or with a period. \clearpage + \noindent For example: \begin{example} *************** *** 1938,1946 **** \noindent produces in the Info file - \noindent - \noindent \begin{quotation} \begin{itemize} \item Some text for foo. --- 1946,1953 ---- \noindent produces in the Info file \begin{quotation} + \noindent \begin{itemize} \item Some text for foo. *************** *** 2045,2050 **** --- 2052,2058 ---- produces \begin{quotation} + \noindent \begin{description} \item[foo] This is the text for \samp{foo}. *************** *** 2092,2102 **** \begin{description} \item[\back xref] ! Used to start a sentence in the printed manual saying, `See \dots' \* or an entry in the Info file saying \samp{*note \dots}. \item[\back pxref] ! Used to make a reference that starts with a lowercase \samp{see} \* and is usually contained within parentheses.\refill \item[\back inforef] --- 2100,2110 ---- \begin{description} \item[\back xref] ! Used to start a sentence in the printed manual saying, `See \dots' \\ or an entry in the Info file saying \samp{*note \dots}. \item[\back pxref] ! Used to make a reference that starts with a lowercase \samp{see} \\ and is usually contained within parentheses.\refill \item[\back inforef] *************** *** 2133,2139 **** \code{\back xref} must refer to an Info node created by \code{\back node}, by the node's name. It uses the \LaTeX\ commands ! \code{ref} and \code{pageref}. \code{\back xref} is followed by an argument inside braces; but actually the text inside the braces is treated as several arguments, separated by --- 2141,2147 ---- \code{\back xref} must refer to an Info node created by \code{\back node}, by the node's name. It uses the \LaTeX\ commands ! \code{\back ref} and \code{\back pageref}. \code{\back xref} is followed by an argument inside braces; but actually the text inside the braces is treated as several arguments, separated by *************** *** 2315,2321 **** \cindex{Formatting paragraphs} \cindex{Paragraphs, formatting} ! Usually, a \LaTeX info file will be processed both by \LaTeX\ and by the \kbd{M-x latexinfo-format-buffer} command. Consequently, you must make sure that text will come out looking right both in the printed manual and in the on-line help.\refill --- 2323,2329 ---- \cindex{Formatting paragraphs} \cindex{Paragraphs, formatting} ! Usually, a \LaTeX info file will be processed both by \LaTeX\ and by the\\ \kbd{M-x latexinfo-format-buffer} command. Consequently, you must make sure that text will come out looking right both in the printed manual and in the on-line help.\refill *************** *** 2369,2376 **** \cindex{Refill} \findex{refill} ! If a paragraph contains sizable constructs, it may look badly filled ! after \code{latexinfo-format-buffer} is through with it. Put \code{\back refill} at the end of the paragraph to tell \code{latexinfo-format-buffer} to refill the paragraph after finishing all other processing on it. \code{\back refill} has no effect on --- 2377,2384 ---- \cindex{Refill} \findex{refill} ! If a paragraph contains sizable constructs, it may look badly filled after\\ ! \code{latexinfo-format-buffer} is through with it. Put \code{\back refill} at the end of the paragraph to tell \code{latexinfo-format-buffer} to refill the paragraph after finishing all other processing on it. \code{\back refill} has no effect on *************** *** 2410,2416 **** \cindex{Noindent} \findex{noindent} ! If you have text following a \code{example} or other similar ``special paragraph'' that reads as a continuation of the text before the \code{example}, it is good to prevent this text from being indented as a new paragraph. To accomplish this, put \code{\back noindent} on a line --- 2418,2424 ---- \cindex{Noindent} \findex{noindent} ! If you have text following an \code{example} or other similar ``special paragraph'' that reads as a continuation of the text before the \code{example}, it is good to prevent this text from being indented as a new paragraph. To accomplish this, put \code{\back noindent} on a line *************** *** 2452,2460 **** from one page to the next. \begin{description} ! \item[\back *] ! Force a line break in the printed manual. This ! command has no effect on the Info file.\refill \item[\back sp] Generate blank lines in both the printed manual and in the Info file.\refill --- 2460,2469 ---- from one page to the next. \begin{description} ! \item[\back \back] ! Force a line break in the printed manual. This command has no effect on ! the Info file. (For compatibility with \TeX info, \code{\back *} also ! forces a line break in the printed manual.)\refill \item[\back sp] Generate blank lines in both the printed manual and in the Info file.\refill *************** *** 2663,2669 **** * Ctrl:: Indicates the ASCII control character. * Var:: A variable. * Dfn:: The introductory or defining use of a term. ! * Cite:: The name of a BiBTeX entry. \end{menu} \node Code, Samp, Specifying Definitions Files and Commands, Specifying Definitions Files and Commands --- 2672,2678 ---- * Ctrl:: Indicates the ASCII control character. * Var:: A variable. * Dfn:: The introductory or defining use of a term. ! * Cite:: The name of a bibliography entry. \end{menu} \node Code, Samp, Specifying Definitions Files and Commands, Specifying Definitions Files and Commands *************** *** 2873,2884 **** \findex{ctrl} \code{\back ctrl} is used to describe an ASCII control character. The pattern ! of usage is \code{\back ctrl\{\var{ch}\}}, where \var{ch} is an ASCII character ! whose control-equivalent is wanted. Thus, you put in an \samp{f} when ! you want to indicate a \samp{control-f} - Thus, to specify \samp{control-f}, you would enter - \begin{example} \back ctrl\{f\} \end{example} --- 2882,2892 ---- \findex{ctrl} \code{\back ctrl} is used to describe an ASCII control character. The pattern ! of usage is \code{\back ctrl\{\var{ch}\}}, where \var{ch} is an ASCII ! character whose control-equivalent is wanted. Thus you put in an \samp{f} ! when you want to indicate a \samp{control-f}. For example, to specify ! \samp{control-f}, you would enter \begin{example} \back ctrl\{f\} \end{example} *************** *** 2890,2895 **** --- 2898,2904 ---- \ctrl{f} \end{quotation} + \noindent In the Info file, this generates the specified control character, output literally into the file. This is done so a user can copy the specified control character (along with whatever else he or she wants) into another *************** *** 2911,2922 **** arguments that are passed to that function. \code{\back var} is not used for names of particular variables in programming ! languages. For example, the \LaTeX info variable \code{latexinfo-tex-command} is ! not a metasyntactic variable. - Its effect in the Info file is to upcase the argument; in the printed - manual, to italicize it. Example: - \begin{example} To delete file \back var\{filename\}, type \back code\{rm \back var\{filename\}\}. \end{example} --- 2920,2930 ---- arguments that are passed to that function. \code{\back var} is not used for names of particular variables in programming ! languages. For example, the \LaTeX info variable ! \code{latexinfo-tex-command} is not a metasyntactic variable. ! Its effect in the Info file is to to convert the argument to uppercase; in ! the printed manual, to italicize it. For, example: \begin{example} To delete file \back var\{filename\}, type \back code\{rm \back var\{filename\}\}. \end{example} *************** *** 2964,2975 **** \findex{cite} \code{\back cite} is the \LaTeX\ command for a bibliographic citations. ! Citations are prepared using the program \t{BibTeX}, which formats the ! citations for use with \LaTeX. The argument to the \code{\back cite} command is the citation key, which appears in the printed manual as the citation key surrounded by square brackets. How it appears in the printed ! manual is dependent on the bibliographic style chosen. ! See the \LaTeX\ Manual for more details (\cite{Lamport}).\refill Before you use the \code{\back cite} command, you must declare the bibliography style that you are going to use. --- 2972,2983 ---- \findex{cite} \code{\back cite} is the \LaTeX\ command for a bibliographic citations. ! Citations are usually prepared using the program \t{BibTeX}, which formats ! the citations for use with \LaTeX. The argument to the \code{\back cite} command is the citation key, which appears in the printed manual as the citation key surrounded by square brackets. How it appears in the printed ! manual is dependent on the bibliographic style chosen. See the \LaTeX\ ! Manual for more details (\cite{Lamport}).\refill Before you use the \code{\back cite} command, you must declare the bibliography style that you are going to use. *************** *** 2984,2990 **** \cindex{Commands to insert single characters} \samp{\back } and curly braces are special characters in \LaTeX info. ! To insert a parenthese you have to put a \samp{\back } in front of these characters in order to insert them into text. To insert a backslash, you must use the \code{\back back} command. --- 2992,2998 ---- \cindex{Commands to insert single characters} \samp{\back } and curly braces are special characters in \LaTeX info. ! To insert parentheses, you have to put a \samp{\back } in front of these characters in order to insert them into text. To insert a backslash, you must use the \code{\back back} command. *************** *** 3214,3220 **** are writing different sections of a document simultaneously. Input files are simply inserted at the place where the \code{input} command ! occurs, both in the Infor file and the \LaTeX\ file. \begin{menu} * Input Files:: --- 3222,3228 ---- are writing different sections of a document simultaneously. Input files are simply inserted at the place where the \code{input} command ! occurs, both in the Info file and the \LaTeX\ file. \begin{menu} * Input Files:: *************** *** 3263,3279 **** An \code{\back include} file should not start with \samp{\back documentstyle[latexinfo]}, as that has already been done by ! the outer file, and the character \samp{\back } has already been ! redefined to generate a backslash in the output. Instead, a \code{\back ! include} file usually begins with a node; it lacks the beginning and ! ending of a ! \LaTeX info file that are described in the chapters on beginning and ! Ending a LaTeXinfo File. \xref{Beginning a LaTeXinfo File}, and ! \pxref{Ending a LaTeXinfo File}. Likewise, a \code{\back include} file ! should not end with \code{\back end\{document\}}, since that would ! terminate \LaTeX\ processing immediately.\refill ! Here is an example of a outer \LaTeX info file with \code{\back include} files within it:\refill \clearpage --- 3271,3284 ---- An \code{\back include} file should not start with \samp{\back documentstyle[latexinfo]}, as that has already been done by ! the outer file. A \code{\back include} file usually begins with a node; it ! lacks the beginning and ending of a \LaTeX info file that are described in ! the chapters on beginning and Ending a LaTeXinfo File. \xref{Beginning a ! LaTeXinfo File}, and \pxref{Ending a LaTeXinfo File}. Likewise, a ! \code{\back include} file should not end with \code{\back end\{document\}}, ! since that would terminate \LaTeX\ processing immediately.\refill ! Here is an example of an outer \LaTeX info file with \code{\back include} files within it:\refill \clearpage *************** *** 3325,3330 **** --- 3330,3337 ---- \findex{ifinfo} \findex{iftex} \findex{ignore} + \findex{c} + \findex{comment} You may not always be able to use the same text for both the printed manual and the on-line Info file. In this case, you can use the conditional *************** *** 3372,3378 **** --- 3379,3390 ---- lines delimit text that will not appear in either the Info file or the printed manual.\refill + The \code{\back comment} or \code{\back c} command introduces comments that + will not appear in either the Info file or the printed manual; anything + following the \code{\back c} command will be ignored, up to and including + the end of the line. + \begin{menu} * Using LaTex Commands:: Using commands from regular LaTeX. \end{menu} *************** *** 3397,3406 **** \end{verbatim} \noindent ! is how you would include a \LaTeX\ bibliography. ! In the Info file, nothing between \code{\back begin\{tex\}} and ! \code{\back end\{tex\}} will appear, i.e\. \code{tex} implies \code{iftex}. ! .\refill \node Printing Hardcopy, Formatting Requirements, Using LaTeX Commands, Top \chapter{Printing Hardcopy} --- 3409,3417 ---- \end{verbatim} \noindent ! is how you would include a \LaTeX\ bibliography. In the Info file, nothing ! between \code{\back begin\{tex\}} and \code{\back end\{tex\}} will appear, ! i.e\. \code{tex} implies \code{iftex}.\refill \node Printing Hardcopy, Formatting Requirements, Using LaTeX Commands, Top \chapter{Printing Hardcopy} *************** *** 3417,3430 **** commands, you can either work directly in the operating system shell or work within a shell inside of GNU Emacs. ! The typesetting program \LaTeX\ is used for formatting a \LaTeX info ! file. \LaTeX\ is a very powerful typesetting program and, if used ! right, does an exceptionally good job. The commands in a \LaTeX info ! file are defined by a file called \file{latexinfo.sty} into make \LaTeX\ ! understand them. (That is why the beginning of every \LaTeX info file ! starts with the line that says \samp{\back documentstyle[latexinfo]}; ! this command tells \LaTeX\ to use the\* ! \file{latexinfo.sty} file in processing the \LaTeX info file.) \code{latexinfo-format-buffer} reads the very same commands in the \LaTeX info file and processes them differently from \LaTeX\ to make an Info file.\refill --- 3428,3440 ---- commands, you can either work directly in the operating system shell or work within a shell inside of GNU Emacs. ! The typesetting program \LaTeX\ is used for formatting a \LaTeX info file. ! \LaTeX\ is a very powerful typesetting program and, if used correctly, does ! an exceptionally good job. The macros used in a \LaTeX info file are ! defined by a file called \file{latexinfo.sty}, which is why the beginning ! of every \LaTeX info file starts with the line that says\\ ! \samp{\back documentstyle[latexinfo]}; this command tells \LaTeX\ to use the ! \file{latexinfo.sty} file in processing the \LaTeX info file. \code{latexinfo-format-buffer} reads the very same commands in the \LaTeX info file and processes them differently from \LaTeX\ to make an Info file.\refill *************** *** 3444,3450 **** index output files for the input file \file{foo.texinfo} would be \file{foo.cp}, \file{foo.vr}, \file{foo.fn}, \file{foo.tp}, \file{foo.pg} and \file{foo.ky}. Those are exactly the arguments to ! give to \code{texindex}. Or else, you can use \samp{??} as ``wild-cards'' and give the command in this form:\refill \begin{example} --- 3454,3460 ---- index output files for the input file \file{foo.texinfo} would be \file{foo.cp}, \file{foo.vr}, \file{foo.fn}, \file{foo.tp}, \file{foo.pg} and \file{foo.ky}. Those are exactly the arguments to ! give to \code{texindex}. Or else, on UNIX, you can use \samp{??} as ``wild-cards'' and give the command in this form:\refill \begin{example} *************** *** 3470,3478 **** Run the shell command \code{texindex} on the raw index files to sort them. The arguments to \code{texindex} are the names of the raw index files. \code{texindex} creates sorted index files whose names are the names of the ! raw index files with an \samp{s} appended. To cause \code{texindex} to ! sort all the raw index files, append \samp{??} to the \LaTeX info file name in ! place of the \file{.texinfo} extension.\refill \item Rerun the \LaTeX\ command on the \LaTeX info file. This regenerates a formatted --- 3480,3486 ---- Run the shell command \code{texindex} on the raw index files to sort them. The arguments to \code{texindex} are the names of the raw index files. \code{texindex} creates sorted index files whose names are the names of the ! raw index files with an \samp{s} appended.\refill \item Rerun the \LaTeX\ command on the \LaTeX info file. This regenerates a formatted *************** *** 3553,3558 **** --- 3561,3567 ---- \end{document} \end{verbatim} + \noindent which terminates \LaTeX\ processing and forces out unfinished pages. You also have to include a line that specifies the Info file name. *************** *** 3591,3603 **** \LaTeX\ lines are in `horizontal boxes', hence the term, `hbox'.) If the \LaTeX info file has an overfull hbox, you can rewrite the sentence ! so the overfull hbox does not occur or you can decide to leave it. A ! small excursion into the right margin often does not matter and may not ! even be noticable. However, unless told otherwise, \LaTeX\ will print a ! large, ugly, black rectangle beside every line that is overfull. This is ! so you will notice the location of the problem if you are correcting a ! draft. To prevent such monstrosities from marring your final printout, ! put the following in the beginning of the \LaTeX info file before the \code{\back setfilename} command: \begin{verbatim} \finalout --- 3600,3613 ---- \LaTeX\ lines are in `horizontal boxes', hence the term, `hbox'.) If the \LaTeX info file has an overfull hbox, you can rewrite the sentence ! so the overfull hbox does not occur or you can decide to leave it. A small ! excursion into the right margin often does not matter and may not even be ! noticable. However, unless told otherwise, \LaTeX\ will print a large, ! ugly, black rectangle beside every line that is overfull. This is so you ! will notice the location of the problem if you are correcting a draft. To ! prevent such monstrosities from marring your final printout, put the ! following in the beginning of the \LaTeX info file before the \code{\back ! setfilename} command: \begin{verbatim} \finalout *************** *** 3661,3668 **** \noindent A new buffer is created and the Info file text is generated there. ! \ctrl{x} \ctrl{s} will save it under the name specified in the ! \code{\back setfilename} command.\refill If the \LaTeX info file has more than 30,000 bytes, \code{latexinfo-format-buffer} will automatically create a \dfn{tag --- 3671,3678 ---- \noindent A new buffer is created and the Info file text is generated there. ! \ctrl{x} \ctrl{s} (\code{save-buffer}) will save it under the name ! specified in the \code{\back setfilename} command.\refill If the \LaTeX info file has more than 30,000 bytes, \code{latexinfo-format-buffer} will automatically create a \dfn{tag *************** *** 3672,3678 **** into shorter Indirect subfiles of about 50,000 bytes each. Files are split so that Info does not have to make a large buffer to hold the whole of a large Info file; instead, Info allocates just enough memory ! for the small, split off file that is needed at the time. This way, Emacs avoids wasting memory when you run Info. (Before splitting was implemented, Info files were always short and \dfn{include} files were designed as a way to create a single, large printed manual out of the --- 3682,3688 ---- into shorter Indirect subfiles of about 50,000 bytes each. Files are split so that Info does not have to make a large buffer to hold the whole of a large Info file; instead, Info allocates just enough memory ! for the small, split--off file that is needed at the time. This way, Emacs avoids wasting memory when you run Info. (Before splitting was implemented, Info files were always short and \dfn{include} files were designed as a way to create a single, large printed manual out of the *************** *** 3681,3689 **** When the file is split, Info itself works through a shortened version of the original file that contains the tag table and references to the files ! that were split off. The split off files are called \dfn{indirect} files. ! The split off files have names that are created by appending \samp{-1}, \samp{-2}, \samp{-3} and so on to the file names specified by the \code{\back setfilename} command. The shortened version of the original file continues to have the name specified by \code{\back setfilename}. --- 3691,3699 ---- When the file is split, Info itself works through a shortened version of the original file that contains the tag table and references to the files ! that were split--off. The split--off files are called \dfn{indirect} files. ! The split--off files have names that are created by appending \samp{-1}, \samp{-2}, \samp{-3} and so on to the file names specified by the \code{\back setfilename} command. The shortened version of the original file continues to have the name specified by \code{\back setfilename}. *************** *** 3695,3701 **** Info file: test-texinfo, -*-Text-*- produced by latexinfo-format-buffer from file: new-texinfo-manual.texinfo - ^_ Indirect: test-texinfo-1: 102 --- 3705,3710 ---- *************** *** 3709,3715 **** \noindent (But \file{test-texinfo} had far more nodes than are shown here.) Each of ! the split off, indirect files, \file{test-texinfo-1}, \file{test-texinfo-2}, and \file{test-texinfo-3}, is listed in this file after the line that says \samp{Indirect:}. The tag table is listed after the line that says \samp{Tag table:}. \refill --- 3718,3724 ---- \noindent (But \file{test-texinfo} had far more nodes than are shown here.) Each of ! the split--off, indirect files, \file{test-texinfo-1}, \file{test-texinfo-2}, and \file{test-texinfo-3}, is listed in this file after the line that says \samp{Indirect:}. The tag table is listed after the line that says \samp{Tag table:}. \refill *************** *** 3734,3746 **** An Info file is usually installed in the GNU Emacs directory called \file{info}. This directory is the values of the Emacs variable \code{Info-directory}. For Info to work, this directory must contain ! all the Info files, including the split off files. In addition, the ! \file{info} directory must have a file that serves as a top level directory for the Info system. This file is called \file{dir}. For example, in the \file{info} directory, the file called \file{dir} ! has the top level menu for all the Info files in the system. This directory is the one defined by the GNU Emacs variable \code{Info-directory}. This file has a master menu that looks like this: --- 3743,3755 ---- An Info file is usually installed in the GNU Emacs directory called \file{info}. This directory is the values of the Emacs variable \code{Info-directory}. For Info to work, this directory must contain ! all the Info files, including the split--off files. In addition, the ! \file{info} directory must have a file that serves as a top--level directory for the Info system. This file is called \file{dir}. For example, in the \file{info} directory, the file called \file{dir} ! has the top--level menu for all the Info files in the system. This directory is the one defined by the GNU Emacs variable \code{Info-directory}. This file has a master menu that looks like this: *************** *** 3783,3789 **** Let's say that you wanted to develop a special format for a program called \code{macsyma}, which defined the command \code{\back f} to be ! used for specifying function. This command would put its argument in the function index, and set the function in the printed manual in a special font. You could create a style file called \file{macsyma.sty} that contained this definition (and any others you might want for --- 3792,3798 ---- Let's say that you wanted to develop a special format for a program called \code{macsyma}, which defined the command \code{\back f} to be ! used for specifying functions. This command would put its argument in the function index, and set the function in the printed manual in a special font. You could create a style file called \file{macsyma.sty} that contained this definition (and any others you might want for *************** *** 3851,3857 **** the nodes and chapters. There are two tools for catching the first kind of mistake and two for catching the second. ! For finding problems with commands, your best action is to run\* \kbd{M-x latexinfo-format-region} on regions of your file as you write it. In \LaTeX info mode, the \code{latexinfo-format-region} command is bound to \ctrl{c} \ctrl{f}. In addition, you can run \LaTeX\ on the --- 3860,3866 ---- the nodes and chapters. There are two tools for catching the first kind of mistake and two for catching the second. ! For finding problems with commands, your best action is to run\\ \kbd{M-x latexinfo-format-region} on regions of your file as you write it. In \LaTeX info mode, the \code{latexinfo-format-region} command is bound to \ctrl{c} \ctrl{f}. In addition, you can run \LaTeX\ on the *************** *** 3874,3880 **** \cindex{Catching errors with Info Formatting} \cindex{Debugging with Info Formatting} ! After you have written part of a \LaTeX info file, you can use the\* \kbd{M-x latexinfo-format-region} command to see whether the region formats properly. In LaTeXinfo Mode, this command is bound to the keyboard command \ctrl{c} \ctrl{f}. If you have made a mistake with a --- 3883,3889 ---- \cindex{Catching errors with Info Formatting} \cindex{Debugging with Info Formatting} ! After you have written part of a \LaTeX info file, you can use the\\ \kbd{M-x latexinfo-format-region} command to see whether the region formats properly. In LaTeXinfo Mode, this command is bound to the keyboard command \ctrl{c} \ctrl{f}. If you have made a mistake with a *************** *** 3908,3918 **** it produced output that looked like this: \begin{example} ! name of the latexinfo file as an extension. The `??' are `wildcards' ! that cause the shell to substitute all the raw index files. (*Note for more information about sorting indices.) \back refill \back cindex Sorting indices \back cindex Indices: sorting indices), rerun the TeX command on the latexinfo file. This ! regenerates a formatted DVI file with the index entries in the correct ! order. This second run also makes all the cross references and table of ! contents correct as well. \end{example} \noindent --- 3917,3927 ---- it produced output that looked like this: \begin{example} ! name of the latexinfo file as an extension. The `??' are `wildcards' ! that cause the shell to substitute all the raw index files. (*Note for more information about sorting indices.) \back refill \back cindex Sorting indices \back cindex Indices: sorting indices), rerun the TeX command on the latexinfo file. This ! regenerates a formatted DVI file with the index entries in the correct ! order. This second run also makes all the cross references and table of ! contents correct as well. \end{example} \noindent *************** *** 3984,3994 **** The backtrace is read from the bottom up. \code{latexinfo-format-region} was called interactively; and it in turn called various functions, including ! \code{latexinfo-format-scan}, \code{latexinfo-format-xref}\* ! and \code{latexinfo-format-parse-args}. Inside the function ! \code{latexinfo-format-parse-args}, the function \code{re-search-forward} was ! called; it was this function that could not find the missing right hand ! brace.\refill \xref{Lisp Debug, , Debugging Emacs Lisp, emacs, The GNU Emacs Manual}, for more information.\refill --- 3993,4004 ---- The backtrace is read from the bottom up. \code{latexinfo-format-region} was called interactively; and it in turn called various functions, including ! \code{latexinfo-format-scan},\\ ! \code{latexinfo-format-xref} and \code{latexinfo-format-parse-args}. ! Inside the function\\ ! \code{latexinfo-format-parse-args}, the function ! \code{re-search-forward} was called; it was this function that could not ! find the missing right hand brace.\refill \xref{Lisp Debug, , Debugging Emacs Lisp, emacs, The GNU Emacs Manual}, for more information.\refill *************** *** 4001,4010 **** You can also catch mistakes when you format a file with \LaTeX. Usually, you will want to do this after you have run ! \code{latexinfo-format-buffer} on the same file. ! \code{latexinfo-format-buffer} is usually faster and sometimes gives ! error messages that make more sense. \xref{Catching Errors with Info ! Formatting}, for more information.\refill \clearpage For example, \LaTeX\ was run on the same itemized list discussed in the --- 4011,4019 ---- You can also catch mistakes when you format a file with \LaTeX. Usually, you will want to do this after you have run ! \code{latexinfo-format-buffer} on the same file, as it ! is usually faster and sometimes gives error messages that make more sense. ! \xref{Catching Errors with Info Formatting}, for more information.\refill \clearpage For example, \LaTeX\ was run on the same itemized list discussed in the *************** *** 4106,4119 **** or adding to a \LaTeX info file that someone else has written. In GNU Emacs, in LaTeXinfo Mode, there is a command that will list all the ! lines that begin with the commands that specify the structure: ! \code{\back node}, \code{\back chapter}, \code{\back section}, ! \code{\back appendix} and so on. This is the\* ! \code{latexinfo-show-structure} command. It is bound to the keyboard command ! \ctrl{c} \ctrl{s}. \code{latexinfo-show-structure} displays the lines that ! begin with the node and chapter structuring commands in another window ! called the \samp{*Occur*} buffer. For example, when it is run on the ! first part of this chapter, it produces the following:\refill \begin{example} Lines matching --- 4115,4128 ---- or adding to a \LaTeX info file that someone else has written. In GNU Emacs, in LaTeXinfo Mode, there is a command that will list all the ! lines that begin with the commands that specify the structure: \code{\back ! node}, \code{\back chapter}, \code{\back section}, \code{\back appendix} ! and so on. This is the \code{latexinfo-show-structure} command. It is ! bound to the keyboard command \ctrl{c} \ctrl{s}. ! \code{latexinfo-show-structure} displays the lines that begin with the node ! and chapter structuring commands in another window called the ! \samp{*Occur*} buffer. For example, when it is run on the first part of ! this chapter, it produces the following:\refill \begin{example} Lines matching *************** *** 4129,4135 **** \code{\back chapter}, \code{\back node}, and \code{\back section} respectively. If you move your cursor into the \samp{*Occur*} window, you can position the cursor over one of the lines and use the \ctrl{c} \ctrl{c} ! command (\code{occur-mode-goto-occurrence}), to jump to the corresponding spot in the \LaTeX info file. \xref{Other Repeating Search, , Using Occur, emacs, The GNU Emacs Manual}, for more information about \code{occur-mode-goto-occurrence}.\refill --- 4138,4145 ---- \code{\back chapter}, \code{\back node}, and \code{\back section} respectively. If you move your cursor into the \samp{*Occur*} window, you can position the cursor over one of the lines and use the \ctrl{c} \ctrl{c} ! command\\ ! (\code{occur-mode-goto-occurrence}), to jump to the corresponding spot in the \LaTeX info file. \xref{Other Repeating Search, , Using Occur, emacs, The GNU Emacs Manual}, for more information about \code{occur-mode-goto-occurrence}.\refill *************** *** 4136,4142 **** The first line in the \samp{*Occur*} window describes the \dfn{regular expression} specified by \var{latexinfo-heading-pattern}. This regular ! expression is the pattern that \code{latexinfo-show-structure} looks for. \xref{Regexps, , Using Regular Expressions, emacs, The GNU Emacs Manual}, for more information.\refill --- 4146,4153 ---- The first line in the \samp{*Occur*} window describes the \dfn{regular expression} specified by \var{latexinfo-heading-pattern}. This regular ! expression is the pattern that\\ ! \code{latexinfo-show-structure} looks for. \xref{Regexps, , Using Regular Expressions, emacs, The GNU Emacs Manual}, for more information.\refill *************** *** 4180,4190 **** the cursor in the buffer to the end of the buffer. If you want to run \code{occur} on the whole buffer, place the cursor at the beginning of the buffer. For example, to see all the lines that contain the word ! \samp{\back chapter} in them, just type \samp{\back \back chapter}. This will produce a list of the chapters. It will also list all the ! sentences with \samp{\back \back chapter} in the middle of the line. If you want to see only those lines that start with the word ! \samp{\back back chapter}, type \samp{^\back chapter} when prompted by \code{occur}. If you want to see all the lines that end with a word or phrase, end the last word with a \samp{$}; for example, \samp{catching mistakes$}. This can be helpful when you want to see all the nodes that --- 4191,4201 ---- the cursor in the buffer to the end of the buffer. If you want to run \code{occur} on the whole buffer, place the cursor at the beginning of the buffer. For example, to see all the lines that contain the word ! \samp{\back chapter} in them, just type \samp{\back chapter}. This will produce a list of the chapters. It will also list all the ! sentences with \samp{\back chapter} in the middle of the line. If you want to see only those lines that start with the word ! \samp{\back chapter}, type \samp{^\back chapter} when prompted by \code{occur}. If you want to see all the lines that end with a word or phrase, end the last word with a \samp{$}; for example, \samp{catching mistakes$}. This can be helpful when you want to see all the nodes that *************** *** 4277,4283 **** table. When you have done this, you can run \code{Info-validate} and look for badly referenced nodes.\refill ! After you have validated the node structure, you can rerun\* \code{latexinfo-format-buffer} in the normal way so it will construct the tag table and split the file automatically or, you can make the tag table and split the file manually. To prevent the --- 4288,4294 ---- table. When you have done this, you can run \code{Info-validate} and look for badly referenced nodes.\refill ! After you have validated the node structure, you can rerun\\ \code{latexinfo-format-buffer} in the normal way so it will construct the tag table and split the file automatically or, you can make the tag table and split the file manually. To prevent the *************** *** 4310,4322 **** M-x Info-tagify \end{example} ! This creates a file which you can validate.\refill \begin{example} M-x Info-validate \end{example} ! After you have checked the validity of the nodes, you can either run\* \kbd{M-x latexinfo-format-buffer} as you would normally, or else tagify and split the file manually with the two commands \code{Info-tagify} and \code{Info-split}.\refill --- 4321,4333 ---- M-x Info-tagify \end{example} ! This creates a file which you can validate:\refill \begin{example} M-x Info-validate \end{example} ! After you have checked the validity of the nodes, you can either run\\ \kbd{M-x latexinfo-format-buffer} as you would normally, or else tagify and split the file manually with the two commands \code{Info-tagify} and \code{Info-split}.\refill *************** *** 4330,4336 **** else let the \code{latexinfo-format-buffer} command do it for you automatically. (Generally you will let \code{latexinfo-format-buffer} do this job for you. \xref{Creating an On-line Info File}.) ! The split off files are called the indirect subfiles.\refill Info files are split to save memory. With smaller files, Emacs does not have make such a large buffer to hold the information. This way, Emacs --- 4341,4347 ---- else let the \code{latexinfo-format-buffer} command do it for you automatically. (Generally you will let \code{latexinfo-format-buffer} do this job for you. \xref{Creating an On-line Info File}.) ! The split--off files are called the indirect subfiles.\refill Info files are split to save memory. With smaller files, Emacs does not have make such a large buffer to hold the information. This way, Emacs *************** *** 4391,4400 **** Formatting a part of a file for Info, rather than the whole file. \end{itemize} ! In general, in LaTeXinfo Mode, the GNU Emacs editing commands are like those ! in text-mode. The major difference is that the paragraph separation ! variable and syntax table are set up so expression commands skip \LaTeX info ! bracket groups. This means, for example, that the\* \kbd{M-q} (\code{fill-paragraph}) command will refill a paragraph but not the command on a line adjacent to it.\refill --- 4402,4411 ---- Formatting a part of a file for Info, rather than the whole file. \end{itemize} ! In general, in LaTeXinfo Mode, the GNU Emacs editing commands are like ! those in text-mode. The major difference is that the paragraph separation ! variable and syntax table are set up so expression commands skip \LaTeX ! info bracket groups. This means, for example, that the \kbd{M-q} (\code{fill-paragraph}) command will refill a paragraph but not the command on a line adjacent to it.\refill *************** *** 4419,4425 **** \samp{*Info Region*}.\refill For \code{latexinfo-format-region} to work, the file \strong{must} include a ! line that has\* \code{\back setfilename} in its header.\refill \comment node-name, next, previous, up --- 4430,4436 ---- \samp{*Info Region*}.\refill For \code{latexinfo-format-region} to work, the file \strong{must} include a ! line that has\\ \code{\back setfilename} in its header.\refill \comment node-name, next, previous, up *************** *** 4431,4448 **** \cindex{LaTeXinfo file structure, showing it} You can show the structure of a \LaTeX info file by using the \ctrl{c} ! \ctrl{s} command\* ! (\code{latexinfo-show-structure}). This command shows the structure of ! a \LaTeX info file by listing the lines with the commands for \code{\back{}node}, \code{\back{}chapter}, \code{\back{}section} and the like. These lines are displayed in another window called the \samp{*Occur*} window. In that window, you can position the cursor over one of the lines and use the \ctrl{c} \ctrl{c} command (\code{occur-mode-goto-occurrence}), to jump to the ! corresponding spot in the \LaTeX info file.\refill - The two commands are: - \begin{description} \item[C-c C-s ] latexinfo-show-structure --- 4442,4457 ---- \cindex{LaTeXinfo file structure, showing it} You can show the structure of a \LaTeX info file by using the \ctrl{c} ! \ctrl{s} command\\ ! (\code{latexinfo-show-structure}). This command shows the structure of a ! \LaTeX info file by listing the lines with the commands for \code{\back{}node}, \code{\back{}chapter}, \code{\back{}section} and the like. These lines are displayed in another window called the \samp{*Occur*} window. In that window, you can position the cursor over one of the lines and use the \ctrl{c} \ctrl{c} command (\code{occur-mode-goto-occurrence}), to jump to the ! corresponding spot in the \LaTeX info file. The two commands are:\refill \begin{description} \item[C-c C-s ] latexinfo-show-structure *************** *** 4465,4479 **** \cindex{Frequently used commands, inserting them} \cindex{Commands, inserting them} ! \LaTeX info Mode provides commands that insert various frequently used commands into the buffer. You can use these commands to save ! keystrokes. And you can insert balanced curly braces with the\* ! \kbd{M-\{} command, (\code{latexinfo-insert-braces}) and later use the \kbd{M-\}} command (\code{up-list}) to move forward past the closing brace. - \refill - The special commands are invoked by typing \kbd{C-c} twice and then the ! first letter of the command. \begin{description} \item[C-c C-c c] --- 4474,4486 ---- \cindex{Frequently used commands, inserting them} \cindex{Commands, inserting them} ! \LaTeX info mode provides commands that insert various frequently used commands into the buffer. You can use these commands to save ! keystrokes. And you can insert balanced curly braces with the ! \kbd{M-\{} command, (\code{latexinfo-insert-braces}) and later use the \kbd{M-\}} command (\code{up-list}) to move forward past the closing brace. The special commands are invoked by typing \kbd{C-c} twice and then the ! first letter of the command.\refill \begin{description} \item[C-c C-c c] *************** *** 4585,4591 **** WARRANTY sections of a document, see the latest version of the GNU Emacs Manual \cite{GNUEmacsManual}. ! The texts of the Free Software Foundation copying permission notice in the \code{\back begin\{ifinfo\}} section and in the Titlepage section are slightly different. --- 4592,4598 ---- WARRANTY sections of a document, see the latest version of the GNU Emacs Manual \cite{GNUEmacsManual}. ! The texts of the Free Software Foundation copying permission notice in the\\ \code{\back begin\{ifinfo\}} section and in the Titlepage section are slightly different. *************** *** 4610,4617 **** In the printed manual, the Free Software Foundation copying permission notice follows the copyright notice and publishing information and is ! located before the \code{\back setfilename}. The copying permission ! notice is exactly the same as the notice in the \code{\back begin\{ifinfo\}} section except that the paragraph enclosed in \code{\back begin\{ignore\}} and \code{\back end\{ignore\}} commands is not part of the notice.\refill --- 4617,4625 ---- In the printed manual, the Free Software Foundation copying permission notice follows the copyright notice and publishing information and is ! located before the\\ ! \code{\back setfilename}. The copying permission ! notice is exactly the same as the notice in the \code{\back begin\{ifinfo\}} section except that the paragraph enclosed in \code{\back begin\{ignore\}} and \code{\back end\{ignore\}} commands is not part of the notice.\refill *************** *** 4702,4713 **** \cindex{LaTeXinfo and TeXinfo} Documentation for GNU utilities and libraries is usually written in a ! format called \dfn{\TeX info}. Prehaps the most significant difference of \LaTeX info from \TeX info is that if a \LaTeX\ command is found that ! the Info formatter does not know about, a error is not signalled, and processing simply continues. This means that as long as you don't mind ! having the commands ignored in the Info file, you can use any \LaTeX ! command. \node Differences from TeXinfo, Differences from LaTeX, LateXinfo and TeXinfo, LateXinfo and TeXinfo \section{Differences from TeXinfo} --- 4710,4720 ---- \cindex{LaTeXinfo and TeXinfo} Documentation for GNU utilities and libraries is usually written in a ! format called \dfn{\TeX info}. Perhaps the most significant difference of \LaTeX info from \TeX info is that if a \LaTeX\ command is found that ! the Info formatter does not know about, an error is not signalled, and processing simply continues. This means that as long as you don't mind ! having the commands ignored in the Info file, you can use any \LaTeX\ command. \node Differences from TeXinfo, Differences from LaTeX, LateXinfo and TeXinfo, LateXinfo and TeXinfo \section{Differences from TeXinfo} *************** *** 4841,4846 **** --- 4848,4854 ---- \end{table} \end{verbatim} + \begin{same} \noindent produces in the Info file \begin{verbatim} *************** *** 4853,4858 **** --- 4861,4867 ---- A 3 B 3 C 3 D 3 ------------------------------------------------------------------------ \end{verbatim} + \end{same} \begin{iftex} \noindent *************** *** 4921,4933 **** \noindent If you say \code{yes}, all the \code{@input} files will be included, so ! you can doo all of the subfiles at the same time. You will also be asked ! \code{Would you like all occurences of `@@' replaced by `@'?} This is normally the case, but if you say no, you will be asked ! \code{Would you like all occurences of `@@' replaced by `\back \back '?} \noindent You must choose one of these two options. --- 4930,4946 ---- \noindent If you say \code{yes}, all the \code{@input} files will be included, so ! you can doo all of the subfiles at the same time. You will also be asked: ! \begin{example} ! Would you like all occurences of `@@' replaced by `@'? ! \end{example} This is normally the case, but if you say no, you will be asked ! \begin{example} ! Would you like all occurences of `@@' replaced by `\back \back '? ! \end{example} \noindent You must choose one of these two options. diff -cr /tmp/old1.3.1/manual/makeinfo.el ./manual/makeinfo.el *** /tmp/old1.3.1/manual/makeinfo.el Wed Jul 25 13:20:59 1990 --- ./manual/makeinfo.el Sat Aug 25 00:27:48 1990 *************** *** 18,23 **** --- 18,26 ---- "head-fmt.el" "scheme-fmt.el" "tabular-fmt.el" + "praxis-fmt.el" + "tabular-fmt.el" + "tolatexinfo.el" "nodify.el")) (find-file "MANUAL.tex") 
