GNU bug report logs - #8932
23.2; refcard names

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 8932 in the body.
You can then email your comments to 8932 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: harven <at> free.fr
To: bug-gnu-emacs <at> gnu.org
Subject: 23.2; refcard names
Date: Fri, 24 Jun 2011 23:02:23 +0200

It would be nice if the names of the refcards provided with emacs
were standardized, and mentioned somewhere in the manual. 
At the moment, here is what I find on my 23.2 install.

  refcard.pdf -- english
  fr-refcard.pdf -- french
  de-refcard.pdf -- german
  pl-refcard.pdf -- polish
  ru-refcard.pdf -- russian
  cs-refcard.pdf -- czech
  pt-br-refcard.pdf -- portuguese
 
  survival.tex -- another reference card for emacs
  dired-ref.pdf -- reference card for dired
  calccard.pdf -- reference card for calc mode
  orgcard.pdf -- reference card for org mode
  gnus-refcard.pdf -- reference card for gnus
  gnus-booklet.pdf -- extended list of shortcuts for gnus
  vipcard.tex -- reference card for VIP, also known as vi-mode
  vipercard.tex -- reference card for viper mode
  tex-ref.pdf.gz -- reference card for auctex (!)

  and some others
  fr-survival.tex, sk-survival.tex, cs-survival.tex,
  fr-dired-ref.tex, sk-dired-ref.tex, cs-dired-ref.tex

Names like language-mode-refcard.pdf would make them easier to locate.
Also they do not seem to be mentioned in the emacs manual, at least not in
the concept index.


In GNU Emacs 23.2.1 (i486-pc-linux-gnu, GTK+ Version 2.20.0)
 of 2010-12-11 on raven, modified by Debian
Windowing system distributor `The X.Org Foundation', version 11.0.10707000
configured using `configure  '--build' 'i486-linux-gnu' '--build' 'i486-linux-gnu' '--prefix=/usr' '--sharedstatedir=/var/lib' '--libexecdir=/usr/lib' '--localstatedir=/var/lib' '--infodir=/usr/share/info' '--mandir=/usr/share/man' '--with-pop=yes' '--enable-locallisppath=/etc/emacs23:/etc/emacs:/usr/local/share/emacs/23.2/site-lisp:/usr/local/share/emacs/site-lisp:/usr/share/emacs/23.2/site-lisp:/usr/share/emacs/site-lisp:/usr/share/emacs/23.2/leim' '--with-x=yes' '--with-x-toolkit=gtk' '--with-toolkit-scroll-bars' 'build_alias=i486-linux-gnu' 'CFLAGS=-DDEBIAN -g -O2' 'LDFLAGS=-g' 'CPPFLAGS=''

Important settings:
  value of $LC_ALL: nil
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: fr_FR.UTF-8
  value of $XMODIFIERS: nil
  locale-coding-system: utf-8-unix
  default enable-multibyte-characters: t

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

From: Stefan Kangas <stefan <at> marxist.se>
To: harven <at> free.fr
Cc: 8932 <at> debbugs.gnu.org
Subject: Re: bug#8932: 23.2; refcard names
Date: Thu, 21 Oct 2021 12:44:33 -0700

tags 8932 + moreinfo
thanks

harven <at> free.fr writes:

> It would be nice if the names of the refcards provided with emacs
> were standardized, and mentioned somewhere in the manual.
> At the moment, here is what I find on my 23.2 install.
>
>   refcard.pdf -- english
>   fr-refcard.pdf -- french
>   de-refcard.pdf -- german
>   pl-refcard.pdf -- polish
>   ru-refcard.pdf -- russian
>   cs-refcard.pdf -- czech
>   pt-br-refcard.pdf -- portuguese
>
>   survival.tex -- another reference card for emacs
>   dired-ref.pdf -- reference card for dired
>   calccard.pdf -- reference card for calc mode
>   orgcard.pdf -- reference card for org mode
>   gnus-refcard.pdf -- reference card for gnus
>   gnus-booklet.pdf -- extended list of shortcuts for gnus
>   vipcard.tex -- reference card for VIP, also known as vi-mode
>   vipercard.tex -- reference card for viper mode
>   tex-ref.pdf.gz -- reference card for auctex (!)
>
>   and some others
>   fr-survival.tex, sk-survival.tex, cs-survival.tex,
>   fr-dired-ref.tex, sk-dired-ref.tex, cs-dired-ref.tex
>
> Names like language-mode-refcard.pdf would make them easier to locate.

I'm not sure I understand the proposal here, or how we could make this
substantially better.  Note that moving the files will make looking into
git history harder, due to limitations in how git works.

I'm leaning towards closing this as wontfix.

> Also they do not seem to be mentioned in the emacs manual, at least not in
> the concept index.

Do they need to be?

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Stefan Kangas <stefan <at> marxist.se>
Cc: 8932 <at> debbugs.gnu.org, harven <at> free.fr
Subject: Re: bug#8932: 23.2; refcard names
Date: Fri, 22 Oct 2021 09:00:30 +0300

> From: Stefan Kangas <stefan <at> marxist.se>
> Date: Thu, 21 Oct 2021 12:44:33 -0700
> Cc: 8932 <at> debbugs.gnu.org
> 
> > It would be nice if the names of the refcards provided with emacs
> > were standardized, and mentioned somewhere in the manual.
> > At the moment, here is what I find on my 23.2 install.
> >
> >   refcard.pdf -- english
> >   fr-refcard.pdf -- french
> >   de-refcard.pdf -- german
> >   pl-refcard.pdf -- polish
> >   ru-refcard.pdf -- russian
> >   cs-refcard.pdf -- czech
> >   pt-br-refcard.pdf -- portuguese
> >
> >   survival.tex -- another reference card for emacs
> >   dired-ref.pdf -- reference card for dired
> >   calccard.pdf -- reference card for calc mode
> >   orgcard.pdf -- reference card for org mode
> >   gnus-refcard.pdf -- reference card for gnus
> >   gnus-booklet.pdf -- extended list of shortcuts for gnus
> >   vipcard.tex -- reference card for VIP, also known as vi-mode
> >   vipercard.tex -- reference card for viper mode
> >   tex-ref.pdf.gz -- reference card for auctex (!)
> >
> >   and some others
> >   fr-survival.tex, sk-survival.tex, cs-survival.tex,
> >   fr-dired-ref.tex, sk-dired-ref.tex, cs-dired-ref.tex
> >
> > Names like language-mode-refcard.pdf would make them easier to locate.
> 
> I'm not sure I understand the proposal here, or how we could make this
> substantially better.  Note that moving the files will make looking into
> git history harder, due to limitations in how git works.

The file names loosely follow ISO language names, so their languages
should be clear at least to some.  To make this even more clear, how
about adding the list of refcards with short descriptions (including
the language) to etc/refcards/README?

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

From: Stefan Kangas <stefan <at> marxist.se>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 8932 <at> debbugs.gnu.org, harven <at> free.fr
Subject: Re: bug#8932: 23.2; refcard names
Date: Fri, 22 Oct 2021 01:28:03 -0700

close 8932 28.1
thanks

Eli Zaretskii <eliz <at> gnu.org> writes:

> The file names loosely follow ISO language names, so their languages
> should be clear at least to some.

Indeed.

> To make this even more clear, how about adding the list of refcards
> with short descriptions (including the language) to
> etc/refcards/README?

Yup, I've now done that on the emacs-28 branch (commit cf7d8fb1d7).

With that, I'm also closing this bug report.

Previous Next

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