bug#8932: 23.2; refcard names

bug#8932: 23.2; refcard names

[harven]

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

bug#8932: 23.2; refcard names

[Stefan Kangas]

tags 8932 + moreinfo
thanks

harven@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?

bug#8932: 23.2; refcard names

[Eli Zaretskii]

> From: Stefan Kangas <stefan@marxist.se>
> Date: Thu, 21 Oct 2021 12:44:33 -0700
> Cc: 8932@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?

bug#8932: 23.2; refcard names

[Stefan Kangas]

close 8932 28.1
thanks

Eli Zaretskii <eliz@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.