all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: "Robert J. Chassell" <bob@rattlesnake.com>
To: emacs-devel@gnu.org
Subject: Re: Emacs manual mentioning thumbs mode but not tumme
Date: Sun, 22 Apr 2007 11:40:18 +0000 (UTC)	[thread overview]
Message-ID: <m1HfaQU-0027M2C@rattlesnake.com> (raw)
In-Reply-To: <EIENLHALHGIMHGDOLMIMEENDDAAA.drew.adams@oracle.com>

I hate to say it, but it makes sense to convert all the functions
`tumme' to a name that starts with `dired' rather than `thumbnails'.

`Thumbnails' are common and becoming more so.  That name is no good.

I know that 17 variables and functions in what used to be called
`tumme.el' have `dired' in their names.  They will have to be changed.

Suppose the name chosen is `dired-view'.  (That name does not
distinguish between static images and movies.  People who drive cars
and who listen, the `situationally blind', will not `view' them -- and
the rest of us do not want them to.)

For convenience, the `dired-view' part of the name should always be
first even when the command is not for dired, such as
`thumbnails-thumb-name'.

(Documentation needs a human look since it does not follow functions'
and variables' names.  Thus, the documentation string for the variable
`thumbnails-thumbnail-buffer' says "Thumbnails's thumbnail buffer."

(It should be changed to a line such as "Dired View mode's thumbnail buffer.")

I suggest the following name changes:

    thumbnails-dired-disp-props --> dired-view-disp-props
    thumbnails-dired-insert-marked-thumbs --> dired-view-insert-marked-thumbs
    thumbnails-dired-after-readin-hook --> dired-view-after-readin-hook
    thumbnails-toggle-dired-display-properties --> 
        dired-view-toggle-dired-display-properties
    thumbnails-dired-with-window-configuration --> 
        dired-view-dired-with-window-configuration
    thumbnails-associated-dired-buffer --> dired-view-associated-dired-buffer
    thumbnails-dired-next-line --> dired-view-next-line 
    thumbnails-dired-previous-line --> dired-view-previous-line
    thumbnails-dired-file-marked-p --> dired-view-file-marked-p
    thumbnails-jump-original-dired-buffer --> 
        dired-view-jump-original-dired-buffer
    thumbnails-setup-dired-keybindings --> 
        dired-view-setup-dired-keybindings
    thumbnails-dired-display-external --> dired-view-display-external
    thumbnails-associated-dired-buffer-window --> 
        dired-view-associated-dired-buffer-window
    thumbnails-dired-display-image --> dired-view-display-image
    thumbnails-dired-comment-files --> dired-view-comment-files
    thumbnails-dired-display-properties --> dired-view-display-properties
    thumbnails-dired-edit-comment-and-tags --> dired-view-edit-comment-and-tags

Also, instances of 
    thumbnails-thumb 
should probably be converted to 
    dired-view-thumb
and instances of 
    thumbnails-thumbnail
to 
    dired-view

I hardly ever look at images or movies.  Indeed, I know so little that
was confused by the similarity between

    ;;; thumbs.el --- Thumbnails previewer for images files
    ;;; thumbnails.el --- use dired to browse and manipulate your images

which appeared in this morning's CVS.  Had I not known that Mathias
Dahl wrote tumme.el, I would not have known which to choose.
Doubtless I have left out parts.  Making the changes will be hard, but
will be easier for someone who knows the topic.

-- 
    Robert J. Chassell                          GnuPG Key ID: 004B4AC8
    bob@rattlesnake.com                         bob@gnu.org
    http://www.rattlesnake.com                  http://www.teak.cc

  parent reply	other threads:[~2007-04-22 11:40 UTC|newest]

Thread overview: 53+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2007-04-10 21:04 Emacs manual mentioning thumbs mode but not tumme Dieter Wilhelm
2007-04-10 21:18 ` Nick Roberts
2007-04-11  6:44   ` Dieter Wilhelm
2007-04-11 19:46   ` Richard Matthew Stallman
2007-04-11 21:55     ` Nick Roberts
2007-04-12 17:43       ` Richard Matthew Stallman
2007-04-12 21:59         ` Nick Roberts
2007-04-13  0:55           ` Dieter Wilhelm
2007-04-13  9:01             ` Mathias Dahl
2007-04-14 10:55               ` Dieter Wilhelm
2007-04-14 15:55                 ` Richard Stallman
2007-04-15 20:00                   ` Dieter Wilhelm
2007-04-16 15:38                     ` Richard Stallman
2007-04-16 18:50                       ` Dieter Wilhelm
2007-04-16 18:36                 ` Mathias Dahl
2007-04-16 18:58                   ` Dieter Wilhelm
2007-04-18  2:02                   ` Richard Stallman
2007-04-18 12:02                     ` Mathias Dahl
2007-04-19  1:07                       ` Dieter Wilhelm
2007-04-19 15:11                         ` Drew Adams
2007-04-19  2:38                       ` Richard Stallman
2007-04-19  9:10                         ` Kim F. Storm
2007-04-19  9:30                           ` David Kastrup
2007-04-19 12:46                             ` Mathias Dahl
2007-04-19 12:55                               ` David Kastrup
2007-04-19 13:37                               ` Markus Triska
2007-04-19 13:43                                 ` Mathias Dahl
2007-04-20 14:52                                   ` Richard Stallman
2007-04-20 15:47                                     ` Drew Adams
2007-04-20 15:53                                       ` David Kastrup
2007-04-20 16:03                                         ` Drew Adams
2007-04-22  0:47                                       ` Richard Stallman
2007-04-22  2:04                                         ` Nick Roberts
2007-04-22  3:44                                         ` Chong Yidong
2007-04-22  7:34                                           ` Drew Adams
2007-04-22  8:19                                             ` Juanma Barranquero
2007-04-22 10:53                                               ` Mathias Dahl
2007-04-22 11:11                                                 ` David Kastrup
2007-04-22 13:08                                                 ` Juanma Barranquero
2007-04-22 13:15                                                   ` Juanma Barranquero
2007-04-22 14:02                                                 ` Chong Yidong
2007-04-22 11:40                                             ` Robert J. Chassell [this message]
2007-04-22 12:31                                               ` Dieter Wilhelm
2007-04-22 15:12                                                 ` David Kastrup
2007-04-22 16:05                                                   ` Dieter Wilhelm
2007-04-19 15:24                                 ` Drew Adams
2007-04-19 20:41                                   ` Mathias Dahl
2007-04-19 16:24                           ` Stefan Monnier
2007-04-19 20:43                             ` Mathias Dahl
2007-04-20 14:52                             ` Richard Stallman
2007-04-13 15:19             ` Richard Stallman
2007-04-14 11:46               ` Dieter Wilhelm
2007-04-13 15:19           ` Richard Stallman

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

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

  git send-email \
    --in-reply-to=m1HfaQU-0027M2C@rattlesnake.com \
    --to=bob@rattlesnake.com \
    --cc=emacs-devel@gnu.org \
    /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 external index

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

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.