GNU bug report logs - #17333
sh-mode: File local variables for setting shell variant

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 17333 in the body.
You can then email your comments to 17333 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Ben Finney <ben+gnu <at> benfinney.id.au>
To: GNU BTS submission <submit <at> debbugs.gnu.org>
Subject: sh-mode: File local variables for setting shell variant
Date: Thu, 24 Apr 2014 10:40:04 +1000

Package: emacs
Version: 24.3.1
Severity: normal

Howdy,

The ‘sh-mode’ appears to have no means for allowing a non-executable
file to declare, in its local variables, the shell variant to use for
syntax.

Emacs allows me to specify that a shell include file should be opened
in sh mode, by setting a local variable in the editor hints::

    # Local variables:
    # coding: utf-8
    # mode: sh
    # End:
    # vim: fileencoding=utf-8 filetype=bash :

I can specify to Vim that the file's shell variant is specifically
Bash, and it obeys the editor hint to present specific Bash syntax
highlighting. But Emacs has ‘sh’ mode which covers all shell variants.

The ‘sh’ mode will properly interpret such a file if it has a shebang
line (e.g. #! /bin/bash). But some files are not stand-alone programs,
so I do not want those to have a shebang line.

Emacs ‘sh’ mode treats those files as Posix shell syntax, which they
are not. ‘sh’ mode has the concept of “variant” of shell syntax; but
I'm unable to find out how to specify, in the file's editor hints,
which variant to use for the file.

How can I set the Emacs editor hints in the file such that, when the
file is opened, ‘sh’ mode knows that its syntax is Bash, or Zsh, etc.?

-- 
 \       “If consumers even know there's a DRM, what it is, and how it |
  `\     works, we've already failed.” —Peter Lee, Disney corporation, |
_o__)                                                             2005 |
Ben Finney <ben <at> benfinney.id.au>

Message #10 received at 17333 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: Ben Finney <ben+gnu <at> benfinney.id.au>
Cc: 17333 <at> debbugs.gnu.org
Subject: Re: bug#17333: sh-mode: File local variables for setting shell variant
Date: Tue, 29 Apr 2014 10:21:23 -0400

Ben Finney wrote:

> The 'sh-mode' appears to have no means for allowing a non-executable
> file to declare, in its local variables, the shell variant to use for
> syntax.

I'd also like a way to do this.
In the past I've used

-*- mode: sh; eval: (sh-set-shell "tcsh" nil nil) -*-

but it is not great.

Ideas that come to mind are a bunch of aliases (sh-bash-mode etc) that
DTRT (yuck?); or sh-mode could add something to
hack-local-variables-hook that respects a file-local `sh-buffer-shell'
or somesuch.

Message #13 received at 17333 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Monnier <monnier <at> IRO.UMontreal.CA>
To: Glenn Morris <rgm <at> gnu.org>
Cc: Ben Finney <ben+gnu <at> benfinney.id.au>, 17333 <at> debbugs.gnu.org
Subject: Re: bug#17333: sh-mode: File local variables for setting shell variant
Date: Tue, 29 Apr 2014 11:40:22 -0400

>> The 'sh-mode' appears to have no means for allowing a non-executable
>> file to declare, in its local variables, the shell variant to use for
>> syntax.
> I'd also like a way to do this.
> In the past I've used
> -*- mode: sh; eval: (sh-set-shell "tcsh" nil nil) -*-
> but it is not great.
> Ideas that come to mind are a bunch of aliases (sh-bash-mode etc) that
> DTRT (yuck?);

Actually I think having sh-csh-mode, sh-sh-mode, and sh-rc-mode would be
a good idea.

> or sh-mode could add something to hack-local-variables-hook that
> respects a file-local `sh-buffer-shell' or somesuch.

The var's name is `sh-shell', and I guess this could make sense for the
"fine tuning" (e.g. distinguish between csh and tcsh), tho I'm not sure
it's worth the trouble.


        Stefan

Message #16 received at 17333 <at> debbugs.gnu.org (full text, mbox):

From: Ben Finney <ben+gnu <at> benfinney.id.au>
To: Glenn Morris <rgm <at> gnu.org>
Cc: 17333 <at> debbugs.gnu.org
Subject: Re: bug#17333: sh-mode: File local variables for setting shell variant
Date: Wed, 30 Apr 2014 11:01:55 +1000

[Message part 1 (text/plain, inline)]

On 29-Apr-2014, Glenn Morris wrote:
> Ben Finney wrote:
> 
> > The 'sh-mode' appears to have no means for allowing a
> > non-executable file to declare, in its local variables, the shell
> > variant to use for syntax.
> 
> I'd also like a way to do this.
> In the past I've used
> 
> -*- mode: sh; eval: (sh-set-shell "tcsh" nil nil) -*-
> 
> but it is not great.

Partly because, AIUI, having ‘eval’ in the file's local variables is a
security hole, and is often disabled.

> Ideas that come to mind are a bunch of aliases (sh-bash-mode etc) that
> DTRT (yuck?); or sh-mode could add something to
> hack-local-variables-hook that respects a file-local `sh-buffer-shell'
> or somesuch.

I'd expect to be able to set the shell variant similar to the way that
I can set the SQL dialect::

    # Local variables:
    # coding: utf-8
    # mode: sql
    # sql-product: postgres
    # End:

So, for example::

    # Local variables:
    # coding: utf-8
    # mode: sh
    # shell-variant: bash
    # End:

would be a good interface for this feature, IMO.

-- 
 \     “I went to the cinema, it said ‘Adults: $5.00, Children $2.50’. |
  `\          So I said ‘Give me two boys and a girl.’” —Steven Wright |
_o__)                                                                  |
Ben Finney <ben <at> benfinney.id.au>

[signature.asc (application/pgp-signature, inline)]

Message #19 received at 17333 <at> debbugs.gnu.org (full text, mbox):

From: Ben Finney <ben+gnu <at> benfinney.id.au>
To: Stefan Monnier <monnier <at> iro.umontreal.ca>
Cc: 17333 <at> debbugs.gnu.org
Subject: Re: bug#17333: sh-mode: File local variables for setting shell variant
Date: Wed, 30 Apr 2014 11:17:30 +1000

[Message part 1 (text/plain, inline)]

On 29-Apr-2014, Stefan Monnier wrote:
> The var's name is `sh-shell', and I guess this could make sense for the
> "fine tuning" (e.g. distinguish between csh and tcsh), tho I'm not sure
> it's worth the trouble.

Having access, via the file's local variables, to set that variable
(or something equivalent like “shell-variant”) is exactly what this
bug report is about. So yes, that would be ideal.

-- 
 \                    “It's all in the mind, you know.” —The Goon Show |
  `\                                                                   |
_o__)                                                                  |
Ben Finney <ben <at> benfinney.id.au>

[signature.asc (application/pgp-signature, inline)]

Message #22 received at 17333 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: Ben Finney <ben+gnu <at> benfinney.id.au>,  17333 <at> debbugs.gnu.org
Cc: Stefan Monnier <monnier <at> IRO.UMontreal.CA>
Subject: Re: bug#17333: sh-mode: File local variables for setting shell variant
Date: Thu, 22 May 2014 16:42:21 -0400

You can apparently do this now in the Emacs trunk, by setting `sh-shell'
as a file-local variable. So this is something that should appear in
the-Emacs-after-24.4.

(There's no NEWS entry.)

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.