From: "Richard M. Stallman" <rms@gnu.org>
Cc: cyd@stupidchicken.com, emacs-devel@gnu.org
Subject: Re: Better default values for tooltip padding and `tooltip-hide-delay'?
Date: Thu, 13 Oct 2005 00:53:21 -0400 [thread overview]
Message-ID: <E1EPv5l-000867-DO@fencepost.gnu.org> (raw)
In-Reply-To: <200510112346.j9BNkIY09373@raven.dms.auburn.edu> (message from Luc Teirlinck on Tue, 11 Oct 2005 18:46:18 -0500 (CDT))
What about changing the item names "Visit New File" into "Open New or
Existing File" and "Open File" into "Open Existing File".
I think the existing names are good.
I do not want to consider changing them again.
Hence one _definitely_ needs the help echo and it should even be more
explicit. What about changing it to:
"Create a new file, or read an existing file, and edit it."
That is rather long, but I think
"Create a file, and edit it"
or
"Specify new file's name, to edit the file"
would make more sense than the current help-echo.
Just because this command CAN access an existing file is no reason we
must design the help-echo to mention that. A complete description of
the command's range of possible behavior is not its purpose. Its
purpose is to steer users in the right direction.
In general, completeness is a mistaken goal in writing documentation.
Covering all possible ways of invoking a function, or all possible
values a variable might have, is usually just wasteful--of our time,
and the user's time. We only want to describe the cases that *should
be used*.
next prev parent reply other threads:[~2005-10-13 4:53 UTC|newest]
Thread overview: 74+ messages / expand[flat|nested] mbox.gz Atom feed top
2005-07-17 15:10 Better default values for tooltip padding and `tooltip-hide-delay'? Christian Schlauer
2005-07-17 19:30 ` Drew Adams
2005-07-18 6:43 ` Frank Schmitt
2005-09-30 17:04 ` Christian Schlauer
2005-09-30 21:16 ` Jason Rumney
2005-09-30 23:03 ` Frank Schmitt
2005-10-01 13:17 ` Jason Rumney
2005-10-01 13:49 ` Luc Teirlinck
2005-10-03 16:27 ` Kevin Rodgers
2005-10-01 1:19 ` Daniel Brockman
2005-10-01 8:08 ` Andreas Schwab
2005-10-01 14:38 ` Daniel Brockman
2005-10-01 17:19 ` Andreas Schwab
2005-10-01 21:25 ` Daniel Brockman
2005-10-01 22:33 ` Andreas Schwab
2005-10-02 14:43 ` Stefan Monnier
2005-10-02 15:04 ` Andreas Schwab
2005-10-03 18:49 ` Christian Schlauer
2005-10-03 20:17 ` Lennart Borgman
2005-10-03 22:22 ` Jason Rumney
2005-10-04 18:14 ` Christian Schlauer
2005-10-04 21:27 ` Jason Rumney
2005-10-05 17:30 ` Christian Schlauer
2005-10-07 10:30 ` Christian Schlauer
2005-10-05 22:45 ` Richard M. Stallman
2005-10-04 5:02 ` Richard M. Stallman
2005-10-01 23:25 ` Richard M. Stallman
2005-10-03 18:35 ` Christian Schlauer
2005-10-03 20:32 ` Stefan Monnier
2005-10-04 18:35 ` Christian Schlauer
2005-10-04 19:47 ` Stefan Monnier
2005-10-04 18:51 ` Richard M. Stallman
2005-10-04 20:05 ` Christian Schlauer
2005-10-05 17:32 ` Christian Schlauer
2005-10-05 18:11 ` David Kastrup
2005-10-04 21:38 ` Jason Rumney
2005-10-04 23:11 ` Andreas Schwab
2005-10-04 23:15 ` Lennart Borgman
2005-10-05 8:10 ` Andreas Schwab
2005-10-05 17:34 ` Christian Schlauer
2005-10-05 22:45 ` Richard M. Stallman
2005-10-08 16:49 ` Christian Schlauer
2005-10-09 3:24 ` Stefan Monnier
2005-10-09 18:16 ` Richard M. Stallman
2005-10-09 21:32 ` Drew Adams
2005-10-09 21:42 ` Lennart Borgman
2005-10-10 15:14 ` Stefan Monnier
2005-10-11 19:06 ` Christian Schlauer
2005-10-11 20:48 ` Chong Yidong
2005-10-11 23:20 ` Luc Teirlinck
2005-10-12 21:33 ` Christian Schlauer
2005-10-12 21:43 ` Lennart Borgman
2005-10-13 0:51 ` Luc Teirlinck
2005-10-14 16:24 ` Christian Schlauer
2005-10-13 20:10 ` Richard M. Stallman
2005-10-21 17:30 ` Christian Schlauer
2005-10-22 4:18 ` Richard M. Stallman
2005-10-22 11:02 ` Eli Zaretskii
2005-10-25 19:23 ` Christian Schlauer
2005-10-26 6:39 ` Eli Zaretskii
2005-10-27 18:15 ` Christian Schlauer
2005-10-27 19:17 ` Eli Zaretskii
2005-10-27 21:05 ` Christian Schlauer
2005-10-28 7:34 ` Eli Zaretskii
2005-11-03 17:37 ` Christian Schlauer
2005-11-04 10:30 ` Eli Zaretskii
2005-11-04 17:57 ` Christian Schlauer
2005-11-04 21:34 ` Eli Zaretskii
2005-10-22 23:07 ` Kim F. Storm
2005-10-11 23:46 ` Luc Teirlinck
2005-10-13 4:53 ` Richard M. Stallman [this message]
2005-10-14 4:02 ` Luc Teirlinck
2005-10-14 17:37 ` Richard M. Stallman
2005-10-13 4:53 ` Richard M. 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
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=E1EPv5l-000867-DO@fencepost.gnu.org \
--to=rms@gnu.org \
--cc=cyd@stupidchicken.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 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).