[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Change the recommended first line? (was: texinfo should support Emac

From: Eli Zaretskii
Subject: Re: Change the recommended first line? (was: texinfo should support Emacs coding specifier)
Date: Sun, 27 Dec 2015 05:38:12 +0200

> Date: Sat, 26 Dec 2015 20:56:37 +0000
> From: Gavin Smith <address@hidden>
> Cc: Texinfo <address@hidden>
> 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.

Emacs automatically enters Texinfo mode for *.texinfo, *.texi, and
*.txi files, so it's okay to omit the mode cookie for those.  But any
other Texinfo file still needs that.  So if we want to change the
recommendation, we should tell that only Texinfo files with unusual
extensions need it, IMO.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]