From: Daimrod <daimrod@gmail.com>
To: Bastien <bzg@altern.org>
Cc: emacs-orgmode@gnu.org
Subject: Re: [PATCH] Re: #+PROPERTY documentation
Date: Thu, 24 Jan 2013 13:20:23 +0100 [thread overview]
Message-ID: <87ehharcvs.fsf@casa.home> (raw)
In-Reply-To: <87vcapwaky.fsf@bzg.ath.cx> (Bastien's message of "Tue, 22 Jan 2013 15:34:21 +0100")
[-- Attachment #1.1: Type: text/plain, Size: 1102 bytes --]
Bastien <bzg@altern.org> 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
> it was the first or the second one. Choose the one that is the
> most important -- given that the information is already available
> 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 :)
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.2: 0001-Update-documentation-of-buffer-wide-properties.patch --]
[-- Type: text/x-diff, Size: 996 bytes --]
From be60dcba66d24d84986ea2650c2ef6ad96d29c8e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Jadi?= <gregoire.jadi@gmail.com>
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
---
doc/org.texi | 3 +++
1 file changed, 3 insertions(+)
diff --git a/doc/org.texi b/doc/org.texi
index 61f1ee5..6447f9c 100644
--- 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
+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=1 bar=2''.
--
1.7.10.4
[-- Attachment #1.3: Type: text/plain, Size: 21 bytes --]
--
Daimrod/Greg
[-- Attachment #2: Type: application/pgp-signature, Size: 835 bytes --]
prev parent reply other threads:[~2013-01-24 12:18 UTC|newest]
Thread overview: 17+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-01-21 18:41 #+PROPERTY documentation Daimrod
2013-01-21 22:21 ` John Hendy
2013-01-21 22:35 ` Daimrod
2013-01-21 22:47 ` John Hendy
2013-01-21 22:49 ` Daimrod
2013-01-22 0:21 ` Thomas S. Dye
2013-01-22 0:36 ` Daimrod
2013-01-22 5:27 ` Nick Dokos
2013-01-22 6:32 ` Achim Gratz
2013-01-22 13:19 ` Bastien
2013-01-22 10:19 ` Daimrod
2013-01-22 13:20 ` Bastien
2013-01-22 0:43 ` [PATCH] " Daimrod
2013-01-22 13:23 ` Bastien
2013-01-22 14:09 ` Daimrod
2013-01-22 14:34 ` Bastien
2013-01-24 12:20 ` Daimrod [this message]
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=87ehharcvs.fsf@casa.home \
--to=daimrod@gmail.com \
--cc=bzg@altern.org \
--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).