From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: Re: org-beamer bug Date: Fri, 26 Mar 2010 08:30:52 +0100 Message-ID: References: <87eij85rbi.fsf@riotblast.dunsmor.com> <877hp0gw18.fsf@fastmail.fm> <87aatw5fzi.fsf@riotblast.dunsmor.com> Mime-Version: 1.0 (Apple Message framework v936) Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Nv4NG-0008Rd-72 for emacs-orgmode@gnu.org; Fri, 26 Mar 2010 03:54:34 -0400 Received: from [140.186.70.92] (port=48887 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Nv4ND-0008Q7-Dl for emacs-orgmode@gnu.org; Fri, 26 Mar 2010 03:54:33 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1Nv4NB-0001vv-0u for emacs-orgmode@gnu.org; Fri, 26 Mar 2010 03:54:30 -0400 Received: from mail-ew0-f227.google.com ([209.85.219.227]:52756) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Nv4NA-0001vB-QD for emacs-orgmode@gnu.org; Fri, 26 Mar 2010 03:54:28 -0400 Received: by mail-ew0-f227.google.com with SMTP id 27so44516ewy.30 for ; Fri, 26 Mar 2010 00:54:28 -0700 (PDT) In-Reply-To: <87aatw5fzi.fsf@riotblast.dunsmor.com> 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: Jason Dunsmore Cc: Matt Lundin , emacs-orgmode@gnu.org On Mar 25, 2010, at 9:00 PM, Jason Dunsmore wrote: > Thanks for the explanation. > > The documentation is confusing. > >> If this property is set, the entry will also get a `:B_environment:' >> tag to make this visible. This tag has no semantic meaning, it is >> only a visual aid. > > I thought there was actually a `:B_environment:' tag. I also didn't > know that this was referring to auto-selecting the tag when using the > PROPERTIES selection interface (C-c C-c inside a PROPERTIES drawer). > > For that part of the documentation, I would suggest: > > ``If this property is set using C-c C-c inside the properties drawer, > the entry will also get an environment tag (eg. :B_block:) to make > this visible. This tag has no semantic meaning, it is only a visual > aid.'' > > The org-beamer-set-environment-tag docstring states: > > ``Set an environment tag, to determine the beamer environment to be > used. > This makes use of the fast tag selection interface.'' > > But it doesn't determine the beamer environment to be used. I would > suggest instead: > > ``Set a beamer environment tag using the fast tag selection interface. > This is only a visual aid to indicate the beamer environment > configured in the :BEAMER_env: property.'' > > What is the point of having an interface to select the beamer > environment tags (C-c C-b) if they are auto-generated? Hi Jason, the documentation is indeed not very clear on this, also because the background is confusing: 1. Only the property counts, the tag is visual and has no semantic meaning 2. I am using a property because all the other beamer stuff is also properties 3. To make selecting the correct environment very convenient and fast, I am using a special version of the tag interface which will change both the tag and the property value. I'll see if I can make the documentation clearer here. In fact, even the function name org-beamer-set-environment-tag is bad, and I have just changed it to org-beamer-select-environment'. While this does improve the documentation, I still think that more extensive documentation, examples and tutorial for the beamer support would be very good to have on Worg, and I have not lost hope that someone will pick up this task. > > Also, the example from > http://orgmode.org/manual/Beamer-class-export.html shows a :B_block: > tag > in use without the :BEAMER_env: property. > > --8<---------------cut here---------------start------------->8--- > *** > Request :B_block: > Please test this stuff! > --8<---------------cut here---------------end--------------->8--- > > This should be: > > --8<---------------cut here---------------start------------->8--- > *** > Request :B_block: > :PROPERTIES: > :BEAMER_env: block > :END: > Please test this stuff! > --8<---------------cut here---------------end--------------->8--- Indeed, thanks for catching this documentation bug. > > Did org-beamer previously support configuring beamer environments via > tags? Yes, for a short time > If so, why was it removed? It seems like a nice feature. Because we added much more functionality, all of which was using properties. Regards - Carsten