Hi Robert,

I have added documentation in the places you suggested.  Also, I added  
a remark in the Activation section.

Thanks.

- Carsten

On Dec 18, 2008, at 5:48 PM, Robert Goldman wrote:

> Carsten Dominik wrote:
>> Ah, so maybe Robert did not turn it off....
>>
>> Anyway, in Emacs 23 the default will be ON.  It was always my  
>> understanding
>> that in order to use regions efficiently, you needed to turn on  
>> that mode.
>>
>> Anyway, Robert, could you please try to identify a location in the  
>> docs
>> where I should put this information?  Ask yourself:  "Where would I  
>> have
>> seen this, had i been there....".
>
> Attached please find a patch file that gives a proposed set of  
> additions
> to the manual on this topic, for your review.  Interestingly enough,
> there was already an index entry for transient mark mode at the html
> export commands page.
>
> Best,
> Robert
> diff --git a/doc/org.texi b/doc/org.texi
> index 39c94aa..f8a5ea2 100644
> --- a/doc/org.texi
> +++ b/doc/org.texi
> @@ -7061,6 +7061,7 @@ is normal.
> @node Exporting, Publishing, Embedded LaTeX, Top
> @chapter Exporting
> @cindex exporting
> +@cindex Transient mark mode
>
> Org mode documents can be exported into a variety of other formats.   
> For
> printing and sharing of notes, ASCII export produces a readable and
> @@ -7073,6 +7074,10 @@ deadlines or appointments into a desktop  
> calendar program like iCal,
> Org mode can also produce extracts in the iCalendar format.  Currently
> Org mode only supports export, not import of these different formats.
>
> +Org supports export of selected regions when @code{transient mark  
> mode} is
> +enabled.  This should always be enabled in default emacs  
> configurations.
> +
> +
> @menu
> * Markup rules::                Which structures are recognized?
> * Selective export::            Using tags to select and exclude trees
> @@ -7605,7 +7610,11 @@ file.
> Export as ASCII file.  For an org file @file{myfile.org}, the ASCII  
> file
> will be @file{myfile.txt}.  The file will be overwritten without
> warning.  If there is an active region, only the region will be
> -exported. If the selected region is a single tree@footnote{To  
> select the
> +exported.@footnote{Exporting by active region will only work if  
> @code{transient mark
> +  mode} is enabled.  This should almost always be enabled.   
> However, if it is
> +not enabled, attempts to export a region will result in exporting  
> the entire
> +org file.  If this happens, check the setting of the variable
> +@code{transient-mark-mode} in your emacs.} If the selected region  
> is a single tree@footnote{To select the
> current subtree, use @kbd{C-c @@}.}, the tree head will
> become the document title.  If the tree head entry has or inherits an
> @code{EXPORT_FILE_NAME} property, that name will be used for the
> @@ -7662,11 +7671,16 @@ language, but with additional support for  
> tables.
> @item C-c C-e h
> Export as HTML file @file{myfile.html}.  For an org file  
> @file{myfile.org},
> the ASCII file will be @file{myfile.html}.  The file will be  
> overwritten
> -without warning.  If there is an active region, only the region  
> will be
> +without warning.  If there is an active region,@footnote{Exporting  
> by active region will only work if @code{transient mark
> +  mode} is enabled.  This should almost always be enabled.   
> However, if it is
> +not enabled, attempts to export a region will result in exporting  
> the entire
> +org file.  If this happens, check the setting of the variable
> +@code{transient-mark-mode} in your emacs.} only the region will be
> exported. If the selected region is a single tree@footnote{To select  
> the
> current subtree, use @kbd{C-c @@}.}, the tree head will become the  
> document
> title.  If the tree head entry has or inherits an  
> @code{EXPORT_FILE_NAME}
> property, that name will be used for the export.
> +
> @kindex C-c C-e b
> @item C-c C-e b
> Export as HTML file and immediately open it with a browser.
> @@ -7911,8 +7925,12 @@ references, the PDF output file will be fully  
> linked.
> Export as La@TeX{} file @file{myfile.tex}.  For an org file
> @file{myfile.org}, the ASCII file will be @file{myfile.tex}.  The  
> file will
> be overwritten without warning.  If there is an active region, only  
> the
> -region will be exported. If the selected region is a single  
> tree@footnote{To
> -select the current subtree, use @kbd{C-c @@}.}, the tree head will  
> become the
> +region will be exported.@footnote{Exporting by active region will  
> only work if @code{transient mark
> +  mode} is enabled.  This should almost always be enabled.   
> However, if it is
> +not enabled, attempts to export a region will result in exporting  
> the entire
> +org file.  If this happens, check the setting of the variable
> +@code{transient-mark-mode} in your emacs.} If the selected region  
> is a single tree,@footnote{To
> +select the current subtree, use @kbd{C-c @@}.} the tree head will  
> become the
> document title.  If the tree head entry has or inherits an
> @code{EXPORT_FILE_NAME} property, that name will be used for the  
> export.
> @kindex C-c C-e L