* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) @ 2021-09-28 22:55 Stefan Kangas 2021-09-29 7:06 ` Lars Ingebrigtsen 0 siblings, 1 reply; 31+ messages in thread From: Stefan Kangas @ 2021-09-28 22:55 UTC (permalink / raw) To: 50880 Severity: wishlist When I press `C-h C-h', there is an entry "Emacs TODO" (`C-h C-t'), but there is no entry "Contributing to Emacs". On the splash screen, there is an entry "Contributing" that takes you to `(emacs) Contributing'. Please consider adding a new help keybinding that takes you to that section in the Info manual. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-28 22:55 bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) Stefan Kangas @ 2021-09-29 7:06 ` Lars Ingebrigtsen 2021-09-29 9:11 ` Stefan Kangas 0 siblings, 1 reply; 31+ messages in thread From: Lars Ingebrigtsen @ 2021-09-29 7:06 UTC (permalink / raw) To: Stefan Kangas; +Cc: 50880 Stefan Kangas <stefan@marxist.se> writes: > When I press `C-h C-h', there is an entry "Emacs TODO" (`C-h C-t'), but > there is no entry "Contributing to Emacs". > > On the splash screen, there is an entry "Contributing" that takes you to > `(emacs) Contributing'. > > Please consider adding a new help keybinding that takes you to that > section in the Info manual. Makes sense to me. What key would that be, though? `C-h c' and `C' and `C-c' are all taken... `C-h M-c' is free, though. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 7:06 ` Lars Ingebrigtsen @ 2021-09-29 9:11 ` Stefan Kangas 2021-09-29 9:18 ` Gregory Heytings 2021-09-29 16:00 ` Lars Ingebrigtsen 0 siblings, 2 replies; 31+ messages in thread From: Stefan Kangas @ 2021-09-29 9:11 UTC (permalink / raw) To: Lars Ingebrigtsen; +Cc: 50880 Lars Ingebrigtsen <larsi@gnus.org> writes: > Makes sense to me. What key would that be, though? `C-h c' and `C' and > `C-c' are all taken... `C-h M-c' is free, though. Or just move `describe-copying' to `C-h C-g' (for GNU GPL), thus freeing up `C-h C-c' for "Contributing". ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 9:11 ` Stefan Kangas @ 2021-09-29 9:18 ` Gregory Heytings 2021-09-29 9:41 ` Stefan Kangas 2021-09-29 16:00 ` Lars Ingebrigtsen 1 sibling, 1 reply; 31+ messages in thread From: Gregory Heytings @ 2021-09-29 9:18 UTC (permalink / raw) To: Stefan Kangas; +Cc: Lars Ingebrigtsen, 50880 >> Makes sense to me. What key would that be, though? `C-h c' and `C' >> and `C-c' are all taken... `C-h M-c' is free, though. > > Or just move `describe-copying' to `C-h C-g' (for GNU GPL), thus freeing > up `C-h C-c' for "Contributing". > But (elisp) Key Binding Conventions says: "Similarly, don't bind a key sequence ending in `C-g', since that is commonly used to cancel a key sequence." I suggest: C-h g -> About the GNU project C-h G -> Emacs copying permission (GNU General Public License) C-h C-c -> Contributing ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 9:18 ` Gregory Heytings @ 2021-09-29 9:41 ` Stefan Kangas 2021-09-29 16:55 ` Juri Linkov 0 siblings, 1 reply; 31+ messages in thread From: Stefan Kangas @ 2021-09-29 9:41 UTC (permalink / raw) To: Gregory Heytings; +Cc: Lars Ingebrigtsen, 50880 Gregory Heytings <gregory@heytings.org> writes: > I suggest: > > C-h g -> About the GNU project > C-h G -> Emacs copying permission (GNU General Public License) > C-h C-c -> Contributing Sounds good to me. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 9:41 ` Stefan Kangas @ 2021-09-29 16:55 ` Juri Linkov 2021-09-29 17:41 ` Stefan Kangas ` (2 more replies) 0 siblings, 3 replies; 31+ messages in thread From: Juri Linkov @ 2021-09-29 16:55 UTC (permalink / raw) To: Stefan Kangas; +Cc: Lars Ingebrigtsen, 50880, Gregory Heytings >> I suggest: >> >> C-h g -> About the GNU project >> C-h G -> Emacs copying permission (GNU General Public License) >> C-h C-c -> Contributing > > Sounds good to me. Here is another problem: TAB Show all installed manuals should be C-i Show all installed manuals because the mnemonic key is 'C-i'. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 16:55 ` Juri Linkov @ 2021-09-29 17:41 ` Stefan Kangas 2021-09-29 17:45 ` Lars Ingebrigtsen 2021-09-29 17:55 ` Eli Zaretskii 2021-09-29 18:36 ` Gregory Heytings 2 siblings, 1 reply; 31+ messages in thread From: Stefan Kangas @ 2021-09-29 17:41 UTC (permalink / raw) To: Juri Linkov; +Cc: Lars Ingebrigtsen, 50880, Gregory Heytings Juri Linkov <juri@linkov.net> writes: > Here is another problem: > > TAB Show all installed manuals > > should be > > C-i Show all installed manuals > > because the mnemonic key is 'C-i'. Yup. This is a limitation in `substitute-command-keys' that I think we should fix. Feel free to open a bug report about it. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 17:41 ` Stefan Kangas @ 2021-09-29 17:45 ` Lars Ingebrigtsen 0 siblings, 0 replies; 31+ messages in thread From: Lars Ingebrigtsen @ 2021-09-29 17:45 UTC (permalink / raw) To: Stefan Kangas; +Cc: Gregory Heytings, 50880, Juri Linkov Stefan Kangas <stefan@marxist.se> writes: > This is a limitation in `substitute-command-keys' that I think we > should fix. Feel free to open a bug report about it. It's somewhat related to bug#37485, I guess. (I.e., having a way to specify what the "intended" key binding is be when printing.) -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 16:55 ` Juri Linkov 2021-09-29 17:41 ` Stefan Kangas @ 2021-09-29 17:55 ` Eli Zaretskii 2021-09-29 18:36 ` Gregory Heytings 2 siblings, 0 replies; 31+ messages in thread From: Eli Zaretskii @ 2021-09-29 17:55 UTC (permalink / raw) To: Juri Linkov; +Cc: 50880, larsi, stefan, gregory > From: Juri Linkov <juri@linkov.net> > Date: Wed, 29 Sep 2021 19:55:34 +0300 > Cc: Lars Ingebrigtsen <larsi@gnus.org>, 50880@debbugs.gnu.org, > Gregory Heytings <gregory@heytings.org> > > Here is another problem: > > TAB Show all installed manuals > > should be > > C-i Show all installed manuals > > because the mnemonic key is 'C-i'. If C-i was selected because the 'i' part, then it's too bad, because the correct name is TAB, for the same reason we use RET abd BS and DEL and ESC instead of their Ctrl equivalents. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 16:55 ` Juri Linkov 2021-09-29 17:41 ` Stefan Kangas 2021-09-29 17:55 ` Eli Zaretskii @ 2021-09-29 18:36 ` Gregory Heytings 2 siblings, 0 replies; 31+ messages in thread From: Gregory Heytings @ 2021-09-29 18:36 UTC (permalink / raw) To: Juri Linkov; +Cc: Lars Ingebrigtsen, Stefan Kangas, 50880 >>> I suggest: >>> >>> C-h g -> About the GNU project >>> C-h G -> Emacs copying permission (GNU General Public License) >>> C-h C-c -> Contributing >> >> Sounds good to me. > > Here is another problem: > > TAB Show all installed manuals > > should be > > C-i Show all installed manuals > > because the mnemonic key is 'C-i'. > But "Show all installed manuals" is on C-h i, isn't it? Has this changed very recently? ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 9:11 ` Stefan Kangas 2021-09-29 9:18 ` Gregory Heytings @ 2021-09-29 16:00 ` Lars Ingebrigtsen 2021-09-29 16:52 ` Stefan Kangas 1 sibling, 1 reply; 31+ messages in thread From: Lars Ingebrigtsen @ 2021-09-29 16:00 UTC (permalink / raw) To: Stefan Kangas; +Cc: 50880 Stefan Kangas <stefan@marxist.se> writes: > Or just move `describe-copying' to `C-h C-g' (for GNU GPL), thus freeing > up `C-h C-c' for "Contributing". `C-g' is more mnemonic, but I'm not enthusiastic about moving around key bindings that have been around this long. (Even if it's not a command many people are actually using.) -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 16:00 ` Lars Ingebrigtsen @ 2021-09-29 16:52 ` Stefan Kangas 2021-09-30 1:10 ` Stefan Kangas 0 siblings, 1 reply; 31+ messages in thread From: Stefan Kangas @ 2021-09-29 16:52 UTC (permalink / raw) To: Lars Ingebrigtsen; +Cc: 50880 Lars Ingebrigtsen <larsi@gnus.org> writes: > `C-g' is more mnemonic, but I'm not enthusiastic about moving around key > bindings that have been around this long. (Even if it's not a command > many people are actually using.) I guess you will in any case only ever press this after looking at `C-h C-h' first, so I don't think this matters really. We could pick any key, like "b" for "contriButing". Or, you know, "h" for "Happens to be free". ;-) ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-29 16:52 ` Stefan Kangas @ 2021-09-30 1:10 ` Stefan Kangas 2021-09-30 6:10 ` Lars Ingebrigtsen 2021-09-30 7:49 ` Gregory Heytings 0 siblings, 2 replies; 31+ messages in thread From: Stefan Kangas @ 2021-09-30 1:10 UTC (permalink / raw) To: Lars Ingebrigtsen; +Cc: 50880 [-- Attachment #1: Type: text/plain, Size: 413 bytes --] tags 50880 + patch thanks Stefan Kangas <stefan@marxist.se> writes: > We could pick any key, like "b" for "contriButing". Or, you know, "h" > for "Happens to be free". ;-) So how about the attached? I put it on `C-h C-x' because I figured that we might want to use "b" for "bugs" in the future perhaps, and "u" just wasn't that nice. Most of the other ones are taken except for "i", "q", "r", "y" and "z". [-- Attachment #2: 0001-New-help-function-view-emacs-contributing.patch --] [-- Type: text/x-diff, Size: 2575 bytes --] From f05c916f2c37cbdf419d214f6d6b8bd11c9ffbcd Mon Sep 17 00:00:00 2001 From: Stefan Kangas <stefan@marxist.se> Date: Thu, 30 Sep 2021 02:52:58 +0200 Subject: [PATCH] New help function view-emacs-contributing * lisp/help.el (view-emacs-contributing): New function. (help-for-help): Display new function. (help-map): Bind it to "C-h C-x". (Bug#50880) * lisp/startup.el (fancy-about-text, normal-about-screen): Use above new function. --- lisp/help.el | 7 +++++++ lisp/startup.el | 4 ++-- 2 files changed, 9 insertions(+), 2 deletions(-) diff --git a/lisp/help.el b/lisp/help.el index 02e9b9e8e4..3d15ce2530 100644 --- a/lisp/help.el +++ b/lisp/help.el @@ -70,6 +70,7 @@ help-map (define-key map "\C-s" 'search-forward-help-for-help) (define-key map "\C-t" 'view-emacs-todo) (define-key map "\C-w" 'describe-no-warranty) + (define-key map "\C-x" 'view-emacs-contributing) ;; This does not fit the pattern, but it is natural given the C-\ command. (define-key map "\C-\\" 'describe-input-method) @@ -292,6 +293,7 @@ 'help ("describe-distribution" "Emacs ordering and distribution information") ("C-m" "Order printed manuals") + ("view-emacs-contributing" "Contributing to Emacs") ("view-emacs-todo" "Emacs TODO") ("describe-no-warranty" "Information on absence of warranty")) @@ -504,6 +506,11 @@ view-emacs-problems (interactive) (view-help-file "PROBLEMS")) +(defun view-emacs-contributing () + "Display info on how to contribute to Emacs." + (interactive) + (info "(emacs) Contributing")) + (defun view-emacs-debugging () "Display info on how to debug Emacs problems." (interactive) diff --git a/lisp/startup.el b/lisp/startup.el index 505d7b83f4..af22908b35 100644 --- a/lisp/startup.el +++ b/lisp/startup.el @@ -1649,7 +1649,7 @@ fancy-about-text (goto-char (point-min)))) "\tMany people have contributed code included in GNU Emacs\n" :link ("Contributing" - ,(lambda (_button) (info "(emacs)Contributing"))) + ,(lambda (_button) (view-emacs-contributing))) "\tHow to report bugs and contribute improvements to Emacs\n" "\n" :link ("GNU and Freedom" ,(lambda (_button) (describe-gnu-project))) @@ -2237,7 +2237,7 @@ normal-about-screen (insert-button "Contributing" 'action - (lambda (_button) (info "(emacs)Contributing")) + (lambda (_button) (view-emacs-contributing)) 'follow-link t) (insert "\tHow to report bugs and contribute improvements to Emacs\n\n") -- 2.30.2 ^ permalink raw reply related [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-30 1:10 ` Stefan Kangas @ 2021-09-30 6:10 ` Lars Ingebrigtsen 2021-09-30 7:49 ` Gregory Heytings 1 sibling, 0 replies; 31+ messages in thread From: Lars Ingebrigtsen @ 2021-09-30 6:10 UTC (permalink / raw) To: Stefan Kangas; +Cc: 50880 Stefan Kangas <stefan@marxist.se> writes: > So how about the attached? I put it on `C-h C-x' because I figured that > we might want to use "b" for "bugs" in the future perhaps, and "u" just > wasn't that nice. Most of the other ones are taken except for "i", "q", > "r", "y" and "z". Looks good to me, but I think this should go into master after the emacs-28 branch has been cut. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-30 1:10 ` Stefan Kangas 2021-09-30 6:10 ` Lars Ingebrigtsen @ 2021-09-30 7:49 ` Gregory Heytings 2021-09-30 11:51 ` Gregory Heytings 2021-09-30 20:01 ` Stefan Kangas 1 sibling, 2 replies; 31+ messages in thread From: Gregory Heytings @ 2021-09-30 7:49 UTC (permalink / raw) To: Stefan Kangas; +Cc: Lars Ingebrigtsen, 50880 >> We could pick any key, like "b" for "contriButing". Or, you know, "h" >> for "Happens to be free". ;-) > > So how about the attached? > What was wrong with C-h g -> About the GNU project C-h G -> Emacs copying permission (GNU General Public License) C-h C-c -> Contributing ? Also, I would put "Contributing to Emacs" in the first subsection of "Miscellaneous", after "Debugging Emacs", where it belongs. Which by the way makes me wonder why Emacs TODO is not there, too. It would perhaps be even better to create a third subsection with C-p Known problems C-d Debugging Emacs ? Contributing to Emacs C-t Emacs TODO > > I put it on `C-h C-x' because I figured that we might want to use "b" > for "bugs" in the future perhaps, and "u" just wasn't that nice. Most > of the other ones are taken except for "i", "q", "r", "y" and "z". > Actually there are quite a few more keys that are still free under C-h: C-h {j,u,y,z} C-h {A,B,D,E,G,H,J,M,N,O,Q,T,U,V,W,X,Y,Z} C-h C-{b,i,j,k,l,q,r,u,v,x,z} [and C-g which should not be bound] ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-30 7:49 ` Gregory Heytings @ 2021-09-30 11:51 ` Gregory Heytings 2021-09-30 20:01 ` Stefan Kangas 1 sibling, 0 replies; 31+ messages in thread From: Gregory Heytings @ 2021-09-30 11:51 UTC (permalink / raw) To: Stefan Kangas; +Cc: Lars Ingebrigtsen, 50880 > > What was wrong with > > C-h g -> About the GNU project > C-h G -> Emacs copying permission (GNU General Public License) > C-h C-c -> Contributing > > ? > Another option: C-h g -> About the GNU project C-h C-l (as in "license") -> Emacs copying permission (GNU General Public License) C-h C-c -> Contributing to Emacs ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-30 7:49 ` Gregory Heytings 2021-09-30 11:51 ` Gregory Heytings @ 2021-09-30 20:01 ` Stefan Kangas 2021-10-01 7:24 ` Lars Ingebrigtsen 1 sibling, 1 reply; 31+ messages in thread From: Stefan Kangas @ 2021-09-30 20:01 UTC (permalink / raw) To: Gregory Heytings; +Cc: Lars Ingebrigtsen, 50880 Gregory Heytings <gregory@heytings.org> writes: > What was wrong with > > C-h g -> About the GNU project > C-h G -> Emacs copying permission (GNU General Public License) > C-h C-c -> Contributing IMO the best proposal so far, but Lars didn't want to move the GPL from 'C-h C-c' so that part unfortunately makes it a non-starter. > Also, I would put "Contributing to Emacs" in the first subsection of > "Miscellaneous", after "Debugging Emacs", where it belongs. Which by the > way makes me wonder why Emacs TODO is not there, too. It would perhaps be > even better to create a third subsection with > > C-p Known problems > C-d Debugging Emacs > ? Contributing to Emacs > C-t Emacs TODO Good idea, I like it. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-09-30 20:01 ` Stefan Kangas @ 2021-10-01 7:24 ` Lars Ingebrigtsen 2021-10-01 10:17 ` Eli Zaretskii 0 siblings, 1 reply; 31+ messages in thread From: Lars Ingebrigtsen @ 2021-10-01 7:24 UTC (permalink / raw) To: Stefan Kangas; +Cc: Gregory Heytings, 50880 Stefan Kangas <stefan@marxist.se> writes: >> What was wrong with >> >> C-h g -> About the GNU project >> C-h G -> Emacs copying permission (GNU General Public License) >> C-h C-c -> Contributing > > IMO the best proposal so far, but Lars didn't want to move the GPL > from 'C-h C-c' so that part unfortunately makes it a non-starter. I'm not dead set against it -- it's not like these are commands that people use heavily. But that cuts the other way, too -- making this new command mnemonic isn't really that important, either, since I'd assume that people would be accessing them via `C-h C-h' and then paging down, entering whatever key it says they should use. I.e., nobody's remembering these keystrokes anyway. Perhaps Eli has an opinion here? >> Also, I would put "Contributing to Emacs" in the first subsection of >> "Miscellaneous", after "Debugging Emacs", where it belongs. Which by the >> way makes me wonder why Emacs TODO is not there, too. It would perhaps be >> even better to create a third subsection with >> >> C-p Known problems >> C-d Debugging Emacs >> ? Contributing to Emacs >> C-t Emacs TODO > > Good idea, I like it. Me too. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-01 7:24 ` Lars Ingebrigtsen @ 2021-10-01 10:17 ` Eli Zaretskii 2021-10-01 10:20 ` Lars Ingebrigtsen 2021-10-02 23:17 ` Richard Stallman 0 siblings, 2 replies; 31+ messages in thread From: Eli Zaretskii @ 2021-10-01 10:17 UTC (permalink / raw) To: Lars Ingebrigtsen; +Cc: gregory, stefan, 50880 > From: Lars Ingebrigtsen <larsi@gnus.org> > Date: Fri, 01 Oct 2021 09:24:45 +0200 > Cc: Gregory Heytings <gregory@heytings.org>, 50880@debbugs.gnu.org > > Stefan Kangas <stefan@marxist.se> writes: > > >> What was wrong with > >> > >> C-h g -> About the GNU project > >> C-h G -> Emacs copying permission (GNU General Public License) > >> C-h C-c -> Contributing > > > > IMO the best proposal so far, but Lars didn't want to move the GPL > > from 'C-h C-c' so that part unfortunately makes it a non-starter. > > I'm not dead set against it -- it's not like these are commands that > people use heavily. But that cuts the other way, too -- making this new > command mnemonic isn't really that important, either, since I'd assume > that people would be accessing them via `C-h C-h' and then paging down, > entering whatever key it says they should use. I.e., nobody's > remembering these keystrokes anyway. > > Perhaps Eli has an opinion here? How about not giving it a key binding at all? Why is a key binding important in this case? It's not like people will want to read that section twice a day. > >> Also, I would put "Contributing to Emacs" in the first subsection of > >> "Miscellaneous", after "Debugging Emacs", where it belongs. Which by the > >> way makes me wonder why Emacs TODO is not there, too. It would perhaps be > >> even better to create a third subsection with > >> > >> C-p Known problems > >> C-d Debugging Emacs > >> ? Contributing to Emacs > >> C-t Emacs TODO > > > > Good idea, I like it. > > Me too. Which part? If this is about the manual organization, I fail to see what's wrong with the current one, where Contributing is a chapter -- you don't get any more prominent than that. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-01 10:17 ` Eli Zaretskii @ 2021-10-01 10:20 ` Lars Ingebrigtsen 2021-10-01 10:28 ` Eli Zaretskii 2021-10-02 23:17 ` Richard Stallman 1 sibling, 1 reply; 31+ messages in thread From: Lars Ingebrigtsen @ 2021-10-01 10:20 UTC (permalink / raw) To: Eli Zaretskii; +Cc: gregory, stefan, 50880 Eli Zaretskii <eliz@gnu.org> writes: >> Me too. > > Which part? If this is about the manual organization, I fail to see > what's wrong with the current one, where Contributing is a chapter -- > you don't get any more prominent than that. No, this is the `C-h C-h' buffer output. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-01 10:20 ` Lars Ingebrigtsen @ 2021-10-01 10:28 ` Eli Zaretskii 2021-10-01 10:32 ` Lars Ingebrigtsen 0 siblings, 1 reply; 31+ messages in thread From: Eli Zaretskii @ 2021-10-01 10:28 UTC (permalink / raw) To: Lars Ingebrigtsen; +Cc: gregory, stefan, 50880 > From: Lars Ingebrigtsen <larsi@gnus.org> > Cc: stefan@marxist.se, gregory@heytings.org, 50880@debbugs.gnu.org > Date: Fri, 01 Oct 2021 12:20:55 +0200 > > Eli Zaretskii <eliz@gnu.org> writes: > > >> Me too. > > > > Which part? If this is about the manual organization, I fail to see > > what's wrong with the current one, where Contributing is a chapter -- > > you don't get any more prominent than that. > > No, this is the `C-h C-h' buffer output. But then all of those are already there? ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-01 10:28 ` Eli Zaretskii @ 2021-10-01 10:32 ` Lars Ingebrigtsen 2021-10-01 11:00 ` Eli Zaretskii 0 siblings, 1 reply; 31+ messages in thread From: Lars Ingebrigtsen @ 2021-10-01 10:32 UTC (permalink / raw) To: Eli Zaretskii; +Cc: gregory, stefan, 50880 Eli Zaretskii <eliz@gnu.org> writes: >> No, this is the `C-h C-h' buffer output. > > But then all of those are already there? Not the "Contributing" one, which is why we're discussing adding a key stroke to it so that it'll appear there, too. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-01 10:32 ` Lars Ingebrigtsen @ 2021-10-01 11:00 ` Eli Zaretskii 2021-10-01 17:08 ` bug#50880: [External] : " Drew Adams 2021-10-01 18:45 ` Stefan Kangas 0 siblings, 2 replies; 31+ messages in thread From: Eli Zaretskii @ 2021-10-01 11:00 UTC (permalink / raw) To: Lars Ingebrigtsen; +Cc: gregory, stefan, 50880 > From: Lars Ingebrigtsen <larsi@gnus.org> > Cc: stefan@marxist.se, gregory@heytings.org, 50880@debbugs.gnu.org > Date: Fri, 01 Oct 2021 12:32:54 +0200 > > Eli Zaretskii <eliz@gnu.org> writes: > > >> No, this is the `C-h C-h' buffer output. > > > > But then all of those are already there? > > Not the "Contributing" one, which is why we're discussing adding a key > stroke to it so that it'll appear there, too. And I already said what I think about it: to me it sounds like a waste to reserve a C-h key for that. It doesn't even belong to "help" per se, IMO. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: [External] : bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-01 11:00 ` Eli Zaretskii @ 2021-10-01 17:08 ` Drew Adams 2021-10-01 18:45 ` Stefan Kangas 1 sibling, 0 replies; 31+ messages in thread From: Drew Adams @ 2021-10-01 17:08 UTC (permalink / raw) To: Eli Zaretskii, Lars Ingebrigtsen Cc: gregory@heytings.org, stefan@marxist.se, 50880@debbugs.gnu.org > And I already said what I think about it: to me it sounds like a waste > to reserve a C-h key for that. It doesn't even belong to "help" per > se, IMO. +1. Just because some key is not yet taken, that's not a good reason to assign it eagerly or willy nilly. And to me this sounds like such an assignment - this doesn't need a key sequence. The need identified was just to call more attention to it. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-01 11:00 ` Eli Zaretskii 2021-10-01 17:08 ` bug#50880: [External] : " Drew Adams @ 2021-10-01 18:45 ` Stefan Kangas 2021-10-01 18:58 ` Eli Zaretskii 1 sibling, 1 reply; 31+ messages in thread From: Stefan Kangas @ 2021-10-01 18:45 UTC (permalink / raw) To: Eli Zaretskii; +Cc: 50880, Gregory Heytings, Lars Ingebrigtsen Eli Zaretskii <eliz@gnu.org> writes: > And I already said what I think about it: to me it sounds like a waste > to reserve a C-h key for that. It doesn't even belong to "help" per > se, IMO. Whether or not it belongs should not be treated formalistically, because then we might as well remove the entry "About the GNU project". The point of this is to encourage more contributions to Emacs, and the cost for doing so is low. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-01 18:45 ` Stefan Kangas @ 2021-10-01 18:58 ` Eli Zaretskii 0 siblings, 0 replies; 31+ messages in thread From: Eli Zaretskii @ 2021-10-01 18:58 UTC (permalink / raw) To: Stefan Kangas; +Cc: 50880, gregory, larsi > From: Stefan Kangas <stefan@marxist.se> > Date: Fri, 1 Oct 2021 20:45:54 +0200 > Cc: Lars Ingebrigtsen <larsi@gnus.org>, Gregory Heytings <gregory@heytings.org>, 50880@debbugs.gnu.org > > Eli Zaretskii <eliz@gnu.org> writes: > > > And I already said what I think about it: to me it sounds like a waste > > to reserve a C-h key for that. It doesn't even belong to "help" per > > se, IMO. > > Whether or not it belongs should not be treated formalistically, > because then we might as well remove the entry "About the GNU > project". No, because "About" is a de-facto standard item in the Help menu of many programs. We just made 2 of them instead of just one. > The point of this is to encourage more contributions to Emacs, and > the cost for doing so is low. But why does it need a key binding? Not every command has a key binding, and not having one doesn't mean the command isn't important. Assigning a key binding is NOT low-cost, especially in a crowded keymap such as C-h. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-01 10:17 ` Eli Zaretskii 2021-10-01 10:20 ` Lars Ingebrigtsen @ 2021-10-02 23:17 ` Richard Stallman 2021-10-02 23:51 ` Stefan Kangas 2021-10-03 5:57 ` Eli Zaretskii 1 sibling, 2 replies; 31+ messages in thread From: Richard Stallman @ 2021-10-02 23:17 UTC (permalink / raw) To: Eli Zaretskii; +Cc: 50880, gregory, stefan, larsi [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > > >> C-h g -> About the GNU project > > >> C-h G -> Emacs copying permission (GNU General Public License) > > >> C-h C-c -> Contributing > > > IMO the best proposal so far, but Lars didn't want to move the GPL > > > from 'C-h C-c' so that part unfortunately makes it a non-starter. > > > > I'm not dead set against it -- it's not like these are commands that > > people use heavily. But that cuts the other way, too -- making this new > > command mnemonic isn't really that important, either, since I'd assume > > that people would be accessing them via `C-h C-h' and then paging down, > > entering whatever key it says they should use. I.e., nobody's > > remembering these keystrokes anyway. > > > > Perhaps Eli has an opinion here? > How about not giving it a key binding at all? Why is a key binding > important in this case? It's not like people will want to read that > section twice a day. I agree. Given that key bindings are somewhat scarce, it's good to avoid using them up for commands that don't really need one. However, it may be necessary to give it a key binding so it can appear in the Help menu. And having it appear there is useful. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org) ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-02 23:17 ` Richard Stallman @ 2021-10-02 23:51 ` Stefan Kangas 2021-10-03 5:57 ` Eli Zaretskii 1 sibling, 0 replies; 31+ messages in thread From: Stefan Kangas @ 2021-10-02 23:51 UTC (permalink / raw) To: Richard Stallman; +Cc: Lars Ingebrigtsen, 50880, Gregory Heytings Richard Stallman <rms@gnu.org> writes: > However, it may be necessary to give it a key binding > so it can appear in the Help menu. And having it appear there > is useful. That's indeed the only reason it would need one. Adding a new command to the help-for-help screen without out a keybinding makes it go from looking basically acceptable to very visually unbalanced. Unfortunately, that is basically unavoidable with it's tabular format. If we really don't want a keybininding, I think this aspect would make it not worth adding to the help-for-help screen, and the question then would be if the command is even worth adding at all. I'm biased, of course, as I spent some time making sure that the help-for-help screen looks acceptable. I hope that we can attempt to preserve that new good look by not adding new commands without keybindings to it. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-02 23:17 ` Richard Stallman 2021-10-02 23:51 ` Stefan Kangas @ 2021-10-03 5:57 ` Eli Zaretskii 2021-10-03 11:55 ` Stefan Kangas 1 sibling, 1 reply; 31+ messages in thread From: Eli Zaretskii @ 2021-10-03 5:57 UTC (permalink / raw) To: rms; +Cc: 50880, gregory, stefan, larsi > From: Richard Stallman <rms@gnu.org> > Cc: larsi@gnus.org, gregory@heytings.org, stefan@marxist.se, > 50880@debbugs.gnu.org > Date: Sat, 02 Oct 2021 19:17:35 -0400 > > However, it may be necessary to give it a key binding > so it can appear in the Help menu. And having it appear there > is useful. We can have it in the Help menu without a key binding, there's no requirement that it does have a binding for that. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-03 5:57 ` Eli Zaretskii @ 2021-10-03 11:55 ` Stefan Kangas 2021-10-03 19:10 ` Gregory Heytings 0 siblings, 1 reply; 31+ messages in thread From: Stefan Kangas @ 2021-10-03 11:55 UTC (permalink / raw) To: Eli Zaretskii Cc: 50880, Gregory Heytings, Lars Ingebrigtsen, Richard Stallman Eli Zaretskii <eliz@gnu.org> writes: > We can have it in the Help menu without a key binding, there's no > requirement that it does have a binding for that. That would be worse than what we have now, for the reasons I explained. If 'C-h C-x' is too <important/expensive/etc.> to use for speculating in recruiting contributors, I suggest we close this as wontfix instead. ^ permalink raw reply [flat|nested] 31+ messages in thread
* bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) 2021-10-03 11:55 ` Stefan Kangas @ 2021-10-03 19:10 ` Gregory Heytings 0 siblings, 0 replies; 31+ messages in thread From: Gregory Heytings @ 2021-10-03 19:10 UTC (permalink / raw) To: Stefan Kangas; +Cc: 50880, Lars Ingebrigtsen, Richard Stallman > > If 'C-h C-x' is too <important/expensive/etc.> to use for speculating in > recruiting contributors, I suggest we close this as wontfix instead. > There's still one solution that should satisfy everyone, because it does not "consume" any of the still free key bindings. It would give the following section in help-for-help (aka C-h C-h): Miscellaneous C-a About Emacs C-f Emacs FAQ C-n News of recent changes C-m Order printed manuals C-p Known problems C-d Debugging Emacs C-c Contribute improvements to Emacs C-t Emacs TODO g About the GNU project G Emacs copying permission (GNU General Public License) C-o Emacs ordering and distribution information C-w Information on absence of warranty ^ permalink raw reply [flat|nested] 31+ messages in thread
end of thread, other threads:[~2021-10-03 19:10 UTC | newest] Thread overview: 31+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2021-09-28 22:55 bug#50880: Add "Contributing to Emacs" help command (see C-h C-h) Stefan Kangas 2021-09-29 7:06 ` Lars Ingebrigtsen 2021-09-29 9:11 ` Stefan Kangas 2021-09-29 9:18 ` Gregory Heytings 2021-09-29 9:41 ` Stefan Kangas 2021-09-29 16:55 ` Juri Linkov 2021-09-29 17:41 ` Stefan Kangas 2021-09-29 17:45 ` Lars Ingebrigtsen 2021-09-29 17:55 ` Eli Zaretskii 2021-09-29 18:36 ` Gregory Heytings 2021-09-29 16:00 ` Lars Ingebrigtsen 2021-09-29 16:52 ` Stefan Kangas 2021-09-30 1:10 ` Stefan Kangas 2021-09-30 6:10 ` Lars Ingebrigtsen 2021-09-30 7:49 ` Gregory Heytings 2021-09-30 11:51 ` Gregory Heytings 2021-09-30 20:01 ` Stefan Kangas 2021-10-01 7:24 ` Lars Ingebrigtsen 2021-10-01 10:17 ` Eli Zaretskii 2021-10-01 10:20 ` Lars Ingebrigtsen 2021-10-01 10:28 ` Eli Zaretskii 2021-10-01 10:32 ` Lars Ingebrigtsen 2021-10-01 11:00 ` Eli Zaretskii 2021-10-01 17:08 ` bug#50880: [External] : " Drew Adams 2021-10-01 18:45 ` Stefan Kangas 2021-10-01 18:58 ` Eli Zaretskii 2021-10-02 23:17 ` Richard Stallman 2021-10-02 23:51 ` Stefan Kangas 2021-10-03 5:57 ` Eli Zaretskii 2021-10-03 11:55 ` Stefan Kangas 2021-10-03 19:10 ` Gregory Heytings
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.