From mboxrd@z Thu Jan 1 00:00:00 1970 From: Dan Davison Subject: Re: keys and command name info Date: Mon, 09 Aug 2010 15:28:45 -0400 Message-ID: <87tyn337rm.fsf@stats.ox.ac.uk> References: <4C5086C1.9060000@easy-emacs.de> <20100808222636.GF20223@shi.workgroup> <770A61DC-4063-4A72-95F2-21F4E7DE6E77@gmail.com> <87fwyom8iv.fsf@gmx.net> <20100809101957.GC14007@shi.workgroup> <878w4f4oy4.fsf@stats.ox.ac.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from [140.186.70.92] (port=48284 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OiY2Y-0001xp-4A for emacs-orgmode@gnu.org; Mon, 09 Aug 2010 15:31:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OiY1l-0008Kd-Qk for emacs-orgmode@gnu.org; Mon, 09 Aug 2010 15:28:55 -0400 Received: from markov.stats.ox.ac.uk ([163.1.210.1]:36776) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OiY1l-0008KQ-H7 for emacs-orgmode@gnu.org; Mon, 09 Aug 2010 15:28:53 -0400 Received: from blackcap.stats.ox.ac.uk (blackcap.stats [163.1.210.5]) by markov.stats.ox.ac.uk (8.13.6/8.13.6) with ESMTP id o79JSpcl019392 for ; Mon, 9 Aug 2010 20:28:51 +0100 (BST) In-Reply-To: <878w4f4oy4.fsf@stats.ox.ac.uk> (Dan Davison's message of "Mon, 09 Aug 2010 14:32:19 -0400") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode Dan Davison writes: > Gregor Zattler writes: > >> Hi Andreas, org-mode developers, >> * Andreas Burtzlaff [09. Aug. 2010]: >>> Carsten Dominik writes: >>>> I have put a version of the manual as modified by Andreas here: >>>> >>>> http://orgmode.org/org-manual-with-command-names.pdf >>>> >>>> Not all the command names are in there, but quite a few are. >>>> I'd like to hear from more people >>>> >>>> - if they would like to have the names there (i.e. if it would >>>> help them finding a command) > > I would like the command names in the manual. > > - Emacs-lisp has a lovely tradition of naming functions *very* > descriptively and not being afraid to use long names in the interests > of accuracy. It's a shame to lose all that by displaying only key > sequences. It's a linguistic world of its own and I like being exposed > to it. > - While one can do C-h k, that's not the same as the way one learns the > function names by skimming the manual Also, it does not add length to the HTML version of the manual, because the key sequences are already on a line of their own. And the same is true for a certain proportion of the pdf entries (when the key sequence is long, then it seems to go on its own line). > >>>> - if the position (first thing in the command description) >>>> is right, or if it would be better to have it >>>> - last thing in the description >>>> - or after the first sentence, this is how the GNUS manual >>>> does it. > > I definitely would want them out on a line of their own with the key > sequence. I liked the right-aligned model. > > Or if not right-aligned, is it possible not to have the comma? Maybe a > different font? > > Dan > >>>=20 >>> Having the function names in the manual at all makes it look a bit >>> overloaded and might lose us a couple of newbies, I think. Personally, I >>> would not have use for it. >>>=20 >>> If the names are included in the manual I strongly object to them being >>> at the beginning of the first sentence. The fixed starting column of the >>> sentences becomes variable and that makes it hard to skim through for >>> those who don't want to read the function names. >> >> +1 for the same reasons.=20 >> >> This is especially true for paragraphs like those: >> >> C-c C-n (outline-next-visible-heading) Next heading. >> C-c C-p (outline-previous-visible-heading) Previous heading. >> C-c C-f (org-forward-same-level) Next heading same level. >> C-c C-b (org-backward-same-level) Previous heading same level. >> C-c C-u (outline-up-heading) Backward to higher level heading. >> C-c C-j (org-goto) Jump to a different place without changing the curren= t outline >> visibility. Shows the document structure in a temporary buffer, = where you can >> use the following keys to find your destination: >> >> >>> What about having them in the same line as the keybinding but aligned to >>> the right? >>>=20 >>> `C-c [' org-agenda-file-to-front >>> Add current file to the list of agenda files. The file is added to >>> the front of the list. If it was already in the list, it is moved >>> to the front. With prefix arg, file is added/moved to the end. >>>=20 >>> It would make the manual longer, but at least it looks clean. >>> It is easy to neglect the function names if one wants, and just as easy >>> to skim through them. >> >> +1 for the same reasons.=20=20 >> But Andreas R=C3=B6hlers original variant is IMHO even better: >> >>>| [ ... ] >>>| `C-c [', org-agenda-file-to-front >>>| Add current file to the list of agenda files. The file is added to >>>| the front of the list. If it was already in the list, it is moved >>>| to the front. With prefix Argument, file is added/moved to the en= d. > > Yes, but let's lose the extra comma. > > `C-c [' org-agenda-file-to-front > > > > > >> >> Here the command name serves as a kind of a heading, it's easy >> to search these locations while at the same time it's easy to >> skim over the pages and not bother with the command names. >> >> >> >> My preference: >> >> 1. as in Andreas R=C3=B6hlers original ASCII rendering=20 >> 2. as in Andreas Burtzlaffs ASCII rendering >> 3. not at all >> 4. as in the test manual >> >> >> >> Just me 2=C2=A2. Either way, org-mode is great. Gregor >> >> >> P.S.: Some of the command names don't help that much: >> >> C-c C-c (org-ctrl-c-ctrl-c) If there is a checkbox (see Section 5.6 [Che= ckboxes], >> page 46) in the item line, toggle the state of the checkbox. If = not, this command >> makes sure that all the items on this list level use the same bu= llet. Furthermore, >> if this is an ordered list, make sure the numbering is OK. >> C-c - (org-ctrl-c-minus) Cycle the entire list level through the diffe= rent item- >> ize/enumerate bullets (`-', `+', `*', `1.', `1)'). With a numeri= c prefix argument >> N, select the Nth bullet from this list. If there is an active r= egion when calling >> this, all lines will be converted to list items. If the first li= ne already was a list >> item, any item markers will be removed from the list. Finally, e= ven without an >> active region, a normal line will be converted into a list item. >> C-c * (org-ctrl-c-star) Turn a plain list item into a headline (so tha= t it becomes >> a subheading at its location). See Section 2.5 [Structure editin= g], page 7, for a >> detailed explanation. >> >> But even this gives a clue in how it all works. >> >> _______________________________________________ >> Emacs-orgmode mailing list >> Please use `Reply All' to send replies to the list. >> Emacs-orgmode@gnu.org >> http://lists.gnu.org/mailman/listinfo/emacs-orgmode > > _______________________________________________ > Emacs-orgmode mailing list > Please use `Reply All' to send replies to the list. > Emacs-orgmode@gnu.org > http://lists.gnu.org/mailman/listinfo/emacs-orgmode