GNU bug report logs - #1621
Please move cperl micro-docs to top of the cperl-mode.el file

Previous Next

Package: emacs;

Reported by: "Jason A. Spiro" <jasonspiro4 <at> gmail.com>

Date: Thu, 18 Dec 2008 05:20:03 UTC

Severity: wishlist

Tags: fixed

Fixed in version 28.1

Done: Lars Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

Forwarded to eye.el.why.aye.zee@cee.pee.aye.en.dot.org.invalid

Full log

Message #45 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Jason A. Spiro" <jasonspiro4 <at> gmail.com>
To: "Ilya Zakharevich" <ilya <at> math.berkeley.edu>
Cc: 1621 <at> debbugs.gnu.org, bug-gnu-emacs <at> gnu.org,
        "Stefan Monnier" <monnier <at> iro.umontreal.ca>
Subject: Re: bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file
Date: Sat, 20 Dec 2008 18:41:36 -0500

2008/12/20 Ilya Zakharevich <ilya <at> math.berkeley.edu>:
> Could you please explain to me the mental model of people who would
> read the code of CPerl, but not the mode help, and would not explore
> the mode menu?

I don't know why that mental model has happened.  But I know it
happened to me.  I don't expect help to be located halfway through a
Lisp file.  I expect it to be either in Info format or as docstrings
or near the top of the file.  :)

Remember, the change I am suggesting is an easy one to make.
This bug report was last modified 4 years and 297 days ago.

Previous Next

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