Re: [O] [PATCH] Re: #+PROPERTY documentation
Bastien b...@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 :)
From be60dcba66d24d84986ea2650c2ef6ad96d29c8e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Jadi?= gregoire.j...@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
--
Daimrod/Greg
pgp__Xs3Q56S5.pgp
Description: PGP signature
Re: [O] [PATCH] Re: #+PROPERTY documentation
Daimrod daim...@gmail.com writes: Here is a patch for this: Thanks. Please add a proper ChangeLog to it. See http://orgmode.org/worg/org-contribute.html#sec-5 You also need to add TINYCHANGE at the bottom of the git commit message. Thanks for your efforts! -- Bastien
Re: [O] [PATCH] Re: #+PROPERTY documentation
Bastien b...@altern.org writes:
Daimrod daim...@gmail.com writes:
Here is a patch for this:
Thanks. Please add a proper ChangeLog to it.
See http://orgmode.org/worg/org-contribute.html#sec-5
Thanks.
You also need to add TINYCHANGE at the bottom of the
git commit message.
Thanks for your efforts!
Is it better?
I'll also reformat my other patches.
From 4c71f10ecfdd8e44642cb18d27fe42a9b17fe1b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Jadi?= gregoire.j...@gmail.com
Date: Mon, 21 Jan 2013 23:45:47 +0100
Subject: [PATCH] Documentation: Add footnotes to recall the user to refresh
the org buffer when settings are changed
* doc/org.texi: Add a footnote to the following sections:
- (info (org) Property syntax)
- (info (org) Buffer-wide header arguments)
TINYCHANGE
---
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
--- 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
If you want to set properties that can be inherited by any entry in a
-file, 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 Org 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, ensuring
that all execution took place in the same session, and no results would be
-inserted 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.}
@example
#+PROPERTY: session *R*
--
1.7.10.4
--
Daimrod/Greg
pgp9K8GOyUhnU.pgp
Description: PGP signature
Re: [O] [PATCH] Re: #+PROPERTY documentation
Hi Daimrod, Daimrod daim...@gmail.com writes: Thanks for your efforts! Is it better? 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. 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. I'll also reformat my other patches. Thanks! -- Bastien
