emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [PATCH] Improved org-habits documentation
@ 2015-01-19 14:41 Andrew Francis Swann
  2015-02-03 20:26 ` Nicolas Goaziou
  0 siblings, 1 reply; 2+ messages in thread
From: Andrew Francis Swann @ 2015-01-19 14:41 UTC (permalink / raw)
  To: emacs-orgmode@gnu.org

* org.texi: Improve example in info file adding concrete indication of how
to set-up logging in the format needed by org-habits


TINYCHANGE


Signed-off-by: Andrew Swann <swann@math.au.dk>
---
 doc/org.texi | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)


diff --git a/doc/org.texi b/doc/org.texi
index f6b30f8..de31437 100644
--- a/doc/org.texi
+++ b/doc/org.texi
@@ -4550,7 +4550,8 @@ three days, but at most every two days.
 You must also have state logging for the @code{DONE} state enabled
 (@pxref{Tracking TODO state changes}), in order for historical data to be
 represented in the consistency graph.  If it is not enabled it is not an
-error, but the consistency graphs will be largely meaningless.
+error, but the consistency graphs will be largely meaningless.  One way
to do
+this is to add the logging property @code{DONE(!)} to the task.
 @end enumerate
 
 To give you an idea of what the above rules look like in action, here's an
@@ -4560,6 +4561,7 @@ actual habit with some history:
 ** TODO Shave
    SCHEDULED: <2009-10-17 Sat .+2d/4d>
    :PROPERTIES:
+   :LOGGING: DONE(!)
    :STYLE:    habit
    :LAST_REPEAT: [2009-10-19 Mon 00:36]
    :END:
-- 
2.2.1


-- 
Andrew Swann | Associate Professor | Tel +45 871 55767 | swann@math.au.dk
| http://home.math.au.dk/swann/ | Department of Mathematics, Aarhus
University, Ny Munkegade 118, Bldg 1530, DK-8000 Aarhus C, Denmark | Dept
+45 871 50000 | Fax +45 8613 1769

^ permalink raw reply related	[flat|nested] 2+ messages in thread

* Re: [PATCH] Improved org-habits documentation
  2015-01-19 14:41 [PATCH] Improved org-habits documentation Andrew Francis Swann
@ 2015-02-03 20:26 ` Nicolas Goaziou
  0 siblings, 0 replies; 2+ messages in thread
From: Nicolas Goaziou @ 2015-02-03 20:26 UTC (permalink / raw)
  To: Andrew Francis Swann; +Cc: emacs-orgmode@gnu.org

Hello,

Andrew Francis Swann <swann@math.au.dk> writes:

> * org.texi: Improve example in info file adding concrete indication of how
> to set-up logging in the format needed by org-habits

Thanks for the patch.

However, the modified paragraph already contains a reference to
"Tracking TODO state changes". Therefore, I don't see the benefit to
repeat its contents here.

Regards,

-- 
Nicolas Goaziou

^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2015-02-03 20:25 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-01-19 14:41 [PATCH] Improved org-habits documentation Andrew Francis Swann
2015-02-03 20:26 ` Nicolas Goaziou

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).