Re: [Patch] For the Manual: using org-crypt

[Ian Barton <lists@wilkesley.net>]

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

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<carsten.dominik@gmail.com>   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.
>>
>>
>
>
>


[-- Attachment #2: org-crypt.patch --]
[-- Type: text/x-diff, Size: 2229 bytes --]

From 1861079c6db46c9be36dbbc30ef5d738d5d14193 Mon Sep 17 00:00:00 2001
From: Ian Barton <ian@wilkesley.net>
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