emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Robert Goldman <rpgoldman@sift.info>
To: Carsten Dominik <dominik@science.uva.nl>
Cc: emacs-orgmode@gnu.org
Subject: Re: question about org-region-active-p
Date: Thu, 18 Dec 2008 10:48:09 -0600	[thread overview]
Message-ID: <494A7EC9.3070705@sift.info> (raw)
In-Reply-To: <3471BCE9-5D57-4D71-9404-E21D66DA72CA@uva.nl>

[-- Attachment #1: Type: text/plain, Size: 663 bytes --]

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

[-- Attachment #2: send-to-carsten.patch --]
[-- Type: text/plain, Size: 4052 bytes --]

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 #3: 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-18 17:01 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 [this message]
2008-12-19  8:39                 ` Carsten Dominik
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=494A7EC9.3070705@sift.info \
    --to=rpgoldman@sift.info \
    --cc=dominik@science.uva.nl \
    --cc=emacs-orgmode@gnu.org \
    /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).