Re: master 126f95a: * doc/misc/tramp.texi: Adapt 2016-08-14 change for makeinfo 4.

Re: master 126f95a: * doc/misc/tramp.texi: Adapt 2016-08-14 change for makeinfo 4.

[Michael Albinus]

rgm@gnu.org (Glenn Morris) writes:

Hi Glenn,

> branch: master
> commit 126f95a708d637941e9eae1b023a87733bb5fd38
> Author: Glenn Morris <rgm@gnu.org>
> Commit: Glenn Morris <rgm@gnu.org>
>
>     * doc/misc/tramp.texi: Adapt 2016-08-14 change for makeinfo 4.
> ---
>  doc/misc/tramp.texi |    2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
> index d64d5e5..5e04a2d 100644
> --- a/doc/misc/tramp.texi
> +++ b/doc/misc/tramp.texi
> @@ -65,8 +65,8 @@ copy and modify this GNU manual.''
>  @contents
>  
>  
> -@node Top, Overview, (dir), (dir)
>  @ifnottex
> +@node Top, Overview, (dir), (dir)
>  @top @value{tramp} version @value{trampver} User Manual
>  
>  This file documents @value{tramp} version @value{trampver}, a remote file

I've applied your change to the Tramp repository. This results in errors:

detlef:~/src/tramp/texi> make
install-info --quiet --info-dir=../info/   ../info/tramp
makeinfo --no-warn --no-split -D  installchapter --dvi -o tramp.dvi tramp.texi
tramp.texi:105: @menu seen before first @node
tramp.texi:132: @detailmenu seen before first @node
Makefile:89: recipe for target 'dvi' failed
make: [dvi] Error 1 (ignored)
makeinfo --no-warn --no-split -D  installchapter --html -o tramp.html tramp.texi
makeinfo --no-warn --no-split -D  installchapter --pdf -o tramp.pdf tramp.texi
tramp.texi:105: @menu seen before first @node
tramp.texi:132: @detailmenu seen before first @node
Makefile:89: recipe for target 'pdf' failed
make: [pdf] Error 1 (ignored)

Could you please tell, why this change is necessary? I run

detlef:~/src/emacs> makeinfo --version
texi2any (GNU texinfo) 6.1

Thanks, and best regards, Michael.

Re: master 126f95a: * doc/misc/tramp.texi: Adapt 2016-08-14 change for makeinfo 4.

[Glenn Morris]

With my change:
makeinfo 4.13 and 5.1 both work fine for me for tramp info and pdf.
The info pages also build fine on Hydra with texinfo 5.2.
I do not have makeinfo 6.

Without my change:
makeinfo (GNU texinfo) 4.13 fails to build tramp.info since
59720dc1379bb0e0c4a78930fac7f48740780c80:

  GEN      ../../info/tramp.info
tramp.texi:3622: `Concept Index' has no Up field (perhaps incorrect sectioning?).
tramp.texi:3617: `Variable Index' has no Up field (perhaps incorrect sectioning?).
tramp.texi:3612: `Function Index' has no Up field (perhaps incorrect sectioning?).
tramp.texi:3607: `GNU Free Documentation License' has no Up field (perhaps incorrect sectioning?).
tramp.texi:3538: `Traces and Profiles' has no Up field (perhaps incorrect sectioning?).
tramp.texi:3450: `Files directories and localnames' has no Up field (perhaps incorrect sectioning?).
tramp.texi:2759: `Frequently Asked Questions' has no Up field (perhaps incorrect sectioning?).
tramp.texi:2699: `Bug Reports' has no Up field (perhaps incorrect sectioning?).
tramp.texi:2142: `Usage' has no Up field (perhaps incorrect sectioning?).
tramp.texi:426: `Configuration' has no Up field (perhaps incorrect sectioning?).
tramp.texi:396: `History' has no Up field (perhaps incorrect sectioning?).
tramp.texi:324: `Obtaining Tramp' has no Up field (perhaps incorrect sectioning?).
tramp.texi:183: `Overview' has no Up field (perhaps incorrect sectioning?).
tramp.texi:67: Next field of node `Top' not pointed to (perhaps incorrect sectioning?).
tramp.texi:183: This node (Overview) has the bad Prev.
make: *** [../../info/tramp.info] Error 1

Re: master 126f95a: * doc/misc/tramp.texi: Adapt 2016-08-14 change for makeinfo 4.

[Paul Eggert]

Can you run 'MAKEINFO="makeinfo ..." texi2dvi tramp.texi' instead of 'makeinfo 
... --dvi -o tramp.dvi tramp.texi'? That's what the Emacs build procedure does.

Re: master 126f95a: * doc/misc/tramp.texi: Adapt 2016-08-14 change for makeinfo 4.

[Michael Albinus]

Paul Eggert <eggert@cs.ucla.edu> writes:

> Can you run 'MAKEINFO="makeinfo ..." texi2dvi tramp.texi' instead of
> 'makeinfo ... --dvi -o tramp.dvi tramp.texi'? That's what the Emacs
> build procedure does.

I've rearranged the text in tramp.texi. Shall work now everywhere.

Best regards, Michael.