From mboxrd@z Thu Jan 1 00:00:00 1970 From: James Harkins Subject: Re: [beamer] When are :BEAMER_envargs: used or ignored? Date: Wed, 25 Apr 2012 18:09:18 +0800 Message-ID: <874ns89l81.wl%jamshark70@dewdrop-world.net> References: <87ehtgoita.wl%jamshark70@dewdrop-world.net> <87sjfsmnhs.fsf@ucl.ac.uk> Mime-Version: 1.0 (generated by SEMI 1.14.6 - "Maruoka") Content-Type: text/plain; charset=US-ASCII Return-path: Received: from eggs.gnu.org ([208.118.235.92]:49034) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SMzA9-0004Kj-Ut for emacs-orgmode@gnu.org; Wed, 25 Apr 2012 06:09:31 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SMzA6-0005He-Mx for emacs-orgmode@gnu.org; Wed, 25 Apr 2012 06:09:29 -0400 Received: from mail-pb0-f41.google.com ([209.85.160.41]:65141) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SMzA6-0005G5-Dg for emacs-orgmode@gnu.org; Wed, 25 Apr 2012 06:09:26 -0400 Received: by pbcup15 with SMTP id up15so1272011pbc.0 for ; Wed, 25 Apr 2012 03:09:24 -0700 (PDT) In-Reply-To: <87sjfsmnhs.fsf@ucl.ac.uk> 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: emacs-orgmode@gnu.org At Wed, 25 Apr 2012 14:11:51 +0930, Eric Fraga wrote: > > It kind of strikes me like an epic hack: you have to name the headline > > after the Beamer color ID, instead of naming the headline after the > > content... not very /org/anized. > > Well, the problem is that a beamercolorbox is *not* a block and does not > expect a title parameter. It actually expects only a colour (well, a > beamer colour structure, to be precise, such as the one you have > defined). What is /org/ expected to do with the entry you specify? If the subtree is folded, then the headline shows the color descriptor but nothing about the content of the subtree! That's some distance away from "an outline works like your brain." It's not that I can't get the right output. It *is* a pretty stark inconsistency against org-mode's governing principle. Here, formatting information that is irrelevant to content is promoted to be the *most important thing* (the headline) of that subtree. What I need to see, in order to understand the structure of the content at a glance -- this IMO is org-mode's genius -- is hidden if the subtree is folded. Hm? It strikes me as flawed design. > > Worth a bug report or feature request? > > It is not a bug, IMO. Okay, it's not a bug in the strict sense of a feature that doesn't behave as designed. I would say it's a d@mn ugly design. > Whether it should be a feature request or not is debatable. The syntax > is, at present, fairly straightforward in that the headline text becomes > the argument to the environment defined. I think "the headline text becomes the argument..." is the opposite of straightforward. :-) It's also a matter of incomplete documentation. The syntax is /perhaps/ straightforward, *after* spending some time wondering why it didn't work to put the color into an environment argument (as one might reasonably guess), and then spending more time constructing some tests and looking at the *.tex output to find out which bit of org text gets put where in the TeX code. C-c C-b lists 19 ways to tag headlines for Beamer environments. [1] doesn't describe any of them. I do understand about volunteer documentation efforts (if days were 48 hours long, I still wouldn't be able to write more than half of the documentation I want to contribute to SuperCollider [2]), but I can't help feeling something is missing here. James [1] http://orgmode.org/manual/Beamer-class-export.html#Beamer-class-export [2] http://supercollider.sourceforge.net -- James Harkins /// dewdrop world jamshark70@dewdrop-world.net http://www.dewdrop-world.net "Come said the Muse, Sing me a song no poet has yet chanted, Sing me the universal." -- Whitman blog: http://www.dewdrop-world.net/words audio clips: http://www.dewdrop-world.net/audio more audio: http://soundcloud.com/dewdrop_world/tracks