* bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file [not found] <20070401035915.3121.73126.malonedeb@gangotri.ubuntu.com> @ 2008-12-18 5:14 ` Jason A. Spiro 2008-12-18 21:39 ` Stefan Monnier 2020-10-15 15:11 ` Lars Ingebrigtsen 0 siblings, 2 replies; 9+ messages in thread From: Jason A. Spiro @ 2008-12-18 5:14 UTC (permalink / raw) To: bug-gnu-emacs Package: emacs Severity: wishlist Feature request forwarded from https://launchpad.net/bugs/99634 : ---------- Forwarded message ---------- From: Jason Spiro <jasonspiro3@gmail.com> Date: 2007/3/31 Subject: [Bug 99634] Please move cperl micro-docs to top of the cperl-mode.el file To: jasonspiro3@gmail.com Public bug reported: Binary package hint: emacs-snapshot I wanted to set Emacs to use cperl-mode instead of perl-mode, but I didn't know how. It turns out the answer was in the cperl-tips section on line 710 of the file. Please move the cperl micro-docs from the middle of the cperl-mode.el Elisp file to the top of the file. This will make more people see them. ^ permalink raw reply [flat|nested] 9+ messages in thread
* bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file 2008-12-18 5:14 ` bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file Jason A. Spiro @ 2008-12-18 21:39 ` Stefan Monnier 2008-12-19 2:28 ` Glenn Morris 2008-12-19 6:06 ` Jason A. Spiro 2020-10-15 15:11 ` Lars Ingebrigtsen 1 sibling, 2 replies; 9+ messages in thread From: Stefan Monnier @ 2008-12-18 21:39 UTC (permalink / raw) To: Jason A. Spiro; +Cc: 1621, bug-gnu-emacs > Please move the cperl micro-docs from the middle of the cperl-mode.el > Elisp file to the top of the file. This will make more people see them. I suggest we add some text in the Commentary that point people to the docstrings below. Moving the docstrings wholesale will increase the merge burden when syncing with Ilya's version. Stefan ^ permalink raw reply [flat|nested] 9+ messages in thread
* bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file 2008-12-18 21:39 ` Stefan Monnier @ 2008-12-19 2:28 ` Glenn Morris 2008-12-19 2:35 ` Processed: " Emacs bug Tracking System 2008-12-19 6:06 ` Jason A. Spiro 1 sibling, 1 reply; 9+ messages in thread From: Glenn Morris @ 2008-12-19 2:28 UTC (permalink / raw) To: Stefan Monnier; +Cc: 1621, Jason A. Spiro tags 1621 wontfix stop Stefan Monnier wrote: >> Please move the cperl micro-docs from the middle of the cperl-mode.el >> Elisp file to the top of the file. This will make more people see them. > > I suggest we add some text in the Commentary that point people to the > docstrings below. There already is such text, indicated with capital letters and "<<<<<" signs, no less. ^ permalink raw reply [flat|nested] 9+ messages in thread
* Processed: Re: bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file 2008-12-19 2:28 ` Glenn Morris @ 2008-12-19 2:35 ` Emacs bug Tracking System 0 siblings, 0 replies; 9+ messages in thread From: Emacs bug Tracking System @ 2008-12-19 2:35 UTC (permalink / raw) To: Glenn Morris; +Cc: Emacs Bugs Processing commands for control@emacsbugs.donarmstrong.com: > tags 1621 wontfix bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file There were no tags set. Tags added: wontfix > stop Stopping processing here. Please contact me if you need assistance. Don Armstrong (administrator, Emacs bugs database) ^ permalink raw reply [flat|nested] 9+ messages in thread
* bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file 2008-12-18 21:39 ` Stefan Monnier 2008-12-19 2:28 ` Glenn Morris @ 2008-12-19 6:06 ` Jason A. Spiro 2008-12-20 22:53 ` Ilya Zakharevich 1 sibling, 1 reply; 9+ messages in thread From: Jason A. Spiro @ 2008-12-19 6:06 UTC (permalink / raw) To: cpan; +Cc: 1621, bug-gnu-emacs 2008/12/18 Stefan Monnier <monnier@iro.umontreal.ca> wrote: >> Please move the cperl micro-docs from the middle of the cperl-mode.el >> Elisp file to the top of the file. This will make more people see them. > > I suggest we add some text in the Commentary that point people to the > docstrings below. Moving the docstrings wholesale will increase the > merge burden when syncing with Ilya's version. Ilya, could you too please move the micro-docs from the middle of the your cperl-mode.el Elisp file to the top of the file? This will make more people see the micro-docs. And then I hope the GNU Emacs maintainers will adopt your change downstream. Please Reply to All. By the way, I sent mail to this address @ilyaz.org because I could not find any non-Perl-related address to write to. -- Jason Spiro: software/web developer, packager, trainer, IT consultant. I support Linux, UNIX, Windows, and more. Contact me to discuss your needs. +1 (416) 992-3445 / www.jspiro.com ^ permalink raw reply [flat|nested] 9+ messages in thread
* bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file 2008-12-19 6:06 ` Jason A. Spiro @ 2008-12-20 22:53 ` Ilya Zakharevich 2008-12-20 23:41 ` Jason A. Spiro 0 siblings, 1 reply; 9+ messages in thread From: Ilya Zakharevich @ 2008-12-20 22:53 UTC (permalink / raw) To: Jason A. Spiro; +Cc: 1621, bug-gnu-emacs On Fri, Dec 19, 2008 at 01:06:44AM -0500, Jason A. Spiro wrote: > Ilya, could you too please move the micro-docs from the middle of the > your cperl-mode.el Elisp file to the top of the file? This will make > more people see the micro-docs. 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? Thanks, Ilya ^ permalink raw reply [flat|nested] 9+ messages in thread
* bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file 2008-12-20 22:53 ` Ilya Zakharevich @ 2008-12-20 23:41 ` Jason A. Spiro [not found] ` <20081221000241.GA17638@powdermilk.math.berkeley.edu> 0 siblings, 1 reply; 9+ messages in thread From: Jason A. Spiro @ 2008-12-20 23:41 UTC (permalink / raw) To: Ilya Zakharevich; +Cc: 1621, bug-gnu-emacs 2008/12/20 Ilya Zakharevich <ilya@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. ^ permalink raw reply [flat|nested] 9+ messages in thread
[parent not found: <20081221000241.GA17638@powdermilk.math.berkeley.edu>]
* bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file [not found] ` <20081221000241.GA17638@powdermilk.math.berkeley.edu> @ 2008-12-21 0:13 ` Jason A. Spiro 0 siblings, 0 replies; 9+ messages in thread From: Jason A. Spiro @ 2008-12-21 0:13 UTC (permalink / raw) To: Ilya Zakharevich; +Cc: 1621, bug-gnu-emacs 2008/12/20 Ilya Zakharevich <ilya@math.berkeley.edu> wrote: > > Let me STILL try to get some clarification. Did you not read the mode > help, and/or investigated the mode menu, or you did but not noticed > references to micro-docs? IIRC I did not read the mode help or look at the mode menu. I simply looked for a Commentary section. I hadn't used the mode much yet: it definitely had been less than an hour. But in general, I almost never read mode help, and I seldom look at mode menus. I do sometimes read mode Info documentation, or Lisp file Commentary sections. P.S. I added the original CC list back. If you did not want me to do this, please let me know. ^ permalink raw reply [flat|nested] 9+ messages in thread
* bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file 2008-12-18 5:14 ` bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file Jason A. Spiro 2008-12-18 21:39 ` Stefan Monnier @ 2020-10-15 15:11 ` Lars Ingebrigtsen 1 sibling, 0 replies; 9+ messages in thread From: Lars Ingebrigtsen @ 2020-10-15 15:11 UTC (permalink / raw) To: Jason A. Spiro; +Cc: 1621 "Jason A. Spiro" <jasonspiro4@gmail.com> writes: > I wanted to set Emacs to use cperl-mode instead of perl-mode, but I > didn't know how. It turns out the answer was in the cperl-tips section > on line 710 of the file. I've now added a more explicit reference in the comments in cperl-mode as to where to find the microdocs in Emacs 28. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no ^ permalink raw reply [flat|nested] 9+ messages in thread
end of thread, other threads:[~2020-10-15 15:11 UTC | newest] Thread overview: 9+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- [not found] <20070401035915.3121.73126.malonedeb@gangotri.ubuntu.com> 2008-12-18 5:14 ` bug#1621: Please move cperl micro-docs to top of the cperl-mode.el file Jason A. Spiro 2008-12-18 21:39 ` Stefan Monnier 2008-12-19 2:28 ` Glenn Morris 2008-12-19 2:35 ` Processed: " Emacs bug Tracking System 2008-12-19 6:06 ` Jason A. Spiro 2008-12-20 22:53 ` Ilya Zakharevich 2008-12-20 23:41 ` Jason A. Spiro [not found] ` <20081221000241.GA17638@powdermilk.math.berkeley.edu> 2008-12-21 0:13 ` Jason A. Spiro 2020-10-15 15:11 ` Lars Ingebrigtsen
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.