From: "Drew Adams" <drew.adams@oracle.com>
To: <965@emacsbugs.donarmstrong.com>, <emacs-pretest-bug@gnu.org>
Subject: bug#965: 23.0.60; filesets doc
Date: Fri, 12 Sep 2008 10:16:21 -0700 [thread overview]
Message-ID: <003001c914fb$4758d280$0200a8c0@us.oracle.com> (raw)
In-Reply-To: <001e01c914a0$ef485e30$0200a8c0@us.oracle.com>
Shouldn't this be eliminated entirely as a user option?
(defcustom filesets-find-file-delay
(if (and (featurep 'xemacs) gutter-buffers-tab-visible-p)
0.5
0)
"Delay before calling `find-file'.
This is for calls via `filesets-find-or-display-file'
or `filesets-find-file'.
Set this to 0, if you don't use XEmacs' buffer tabs."
:set (function filesets-set-default)
:type 'number
:group 'filesets)
What's the point of having an option whose value (for GNU Emacs) should always
be 0?
> From: Drew Adams Sent: Thursday, September 11, 2008 11:30 PM
> FWIW:
>
> * The doc on the author's Web site
> (http://members.a1.net/t.link/CompEmacsFilesetsDoc.html) is
> quite a bit better
> than the Emacs Info doc for Filesets.
>
> * The version of Filesets on the author's Web site is 2.2.
> The version of
> Filesets in Emacs 23 is 1.8.4. Time for GNU Emacs to upgrade?
>
>
> > -------------------8<----------------------
> > From: Drew Adams Sent: Thursday, September 11, 2008 8:17 PM
> > Some quick feedback on the filesets doc:
> >
> > 1. `i' in the Emacs manual followed by `filesets' shows
> index entries
> > `filesets' and `filesets <1>'. The former is not about filesets in
> > general, but about version control editing. The latter is the normal
> > filesets entry, but `<1>' means nothing to users.
> >
> > 2. There is no index entry for `file set' or `file-set' or `sets of
> > files'. A user might not know that `fileset' just happens to be
> > written that (non-standard) way.
> >
> > 3. Node Filesets: "initially creates only the current file": no file
> > is _created_.
> >
> > 4. There is no explanation of the Filesets menu items. There is an
> > `About' item with a link to a non-GNU Web page - should there be
> > (dunno - maybe)? What is the meaning of `#' and `+' in front of the
> > submenus? I see, from customizing group Filesets, that there is an
> > option Filesets Menu Shortcuts Flag, and I can guess from that what
> > the # and + are for, but (1) Why this non-standard convention only
> > here? (2) Why nothing in the Info doc about it?
> >
> > 5. Using Customize:
> >
> > a. After using DEL to delete a fileset, SET for the current session
> > should automatically "rebuild" the menu to remove that fileset, no?
> >
> > b. There is a wealth of information in the Customize description for
> > Filesets Data, but it is mostly at the Emacs-Lisp level.
> Nevertheless,
> > it is useful, and totally missing from the doc (manual). This stuff
> > needs to be _explained_ to users: what the features are and
> how to use
> > them.
> >
> > c. In group Filesets, These options (at least) are not very
> > understandable:
> >
> > - Filesets Menu In Menu
> > - Filesets Menu Shortcuts Marker
> > - Filesets Menu Cache Contents
> > - Filesets Menu Cache Contents (needs to be explained better)
> > - Filesets Cache Hostname Flag
> > - Filesets Browse Dir Function (external command not clear)
> > - Filesets Find File Delay (what for?)
> > - Filesets Commands (explanation unclear)
> > - Filesets External Viewers (Properties is especially unclear)
> > - Filesets Ingroup Patterns
> >
> > Also, "splitted" -> "split"; "a filesets' files" -> "a
> > fileset's files".
> >
> > 6. Generally, the filesets doc is poor, hidden, and inside out - you
> > need to dig through Customize or the source code to piece together
> > what this is all about and how you might put it to use.
> There is only
> > one Info node for this stuff, and it explains nothing about
> 90% of the
> > user-level fileset features. The Customize description reads like a
> > disparate collection of code comments - not very helpful to
> users, but
> > it is the best information available so far.
> >
> > 7. There is nothing in the Emacs-Lisp manual about filesets. The
> > fileset features and the Emacs Lisp behind them (e.g.
> keywords) should
> > be explained (somewhere). Presumably, filesets should be of interest
> > to Lisp programmers.
> >
> > 8. The Website linked to from menu item About has a page with
> > documentation on filesets:
> > http://members.a1.net/t.link/CompEmacsFilesetsDoc.html. All of that
> > information needs to be added to the Emacs manual (or a separate
> > Filesets Info manual, if too large). That would be a good start.
> >
> > Beyond the doc:
> >
> > 1. Is there a command that removes (deletes) a fileset, or must you
> > use Customize or `setq'?
> >
> > 2. Why isn't `filesets-init' interactive? The third sentence of the
> > doc says that you "must" put (fileset-init) in .emacs.
> Surely that is
> > not the way to teach this - better to walk users through using a
> > command than to tell them to edit .emacs and start over.
> >
> >
> > IN SUM: It's a shame this stuff isn't documented clearly.
> If it were,
> > people might use it more. It seems like it should have
> potential, but
> > the doc is not encouraging.
> >
> > CAVEAT: I took a very quick look, so I apologize if I overlooked or
> > misunderstood some things. Take this input as just one Emacs user's
> > first impression.
> >
> >
> >
> > In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600)
> > of 2008-08-29 on LENNART-69DE564
> > Windowing system distributor `Microsoft Corp.', version 5.1.2600
> > configured using `configure --with-gcc (3.4) --no-opt
> > --cflags -Ic:/g/include
> > -fno-crossjumping'
>
>
>
>
>
>
next prev parent reply other threads:[~2008-09-12 17:16 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2008-09-12 3:17 bug#965: 23.0.60; filesets doc Drew Adams
2008-09-12 6:29 ` Drew Adams
2008-09-12 17:16 ` Drew Adams [this message]
2011-07-06 18:29 ` Lars Magne Ingebrigtsen
2011-07-06 19:25 ` Drew Adams
2011-07-07 16:25 ` Lars Magne Ingebrigtsen
2011-07-07 16:39 ` Drew Adams
2011-07-07 16:44 ` Lars Magne Ingebrigtsen
2014-02-10 3:43 ` Lars Ingebrigtsen
2014-02-10 4:27 ` Drew Adams
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='003001c914fb$4758d280$0200a8c0@us.oracle.com' \
--to=drew.adams@oracle.com \
--cc=965@emacsbugs.donarmstrong.com \
--cc=emacs-pretest-bug@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.