From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ian Barton Subject: Re: [Patch] For the Manual: using org-crypt Date: Mon, 30 May 2011 19:23:19 +0100 Message-ID: <4DE3E097.1010501@wilkesley.net> References: <4D831E9A.9050808@manor-farm.org> <87hbatdf77.fsf@sbs.ch> <81d3lhhlja.fsf@gmail.com> <3A146A80-D27C-4FEC-BFE4-17A8A3B8F141@gmail.com> <87vcwwsdwp.fsf@sbs.ch> <4DDF7F11.8010604@manor-farm.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------070108050404060806020501" Return-path: Received: from eggs.gnu.org ([140.186.70.92]:41218) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QR77d-0002WG-F8 for emacs-orgmode@gnu.org; Mon, 30 May 2011 14:23:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QR77c-0004E3-8D for emacs-orgmode@gnu.org; Mon, 30 May 2011 14:23:25 -0400 Received: from mail.ian-barton.com ([109.74.196.44]:34157 helo=li40-130.members.linode.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QR77c-0004DH-0s for emacs-orgmode@gnu.org; Mon, 30 May 2011 14:23:24 -0400 Received: from localhost (mail.wilkesley.org [127.0.0.1]) by li40-130.members.linode.com (Postfix) with ESMTP id EB32C15A03B for ; Mon, 30 May 2011 18:23:15 +0000 (UTC) Received: from li40-130.members.linode.com ([127.0.0.1]) by localhost (mail.manor-farm.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id pDf4oCG2W12M for ; Mon, 30 May 2011 18:23:15 +0000 (UTC) Received: from [192.168.0.137] (unknown [217.146.125.41]) by li40-130.members.linode.com (Postfix) with ESMTP id 8D48115A031 for ; Mon, 30 May 2011 18:23:15 +0000 (UTC) In-Reply-To: List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org This is a multi-part message in MIME format. --------------070108050404060806020501 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Here is the patch. Thanks to Christian for his help. I have edited the text to take into account Jambunathans comments. Ian. On 27/05/11 11:47, Carsten Dominik wrote: > Actually, please just make the section in texi formatting, I or someone else will link it in into the manual structure. This is difficult to get right with a patch. Please take Jambunathans comments int account. > > Thanks > > - Carsten > > On May 27, 2011, at 12:38 PM, Ian Barton wrote: > >> On 27/05/11 10:15, Christian Egli wrote: >>> Carsten Dominik writes: >>> >>>> Is anyone working on making this a complete patch? >>> Sorry, no. >>> >> I'll have a go and try to make a proper patch against the current manual. Don't blame me if the manual breaks:) >> >> Ian. >> >> > > > --------------070108050404060806020501 Content-Type: text/x-diff; name="org-crypt.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="org-crypt.patch" >From 1861079c6db46c9be36dbbc30ef5d738d5d14193 Mon Sep 17 00:00:00 2001 From: Ian Barton Date: Mon, 30 May 2011 18:48:33 +0100 Subject: [PATCH] Add section about org-crypt.el. --- doc/org.texi | 30 +++++++++++++++++++++++++++++- 1 files changed, 29 insertions(+), 1 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index e13af4b..91cd199 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -12773,6 +12773,7 @@ emacs -Q --batch -l $ORGINSTALL \ * Clean view:: Getting rid of leading stars in the outline * TTY keys:: Using Org on a tty * Interaction:: Other Emacs packages +* org-crypt.el:: Encrypting Org files @end menu @@ -13449,7 +13450,7 @@ tty you would rather use @kbd{C-c .} to re-insert the timestamp. @end multitable -@node Interaction, , TTY keys, Miscellaneous +@node Interaction, org-crypt.el, TTY keys, Miscellaneous @section Interaction with other packages @cindex packages, interaction with other Org lives in the world of GNU Emacs and interacts in various ways @@ -13658,6 +13659,33 @@ another key for this command, or override the key in @end table ++@node org-crypt.el, , Interaction, Miscellaneous ++@section org-crypt.el ++@cindex @file{org-crypt.el} ++@cindex @code{org-decrypt-entry} + +Org-crypt will encrypt the text of an entry, but not the headline, or +properties. Org-crypt uses the Emacs EasyPG library to encrypt and decrypt +files. + +Any text below a headline that has a @samp{:crypt:} tag will be +automatically be encrypted when the file is saved. If you want to use a +different tag just customize the @code{org-crypt-tag-matcher} setting. + +To use org-crypt it is suggested that you have the following in your +@file{.emacs}: + +@example +(require 'org-crypt) +(org-crypt-use-before-save-magic) +(setq org-tags-exclude-from-inheritance (quote ("crypt"))) +;; GPG key to use for encryption +;; Either the Key ID or set to nil to use symmetric encryption. +(setq org-crypt-key nil) +@end example + +Excluding the crypt tag from inheritance prevents already encrypted text +being encrypted again. @node Hacking, MobileOrg, Miscellaneous, Top @appendix Hacking -- 1.7.4.1 --------------070108050404060806020501--