Date: Sun, 26 Jul 1998 19:14:26 +0300 (IDT)
From: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
To: Ralph Proctor <ralphgpr AT shadow DOT net>
cc: djgpp AT delorie DOT com
Subject: Re: "makeinfo --force"
In-Reply-To: <3.0.1.16.19980726103227.27cfba18@shadow.net>
Message-ID: <Pine.SUN.3.91.980726190954.27823C-100000@is>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Precedence: bulk


On Sun, 26 Jul 1998, Ralph Proctor wrote:

> At 12:23 PM 7/26/98 +0300, you wrote:
> 
> >> Has anybody ever had to use "--force" to get a good info file?

On my system, `makeinfo' complains loudly about calc.texinfo: 

  Making info file `calc.info' from `calc.texinfo'.
  calc.texinfo:245: warning: @ichapter is obsolete; use @chapter instead.
  ./calc.texinfo:296: Node `Copying''s Next field not pointed back to.
  ./calc.texinfo:522: This node (`Getting Started') is the one with the bad `Prev'.
  ./calc.texinfo:244: `Interactive Tutorial' has an Up field of `Top', but `Top' has no menu item for `Interactive Tutorial'.
  ./calc.texinfo:1571: warning: unreferenced node `Interactive Tutorial'.
  makeinfo.exe: Removing output file `calc.info' due to errors; use --force to preserve.

Your message made it sound as if `makeinfo' hangs when converting
calc.texinfo:

> Trying to convert a particular .tex file to an info file with
> "makeinfo calc.tex" did not work. It went through the long process of
> converting every segment with no error messages, but at the end there 
> was the blinking cursor forever--I had to reboot.

I cannot reproduce this behavior; please try to play with your system 
configuration and see what makes it hang like that.

Maybe it's the fact that you run `makeinfo' from Bash (I run it from the 
command.com prompt).

When `makeinfo' finds errors, it *always* removes the generated Info file
unless you use --force. 

Apply the following patch, and it should work without a glitch.  But I 
still would very much like to know why did it hang on the original file, 
so please try to investigate.

*** calc.t~0	Mon Dec 16 06:50:56 1996
--- calc.texinfo	Sun Jul 26 18:47:08 1998
***************
*** 241,248 ****
  
  @c [begin]
  @ifinfo
! @node Top, Getting Started,, (dir)
! @ichapter The GNU Emacs Calculator
  
  @noindent
  @dfn{Calc 2.02} is an advanced desk calculator and mathematical tool
--- 241,248 ----
  
  @c [begin]
  @ifinfo
! @node Top, Copying,, (dir)
! @chapter The GNU Emacs Calculator
  
  @noindent
  @dfn{Calc 2.02} is an advanced desk calculator and mathematical tool
***************
*** 264,269 ****
--- 264,270 ----
  
  * Getting Started::       General description and overview.
  * Tutorial::              A step-by-step introduction for beginners.
+ * Interactive Tutorial::
  
  * Introduction::          Introduction to the Calc reference manual.
  * Data Types::            Types of objects manipulated by Calc.
***************
*** 519,525 ****
  ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  @end enumerate
  
! @node Getting Started, Tutorial, Top, Top
  @chapter Getting Started
  
  @noindent
--- 520,526 ----
  ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  @end enumerate
  
! @node Getting Started, Tutorial, Copying, Top
  @chapter Getting Started
  
  @noindent