texinfo ChangeLog doc/texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       12/06/15 18:34:19

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 

Log message:
        remove long-obsolete @ignore blocks

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1374&r2=1.1375
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.446&r2=1.447

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1374
retrieving revision 1.1375
diff -u -b -r1.1374 -r1.1375
--- ChangeLog   15 Jun 2012 18:31:38 -0000      1.1374
+++ ChangeLog   15 Jun 2012 18:34:19 -0000      1.1375
@@ -1,6 +1,8 @@
 2012-06-15  Karl Berry  <address@hidden>
 
-       * doc/texinfo.txi: remove all now-unnecessary @refill's.
+       * doc/texinfo.txi: remove all now-unnecessary @refill's
+       and @ignore blocks relating to the long-gone @ctrl and @br,
+       for source clarity.
 
 2012-06-14  Patrice Dumas  <address@hidden>
         and Karl Berry  <address@hidden>

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.446
retrieving revision 1.447
diff -u -b -r1.446 -r1.447
--- doc/texinfo.txi     15 Jun 2012 18:31:38 -0000      1.446
+++ doc/texinfo.txi     15 Jun 2012 18:34:19 -0000      1.447
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.446 2012/06/15 18:31:38 karl Exp $
address@hidden $Id: texinfo.txi,v 1.447 2012/06/15 18:34:19 karl Exp $
 @c Ordinarily, Texinfo files have the extension .texi.  But texinfo.texi
 @c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
 
@@ -7117,10 +7117,6 @@
 Indicate an electronic mail address.
 @xref{email,,@code{@@email}}.
 
address@hidden
address@hidden @@address@hidden@address@hidden
-Use for an ASCII control character.
address@hidden ignore
 @end table
 
 
@@ -7684,54 +7680,6 @@
 to say explicitly that it is a definition, but it should contain the
 information of a definition---it should make the meaning clear.
 
address@hidden
address@hidden node ctrl, , cite, Indicating
address@hidden subsection @code{@@address@hidden@address@hidden
address@hidden ctrl
-
-The @code{@@ctrl} command is seldom used.  It describes an ASCII
-control character by inserting the actual character into the Info
-file.
-
-Usually, in Texinfo, you talk what you type as keyboard entry by
-describing it with @code{@@kbd}: thus, @samp{@@address@hidden@}} for
address@hidden  Use @code{@@kbd} in this way when talking about a control
-character that is typed on the keyboard by the user.  When talking
-about a control character appearing in a file or a string, do not use
address@hidden@@kbd} since the control character is not typed.  Also, do not
-use @samp{C-} but spell out @code{control-}, as in @samp{control-a},
-to make it easier for a reader to address@hidden
-
address@hidden@@ctrl} is an idea from the beginnings of Texinfo which may not
-really fit in to the scheme of things.  But there may be times when
-you want to use the command.  The pattern is
address@hidden@@address@hidden@address@hidden, where @var{ch} is an ASCII 
character
-whose control-equivalent is wanted.  For example, to specify
address@hidden, you would address@hidden
-
address@hidden
-@@address@hidden@}
address@hidden example
-
address@hidden
-produces
-
address@hidden
address@hidden
address@hidden quotation
-
-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
-Emacs buffer and use it.  Since the `control-h',`control-i', and
-`control-j' characters are formatting characters, they should not be
-indicated with @code{@@address@hidden
-
-In a printed manual, @code{@@ctrl} generates text to describe or
-identify that control character: an uparrow followed by the character
address@hidden@refill
address@hidden ignore
-
 
 @node abbr
 @subsection @code{@@address@hidden@var{abbreviation}[, @address@hidden
@@ -12341,45 +12289,6 @@
 
 The @code{@@sp} command is most often used in the title page.
 
address@hidden
address@hidden node br, page, sp, Breaks
address@hidden section @code{@@br}: Generate Paragraph Breaks
address@hidden br @r{(paragraph breaks)}
address@hidden Paragraph breaks
address@hidden Breaks in a paragraph
-
-The @code{@@br} command forces a paragraph break.  It inserts a blank
-line.  You can use the command within or at the end of a line.  If
-used within a line, the @code{@@address@hidden@}} command must be followed by
-left and right braces (as shown here) to mark the end of the
-command.
-
address@hidden 700
-For example,
-
address@hidden
address@hidden
-This line @@address@hidden@}contains and is ended by paragraph breaks@@br
-and is followed by another line.
address@hidden group
address@hidden example
-
address@hidden
-produces
-
address@hidden
address@hidden
-This line
-
-contains and is ended by paragraph breaks
-
-and is followed by another line.
address@hidden group
address@hidden example
-
-The @code{@@br} command is seldom used.
address@hidden ignore
-
 
 @node page
 @section @code{@@page}: Start a New Page
@@ -20269,12 +20178,6 @@
 @item @@address@hidden@address@hidden
 Set @var{text} in a @b{bold} font.  No effect in Info.  @xref{Fonts}.
 
address@hidden
address@hidden @@br
-Force a paragraph break.  If used within a line, follow @code{@@br}
-with braces.  @xref{br, , @code{@@br}}.
address@hidden ignore
-
 @item @@address@hidden@}
 Generate a large round dot, @bullet{} (@samp{*} in Info).  Often used
 with @code{@@table}.  @xref{bullet, , @code{@@bullet}}.
@@ -20378,12 +20281,6 @@
 Generate the copyright symbol @copyright{}.  @xref{copyright symbol,,
 @code{@@address@hidden@}}}.
 
address@hidden
address@hidden @@address@hidden@address@hidden
-Describe an ASCII control character.  Insert actual control character
-into Info file.  @xref{ctrl, , @code{@@ctrl}}.
address@hidden ignore
-
 @item @@defcodeindex @var{index-name}
 Define a new index and its indexing command.  Print entries in an
 @code{@@code} font.  @xref{New Indices, , Defining New Indices}.
@@ -22096,7 +21993,7 @@
 Revision Control System}) or other version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.446 2012/06/15 18:31:38 karl Exp $
+$Id: texinfo.txi,v 1.447 2012/06/15 18:34:19 karl Exp $
 @end example
 (This is useful in all sources that use version control, not just manuals.)
 You may wish to include the @samp{$Id:} comment in the @code{@@copying}
@@ -22815,88 +22712,6 @@
 from the `Catching Mistakes' node by typing @kbd{l}
 (@code{Info-last}).)
 
