unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: Marco Antoniotti <marco.antoniotti@unimib.it>
To: Lars Ingebrigtsen <larsi@gnus.org>
Cc: Stefan Kangas <stefan@marxist.se>,
	Filipp Gunbin <fgunbin@fastmail.fm>,
	47775@debbugs.gnu.org
Subject: bug#47775: First line length and GNU coding standards....
Date: Wed, 5 May 2021 15:40:37 +0200	[thread overview]
Message-ID: <CAG0Nw2=CYvt504jf+JWfNVmUAX7AH9y65GGgvzCwhHPO4ywSOA@mail.gmail.com> (raw)
In-Reply-To: <87bl9p5nbq.fsf@gnus.org>

[-- Attachment #1: Type: text/plain, Size: 2174 bytes --]

Yes, exactly.

I understand your reasoning and your decision.   But let me note that it is
the "tooling" that broke, in the mists of time, previous well established
conventions.
Having said that, I would like Emacs to *also accept* the style I propose,
not to mandate it.

In any case, I am just ranting, I know :) :) :)

All the best

Marco


On Wed, May 5, 2021 at 3:20 PM Lars Ingebrigtsen <larsi@gnus.org> wrote:

> Marco Antoniotti <marco.antoniotti@unimib.it> writes:
>
> > The issue is "buffer variables" vs "convention of 'name --- description'.
> >
> > TRT is to "fix" checkdoc to look for the 'name --- description' within
> the first (10)
> > lines, AND/OR to revert to the old convention of having the '-*- ...
> -*-' line(s) within
> > the first 10.
> >
> > Once that is done, the documentation can be amended accordingly,
> relaxing the
> > mandate that the first line MUST start with ;;; foo --- bar. and no
> extra update in any
> > files will be needed.
>
> If I understand correctly, you want Emacs to recommend the following
> style to start .el files:
>
> ;;; -*- Mode: Emacs-Lisp; lexical-binding: t; some-var-with-a-long-name: t
> -*-
> ;;; foo.el --- The foo pkg, which also happens to have description 79 col
> long.
>
> This would break a lot of tooling that expects the first line to have
> the package name (and description), so that's not a feasible change.
>
> The local variable section is usually put at the end of the file, but
> lexical-binding is special, in that it's not "really" a local variable,
> but has other effects, and in that we're (at one point in the future)
> going to remove all these cookies when we flip the defaults, and then
> the first lines will be shorter than 79 characters again.
>
> So I'm closing this bug report.
>
> --
> (domestic pets only, the antidote for overdose, milk.)
>    bloggy blog: http://lars.ingebrigtsen.no
>


-- 
Marco Antoniotti, Associate Professor         tel. +39 - 02 64 48 79 01
DISCo, Università Milano Bicocca U14 2043 http://dcb.disco.unimib.it
Viale Sarca 336
http://cdac2021.lakecomoschool.org
I-20126 Milan (MI) ITALY

[-- Attachment #2: Type: text/html, Size: 7150 bytes --]

      reply	other threads:[~2021-05-05 13:40 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-04-14 14:46 bug#47775: First line length and GNU coding standards Marco Antoniotti
2021-04-18 16:59 ` Stefan Kangas
2021-04-19 12:18   ` Filipp Gunbin
2021-04-19 12:32     ` Marco Antoniotti
2021-04-19 13:18       ` Stefan Kangas
2021-04-19 13:18     ` Stefan Kangas
2021-04-19 14:11       ` Marco Antoniotti
2021-05-05 13:20         ` Lars Ingebrigtsen
2021-05-05 13:40           ` Marco Antoniotti [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='CAG0Nw2=CYvt504jf+JWfNVmUAX7AH9y65GGgvzCwhHPO4ywSOA@mail.gmail.com' \
    --to=marco.antoniotti@unimib.it \
    --cc=47775@debbugs.gnu.org \
    --cc=fgunbin@fastmail.fm \
    --cc=larsi@gnus.org \
    --cc=stefan@marxist.se \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).