Re: Change the recommended first line? (was: texinfo should support Emacs coding specifier)

[Gavin Smith]

On 26 December 2015 at 18:58, Mathieu Lirzin <address@hidden> wrote:
> Hi,
>
> In the texinfo manual we can read this:
>
> --8<---------------cut here---------------start------------->8---
> Every Texinfo file that is to be the top-level input to TeX must begin
> with a line that looks like this:
>
>      \input texinfo   @c -*-texinfo-*-
> --8<---------------cut here---------------end--------------->8---
>
> Since Emacs uses texinfo mode automatically when opening a '.texi' file.
> I would like to know if it still makes sense to recommend declaring the
> mode this way.
>
> IMO it would improve clarity to remove such recommandation in the
> examples and only document this feature in a specific place, like what
> is done in the Org mode manual:
>
>   http://orgmode.org/manual/Activation.html
>
> WDYT?

I'd be happy to remove this recommendation. It's not required as far
as the Texinfo tools are concerned. The reason to keep it would be if
it was needed for people using Emacs. Perhaps say to start the file
"\input texinfo.tex" or "\input texinfo" and then say if you are using
Emacs and the file type isn't recognized automatically, the mode
specifier can be specified in the @c comment afterwards.