Re: org-beamer bug

[Jason Dunsmore <jason.public@gmail.com>]

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?

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---

Did org-beamer previously support configuring beamer environments via
tags?  If so, why was it removed?  It seems like a nice feature.

Regards,
Jason