address@hidden !!! section on using Elisp debugger ignored.
address@hidden
-Sometimes @code{texinfo-format-region} will stop long after the
-original error; this is because it does not discover the problem until
-then.  In this case, you will need to backtrack.
-
address@hidden menu
address@hidden * Using the Emacs Lisp Debugger::  How to use the Emacs Lisp 
debugger.
address@hidden end menu
-
address@hidden node Using the Emacs Lisp Debugger
address@hidden appendixsubsec Using the Emacs Lisp Debugger
address@hidden index Using the Emacs Lisp debugger
address@hidden index Emacs Lisp debugger
address@hidden index Debugger, using the Emacs Lisp
-
-If an error is especially elusive, you can turn on the Emacs Lisp
-debugger and look at the backtrace; this tells you where in the
address@hidden function the problem occurred.  You can
-turn on the debugger with the command:
-
address@hidden
-M-x set-variable @key{RET} debug-on-error @key{RET} t @key{RET}
address@hidden example
-
address@hidden
-and turn it off with
-
address@hidden
-M-x set-variable @key{RET} debug-on-error @key{RET} nil @key{RET}
address@hidden example
-
-Often, when you are using the debugger, it is easier to follow what is
-going on if you use the Emacs Lisp files that are not byte-compiled.
-The byte-compiled sources send octal numbers to the debugger that may
-look mysterious.  To use the uncompiled source files, load
address@hidden and @file{texinfo.el} with the @kbd{M-x load-file}
-command.
-
-The debugger will not catch an error if @code{texinfo-format-region}
-does not detect one.  In the example shown above,
address@hidden did not find the error when the whole
-list was formatted, but only when part of the list was formatted.
-When @code{texinfo-format-region} did not find an error, the debugger
-did not find one either.
-
-However, when @code{texinfo-format-region} did report an error, it
-invoked the debugger.  This is the backtrace it produced:
-
address@hidden
----------- Buffer: *Backtrace* ----------
-Signalling: (search-failed "address@hidden,]")
- re-search-forward("address@hidden,]")
- (while ...)
- (let ...)
- texinfo-format-parse-args()
- (let ...)
- texinfo-format-xref()
- funcall(texinfo-format-xref)
- (if ...)
- (let ...)
- (if ...)
- (while ...)
- texinfo-format-scan()
- (save-excursion ...)
- (let ...)
- texinfo-format-region(103370 103631)
-* call-interactively(texinfo-format-region)
----------- Buffer: *Backtrace* ----------
address@hidden example
-
-The backtrace is read from the bottom up.
address@hidden was called interactively; and it, in
-turn, called various functions, including @code{texinfo-format-scan},
address@hidden and @code{texinfo-format-parse-args}.
-Inside the function @code{texinfo-format-parse-args}, the function
address@hidden was called; it was this function that could
-not find the missing right-hand brace.
-
address@hidden Debug, , Debugging Emacs Lisp, emacs, The GNU Emacs
-Manual}, for more information.
address@hidden ignore
 
 @node Debugging with @TeX{}
 @section Debugging with @TeX{}
@@ -23319,13 +23134,6 @@
 will do this for a large, unsplit file on which you have run
 @code{Info-validate}.)
 
address@hidden Info-split is autoloaded in `loaddefs.el' in Emacs 18.51
address@hidden
-Before running @code{Info-split}, you need to load the @code{info} library
-into Emacs by giving the command @kbd{M-x load-library @key{RET} info
address@hidden
address@hidden ignore
-
 Visit the Info file you wish to tagify and split and type the two
 commands: