From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daimrod Subject: Re: [PATCH] Re: #+PROPERTY documentation Date: Thu, 24 Jan 2013 13:20:23 +0100 Message-ID: <87ehharcvs.fsf@casa.home> References: <871udee5ux.fsf@casa.home> <874niaavzf.fsf@casa.home> <871uddxsfy.fsf@bzg.ath.cx> <87y5flcnro.fsf@casa.home> <87vcapwaky.fsf@bzg.ath.cx> 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]:54976) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TyLlW-0007o5-M3 for emacs-orgmode@gnu.org; Thu, 24 Jan 2013 07:18:48 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TyLlU-0003HB-Kf for emacs-orgmode@gnu.org; Thu, 24 Jan 2013 07:18:46 -0500 Received: from mail-wg0-f48.google.com ([74.125.82.48]:36451) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TyLlU-0003Gn-Ap for emacs-orgmode@gnu.org; Thu, 24 Jan 2013 07:18:44 -0500 Received: by mail-wg0-f48.google.com with SMTP id 16so2606868wgi.27 for ; Thu, 24 Jan 2013 04:18:42 -0800 (PST) In-Reply-To: <87vcapwaky.fsf@bzg.ath.cx> (Bastien's message of "Tue, 22 Jan 2013 15:34:21 +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: Bastien Cc: emacs-orgmode@gnu.org --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Bastien writes: > Yes, close to perfect. As noted in the link I gave, you need to use > `C-x 4 a' in the section of the manual you changed in order to create > a proper ChangeLog. It's weird, `C-x 4 a' wasn't able to determine correctly the sections changed. :/ > In your case, the ChangeLog should start like this: > > * org.texi (Property syntax, Buffer-wide header arguments): > > Also, please add only one such footnote. Having twice the same > footnote is confusing for the readers -- if they remember "there > is a footnote for this..." they will not be able to remember if=20 > it was the first or the second one. Choose the one that is the > most important -- given that the information is already available=20 > in another section. You're right. I've replaced the footnote by a paragraph in (info "(org) Property syntax") because this footnote was already present elsewhere, and removed the footnote in (info "(org) Buffer-wide header arguments") because there is a link to (info "(org) Property syntax"). Here is (I hope) the final patch :) --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-Update-documentation-of-buffer-wide-properties.patch Content-Transfer-Encoding: quoted-printable From=20be60dcba66d24d84986ea2650c2ef6ad96d29c8e Mon Sep 17 00:00:00 2001 From: =3D?UTF-8?q?Gr=3DC3=3DA9goire=3D20Jadi?=3D Date: Thu, 24 Jan 2013 13:04:11 +0100 Subject: [PATCH] Update documentation of buffer-wide properties * doc/org.texi (Property syntax): Recall the user to refresh the org buffer when properties are set on a per-file basis. TINYCHANGE =2D-- doc/org.texi | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/org.texi b/doc/org.texi index 61f1ee5..6447f9c 100644 =2D-- a/doc/org.texi +++ b/doc/org.texi @@ -4961,6 +4961,9 @@ file, use a line like #+PROPERTY: NDisks_ALL 1 2 3 4 @end example =20 +Contrary to properties set from a special drawer, you have to refresh the +buffer with @kbd{C-c C-c} to activate this changes. + If you want to add to the value of an existing property, append a @code{+}= to the property name. The following results in the property @code{var} having the value ``foo=3D1 bar=3D2''. =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) iQIcBAEBAgAGBQJRAScJAAoJEBNzVHcrZRiU5FYP/jsLu5ycYjYoGElwglnGR1CL y586UcqHTl/5zSOx7vPlRv93QZruaaNSMZcbZz2wGbBT8ISp51h366LN3K73FyEm A3uoe2pjGA/+t+ygRwyWH1XWgc5ghILrRipfIvmEYkVkAeC68SOuulv/oMI+jNwt afixVW9wvRodj3ldfAxv3PEqg7XOL0pPQ8J55MZKpQf8mf3FpFXyduWSyn+guRB1 IdFB+PMoZVD3g90RYkhXfgDbSbSarY/V+DHdyZwLgJmLPkasYmC1MB4qTCXUbIBH rNif969zrVttRWnt7UHUfha8MdHbiuycamO6m9OxQQJLQyXccvltvk6qtovr5RZ+ LoABd0VQtpBjTDszoiTt3d9q3YgfDXTJ39o5Hx5n5oM9DPqjXo0b3ZxRuBGMhq97 iE9ALwc6W6OjbWOZbngzGsAY0EmOFCbXMh5FSvWF8kKf2h7vGKMOAM2hbBBD7Wno zgaJPiwlu6//bCyiflbVwVuNQ8K/nb/xEsYcvoBpMAF+i6aX17odBHGht5UAew8w wtTZyNGc5Pg1PLQbMPkRDn6opOcU9O8z1T8D6MP29rLXJHVzuiWfnhmW30khZfrc KddRuoDXWRBu13m84oMM4kIgTQuPk03xT9y3He7eDU5J5sc8aAXzWESXUXvbiNRv EBj3nZpgcwGDIwwGwSNl =j7CF -----END PGP SIGNATURE----- --==-=-=--