emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Carsten Dominik <dominik@science.uva.nl>
To: Robert Goldman <rpgoldman@sift.info>
Cc: emacs-orgmode@gnu.org
Subject: Re: question about org-region-active-p
Date: Fri, 19 Dec 2008 09:39:57 +0100	[thread overview]
Message-ID: <12C3E6B4-72E1-4C7B-B33B-DD8A15BBAE6F@uva.nl> (raw)
In-Reply-To: <494A7EC9.3070705@sift.info>


[-- Attachment #1.1: Type: text/plain, Size: 5182 bytes --]

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


[-- Attachment #1.2: Type: text/html, Size: 6056 bytes --]

[-- Attachment #2: Type: text/plain, Size: 204 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

  reply	other threads:[~2008-12-19  8:40 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2008-12-16  1:51 question about org-region-active-p Robert Goldman
2008-12-16  2:20 ` Samuel Wales
2008-12-16  7:53 ` Carsten Dominik
2008-12-16 15:43   ` Robert Goldman
2008-12-17  8:13     ` Carsten Dominik
2008-12-17 14:12       ` Robert Goldman
2008-12-17 16:29         ` Carsten Dominik
2008-12-17 16:38           ` Robert Goldman
2008-12-17 16:44           ` Bernt Hansen
2008-12-17 17:01             ` Carsten Dominik
2008-12-18 16:48               ` Robert Goldman
2008-12-19  8:39                 ` Carsten Dominik [this message]
2008-12-16 15:52 ` William Henney

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=12C3E6B4-72E1-4C7B-B33B-DD8A15BBAE6F@uva.nl \
    --to=dominik@science.uva.nl \
    --cc=emacs-orgmode@gnu.org \
    --cc=rpgoldman@sift.info \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).