From mboxrd@z Thu Jan 1 00:00:00 1970 From: Torsten Wagner Subject: Re: layout org-babel menu WAS: About org-babel menu Date: Fri, 6 Apr 2012 10:51:56 +0900 Message-ID: References: <87d388lo8f.fsf@gmail.com> <87pqc8acwy.fsf@gmx.com> <4F67458D.5090904@gmail.com> <87mx71mymu.fsf@gnu.org> <4F7D6125.40309@gmail.com> <87pqbm8i0t.fsf@gmx.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([208.118.235.92]:47483) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SFyLL-0005Hf-1I for emacs-orgmode@gnu.org; Thu, 05 Apr 2012 21:52:05 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SFyLG-0001IP-Jn for emacs-orgmode@gnu.org; Thu, 05 Apr 2012 21:52:02 -0400 Received: from mail-gy0-f169.google.com ([209.85.160.169]:41593) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SFyLG-0001IL-BW for emacs-orgmode@gnu.org; Thu, 05 Apr 2012 21:51:58 -0400 Received: by ghrr18 with SMTP id r18so1335223ghr.0 for ; Thu, 05 Apr 2012 18:51:56 -0700 (PDT) In-Reply-To: <87pqbm8i0t.fsf@gmx.com> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Eric Schulte Cc: FengShu , emacs-orgmode@gnu.org Hi, for me the biggest "trouble" with babel is to remember the possible keywords in the header for different languages. There were a lot of ongoing syntax change which did not make it easier for me to remember all this. Thus a menu which is organised by languages offering all possible settings for each language would be very helpful. | Python | | | export - code - result - both - none | | | tangle - no - yes- filename | | | result - value - output | | | ... | ... Not sure how effectual this would be in a main menu. It would be definitely awesome in a context menu That would be (copied from worg) [*] indicates cursor position #+NAME: factorial #+BEGIN_SRC haskell [*] :results silent :exports code :var n=3D0 a context menu would appear presenting all possible header arguments for ha= skell #+NAME: factorial #+BEGIN_SRC haskell :results [*] :exports code :var n=3D0 a context menu presenting all possible values for the header argument :results in haskell I guess that together with the possibility to call this menu by keyboard strokes or alternatively show the same infos in the minibuffer would be a great win for babel and it would make many questions here on the list unnecessary. Furthermore, any change or extension in the syntax for a certain language would be directly reflected to the end-user. E.g., If I suddenly see the menu entry :exports 3dprint, I would be curious and check it out on worg and the manual ;) Totti On 5 April 2012 21:44, Eric Schulte wrote: > Rainer M Krug writes: > >> On 28/03/12 01:07, Bastien wrote: >>> Hi Rainer, >>> >>> Rainer M Krug writes: >>> >>>> So I would see it as a useful way of promoting babel (and therefore or= g-mode) and also as a >>>> nice reminder of less frequently (but nevertheless usefull) functional= ity. >>> >>> Agreed. >>> >>> Is anyone volunteering for listing the items in such a menu for Babel? >>> >>> If so, I'm willing to implement this. >> OK - let me start this. >> >> Org >> | >> + Babel >> =A0 | >> =A0 + edit >> =A0 | =A0| >> =A0 | =A0+ open surce buffer (that C-c ') >> =A0 | =A0+ insert source block skeleton >> =A0 | =A0+ ... >> =A0 | =A0+ ... >> =A0 | >> =A0 + tangle >> =A0 | =A0| >> =A0 | =A0+ tangle buffer >> =A0 | =A0+ inverse tangle >> =A0 | =A0+ ... >> =A0 | =A0+ ... >> =A0 | >> =A0 + evaluate >> =A0 | =A0| >> =A0 | =A0+ evaluate code block >> =A0 | =A0+ evaluate subtree >> =A0 | =A0+ ... >> =A0 | =A0+ ... >> =A0 | =A0+ ... >> =A0 | =A0+ ... >> =A0 | >> =A0 + help >> =A0 | =A0| >> =A0 | =A0+ Link to info help on header arguments >> =A0 | =A0+ Link to info help on how to enable languages >> =A0 | =A0+ URL to language specific help on worg >> =A0 | =A0+ ... >> =A0 | =A0+ ... >> >> >> So - At the moment this is a skeleton of the babel menu - Comments? forg= otten commands (I assume >> many? >> > > Hi Rainer, > > Thanks for starting this. =A0It looks like a great skeleton. =A0Here are = a > couple of comments which I hope are helpful. > > To find more publicly available Babel function you can do C-c C-v h in > an Org-mode buffer or run the org-babel-describe-bindings command > > There are two high level sub-menus which I may suggest be added to the > above, namely "languages" and "library of babel", which could list > information on available languages and list library of babel functions > respectively. > > I'm not sure how menus are normally used, specifically how Emacs breaks > functionality between the menu, configuration and help sub-systems. =A0It > is possible that because of such boundaries both the "help" and > "languages" submenus may not be appropriate. > > Two other pieces of menu content which occur to me are a list of the > code blocks available in the current buffer including some information > on each block (e.g., name, arguments,), and a way to show the user what > the current file wide header arguments are -- note: there already exists > a function for displaying this information on the code block level > `org-babel-view-source-block-info' which may be sufficient. > > Cheers, > >> >>> >>> I'm not convince we should have a menu item to (de)activate each langua= ge though -- more a menu >>> that exposes the basics. >> >> Agreed. >> >> Cheers, >> >> Rainer >> >> >> >> >>> >>> Thanks, >>> > > -- > Eric Schulte > http://cs.unm.edu/~eschulte/ >