From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daimrod Subject: Re: #+PROPERTY documentation Date: Mon, 21 Jan 2013 23:49:08 +0100 Message-ID: <87mww2cftn.fsf@casa.home> References: <871udee5ux.fsf@casa.home> <87wqv6cgfr.fsf@casa.home> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([208.118.235.92]:42775) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TxQhy-0002XN-Vj for emacs-orgmode@gnu.org; Mon, 21 Jan 2013 18:23:20 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TxQhx-0003z0-OQ for emacs-orgmode@gnu.org; Mon, 21 Jan 2013 18:23:18 -0500 Received: from mail-we0-x230.google.com ([2a00:1450:400c:c03::230]:42965) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TxQ9D-000400-2B for emacs-orgmode@gnu.org; Mon, 21 Jan 2013 17:47:23 -0500 Received: by mail-we0-f176.google.com with SMTP id s43so400522wey.35 for ; Mon, 21 Jan 2013 14:47:21 -0800 (PST) In-Reply-To: <87wqv6cgfr.fsf@casa.home> (daimrod@gmail.com's message of "Mon, 21 Jan 2013 23:35:52 +0100") 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: John Hendy Cc: emacs-orgmode@gnu.org --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain Daimrod writes: > John Hendy writes: > >> On Mon, Jan 21, 2013 at 12:41 PM, Daimrod wrote: >>> Hi, >>> >>> It would be nice if the documentation mentioned the need to reparse the >>> org buffer with `C-c C-c' when a property is set with #+PROPERTY. >>> (info "(org) Property syntax") >> >> As in adding to the header arguments? Yeah, probably wouldn't hurt, >> though it is, as stated below, documented that *any* change to the >> header arguments requires C-c C-c. >> >> On a side note, is there the possibility for "normal" users to submit >> git based changes to the manual? I know how to do this for Worg, but >> I'd be happy to update stuff in the manual, too, when I catch them. >> These sorts of things could be tweaked by the finder and it would save >> the maintenance team a bit -- just scan the commit and notes for >> rationale and accept. > > Sure, one can modify the file doc/org.texi. And you're right, I should > have submit a patch. > >> John >> >>> >>> And, IMO, it should also be mentioned here: >>> (info "(org) Buffer-wide header arguments"). >>> >>> A simple footnote like the one present here: >>> (info "(org) Tag inheritance") should be sufficient. >>> >>>> (1) As with all these in-buffer settings, pressing `C-c C-c' >>>> activates any changes in the line. >>> So, here is a patch for this: --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-add-footnote-to-recall-the-user-to-refresh-the-org-b.patch Content-Transfer-Encoding: quoted-printable From=2009e569a651e77e8f2c1c2d1f0a285c69688fbd05 Mon Sep 17 00:00:00 2001 From: =3D?UTF-8?q?Gr=3DC3=3DA9goire=3D20Jadi?=3D Date: Mon, 21 Jan 2013 23:45:47 +0100 Subject: [PATCH] add footnote to recall the user to refresh the org buffer when settings are changed. =2D-- doc/org.texi | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index 61f1ee5..c2bdd58 100644 =2D-- a/doc/org.texi +++ b/doc/org.texi @@ -4954,7 +4954,9 @@ publishers and the number of disks in a box like this: @end example =20 If you want to set properties that can be inherited by any entry in a =2Dfile, use a line like +file, use a line like@footnote{As +with all these in-buffer settings, pressing @kbd{C-c C-c} activates any +changes in the line.} @cindex property, _ALL @cindex #+PROPERTY @example @@ -13252,7 +13254,9 @@ of @code{#+PROPERTY:} lines placed anywhere in an O= rg mode file (see For example the following would set @code{session} to @code{*R*}, and @code{results} to @code{silent} for every code block in the buffer, ensuri= ng that all execution took place in the same session, and no results would be =2Dinserted into the buffer. +inserted into the buffer.@footnote{As +with all these in-buffer settings, pressing @kbd{C-c C-c} activates any +changes in the line.} =20 @example #+PROPERTY: session *R* =2D-=20 1.7.10.4 --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable =2D-=20 Daimrod/Greg --=-=-=-- --==-=-= Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iQIcBAEBAgAGBQJQ/cXlAAoJEBNzVHcrZRiUHjYP/0br3jz308wZvoZ44ZiRXzHk vSfFNrhxX2ofmCPgUPV9L841wwk3TvuVtgf8L3PZ169QHcYjl8kyxkB4CP5xaHUK BK5sJ9tFuA0NJUFhczmhAqm5lVNwDnmxr42wC6Kl0wx4WyBOAptO+wwjAMaBOFzd RwDVWlSbhQs8EDsMRc0p5bkXOypnJ6da7AiFfCNxBlFm7FdmRViKRiDdTGRV2x+z XIZfED19QYXK0dMRDMRsg85+WDK94Pn1PJ6IXN5STmxAVMxQNfjInX+yez7nC+EI qFKoVZdNYyvN6lHAUAimtrWIIDT0d/jQqGCpQIfs2htRSKVRu2148CNe3NYHBl4+ VZ+ugVdSChY3mdlxbG2ripLQd/IcL8++TRa7dmzeuOH0zqjQ/DkJQQppptMfyos7 VyLgh7UE/ULh8+oB67uBwxXnK7/0wHIe0F03jFFdGlBDUC4CCx3ylYpeqziXcbGn oqlh/yTEjtY/j72iACfnwGUKjCesAoyII0cefJ885IRXL2zHnD/tERQPGVEGmdUi etXtbSFHRu3LaqIjfu+V/3J5vXTOKvfYHogcIQOzC/4BbwNyBgnwaHmAXpHWWUVi qfRCiao8PryKykZL4yZngyuYhfJJGnNxuApXT6jIqa1hL7OnUGn56ArVpat2TF7j IGUATSGVnX4MkRkI05KH =LiHZ -----END PGP SIGNATURE----- --==-=-=--