From mboxrd@z Thu Jan 1 00:00:00 1970 From: Robert Goldman Subject: Re: question about org-region-active-p Date: Thu, 18 Dec 2008 10:48:09 -0600 Message-ID: <494A7EC9.3070705@sift.info> 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> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------030509020203060108040002" Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LDMFO-0007gT-K2 for emacs-orgmode@gnu.org; Thu, 18 Dec 2008 12:01:14 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LDMFM-0007fb-Lr for emacs-orgmode@gnu.org; Thu, 18 Dec 2008 12:01:13 -0500 Received: from [199.232.76.173] (port=50169 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LDMFK-0007fR-S2 for emacs-orgmode@gnu.org; Thu, 18 Dec 2008 12:01:12 -0500 Received: from outbound-mail-309.bluehost.com ([67.222.54.2]:60216) by monty-python.gnu.org with smtp (Exim 4.60) (envelope-from ) id 1LDMFK-0008Vn-6s for emacs-orgmode@gnu.org; Thu, 18 Dec 2008 12:01:10 -0500 In-Reply-To: <3471BCE9-5D57-4D71-9404-E21D66DA72CA@uva.nl> 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: Carsten Dominik Cc: emacs-orgmode@gnu.org This is a multi-part message in MIME format. --------------030509020203060108040002 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit 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 --------------030509020203060108040002 Content-Type: text/plain; x-mac-type="0"; x-mac-creator="0"; name="send-to-carsten.patch" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="send-to-carsten.patch" 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 --------------030509020203060108040002 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 --------------030509020203060108040002--