emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Ian Barton <lists@wilkesley.net>
To: emacs-orgmode@gnu.org
Subject: Re: [Patch] For the Manual: using org-crypt
Date: Mon, 30 May 2011 19:23:19 +0100	[thread overview]
Message-ID: <4DE3E097.1010501@wilkesley.net> (raw)
In-Reply-To: <EC782DA7-22B0-4B54-950D-CA00F00DAF8C@gmail.com>

[-- 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


  parent reply	other threads:[~2011-05-30 18:23 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-03-18  8:58 [Patch] For the Manual: using org-crypt Ian Barton
2011-03-23 10:00 ` Julien Danjou
2011-03-23 15:33   ` Christian Egli
2011-03-23 16:03     ` Jambunathan K
2011-05-24 13:15       ` Carsten Dominik
2011-05-27  9:15         ` Christian Egli
2011-05-27 10:38           ` Ian Barton
     [not found]             ` <EC782DA7-22B0-4B54-950D-CA00F00DAF8C@gmail.com>
2011-05-30 18:23               ` Ian Barton [this message]
2011-05-31 11:40                 ` Carsten Dominik

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=4DE3E097.1010501@wilkesley.net \
    --to=lists@wilkesley.net \
    --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).