From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: [Patch] For the Manual: using org-crypt Date: Tue, 24 May 2011 15:15:09 +0200 Message-ID: <3A146A80-D27C-4FEC-BFE4-17A8A3B8F141@gmail.com> References: <4D831E9A.9050808@manor-farm.org> <87hbatdf77.fsf@sbs.ch> <81d3lhhlja.fsf@gmail.com> Mime-Version: 1.0 (Apple Message framework v1084) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([140.186.70.92]:47478) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QOrSC-0006Jr-4g for emacs-orgmode@gnu.org; Tue, 24 May 2011 09:15:25 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QOrS7-0003xy-4Z for emacs-orgmode@gnu.org; Tue, 24 May 2011 09:15:20 -0400 Received: from mail-ew0-f41.google.com ([209.85.215.41]:38288) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QOrS6-0003xu-Vo for emacs-orgmode@gnu.org; Tue, 24 May 2011 09:15:15 -0400 Received: by ewy9 with SMTP id 9so2497410ewy.0 for ; Tue, 24 May 2011 06:15:14 -0700 (PDT) In-Reply-To: <81d3lhhlja.fsf@gmail.com> 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: Jambunathan K Cc: emacs-orgmode@gnu.org, Christian Egli Hi, Is anyone working on making this a complete patch? Thanks - Carsten On Mar 23, 2011, at 5:03 PM, Jambunathan K wrote: >=20 > Thanks Christian. Some minor improvements. The intention is not to > nitpick but to build on top of what you have provided and help the > reviewer. >=20 >> +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.=20 >=20 > --8<---------------cut here---------------start------------->8--- >> EasyPG is part of recent Emacs releases (at least Emacs 23). It is >> +available as a separate package for earlier versions of Emacs. If = your >> +version of Emacs already has EasyPG do not install the package = manager's >> +version. Doing so will lead to unpredictable results. > --8<---------------cut here---------------end--------------->8--- >=20 > This information could be captured elsewhere and be left out of the > manual. (This parts reads like a tutorial entry) >=20 >> + >> +To use org-crypt you will need to have something like the following = in your >> +@file{.emacs}: >=20 > `Recommendation', `suggestion' would be a better word. Word = `something' > is ambiguous. >=20 > --8<---------------cut here---------------start------------->8--- >> +If you want to use Public Key Encryption, you will need to generate = a >> +suitable pubic/private key pair using @command{gnupg}. > --8<---------------cut here---------------end--------------->8--- >=20 > This portion better be left out of the Org manual. >=20 > --8<---------------cut here---------------start------------->8--- >> +Now any text below a headline that has a @samp{:crypt:} tag will be >> +automatically be encrypted when the file is saved.=20 > --8<---------------cut here---------------end--------------->8--- >=20 > Above portion qualifies to be part of introductory text. >=20 >=20 > --8<---------------cut here---------------start------------->8--- >> +Preventing tag inheritance stops you having encrypted text inside = encrypted >> +text. > --8<---------------cut here---------------end--------------->8--- >=20 > Above segment seems a bit out of context ... May be some supplementary > information has to go with it or is it just an implementation artefact > that the user need not bother about. Or is this part of the user > configuration? >=20 >> +To decrypt the text just call @kbd{M-x org-decrypt-entry} and the = encrypted >> +text where the point is will be replaced with the plain text.=20 >=20 > The first part is complete in itself. The latter can be removed. >=20 > --8<---------------cut here---------------start------------->8--- >> If you use this +feature a lot, you will probably want to bind >> @kbd{M-x org-decrypt-entry} to +a key. > --8<---------------cut here---------------end--------------->8--- >=20 > Shouldn't part of the manual? >=20 > Jambunathan K. >=20 >=20 > --=20 >=20 - Carsten