From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: question about org-region-active-p Date: Fri, 19 Dec 2008 09:39:57 +0100 Message-ID: <12C3E6B4-72E1-4C7B-B33B-DD8A15BBAE6F@uva.nl> References: <494709A4.1000703@sift.info> <9F73C60D-A8B2-4D0B-AFE0-DE210312A021@uva.nl> <4947CC95.60900@sift.info> <494908C5.5050702@sift.info> <531B6C47-6267-4530-ACF8-F2C1548159CE@uva.nl> <87d4fq4uqp.fsf@gollum.intra.norang.ca> <3471BCE9-5D57-4D71-9404-E21D66DA72CA@uva.nl> <494A7EC9.3070705@sift.info> Mime-Version: 1.0 (Apple Message framework v929.2) Content-Type: multipart/mixed; boundary="===============1869880032==" Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LDau4-0004r9-83 for emacs-orgmode@gnu.org; Fri, 19 Dec 2008 03:40:12 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LDatw-0004or-NO for emacs-orgmode@gnu.org; Fri, 19 Dec 2008 03:40:07 -0500 Received: from [199.232.76.173] (port=60169 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LDatv-0004oV-Ae for emacs-orgmode@gnu.org; Fri, 19 Dec 2008 03:40:03 -0500 Received: from ug-out-1314.google.com ([66.249.92.175]:30004) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LDatu-0002hR-0D for emacs-orgmode@gnu.org; Fri, 19 Dec 2008 03:40:02 -0500 Received: by ug-out-1314.google.com with SMTP id 36so614656uga.17 for ; Fri, 19 Dec 2008 00:40:01 -0800 (PST) In-Reply-To: <494A7EC9.3070705@sift.info> 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: Robert Goldman Cc: emacs-orgmode@gnu.org --===============1869880032== Content-Type: multipart/alternative; boundary=Apple-Mail-4-113211069 --Apple-Mail-4-113211069 Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit 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 --Apple-Mail-4-113211069 Content-Type: text/html; charset=US-ASCII Content-Transfer-Encoding: quoted-printable 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:: =             &n= bsp;  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

= --Apple-Mail-4-113211069-- --===============1869880032== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ 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 --===============1869880032==--