Update for habit documentation

Update for habit documentation

[Robert Horn]

I've been using habits and found additional uses that are actually
implemented but not mentioned in the documentation.  What I've found
useful are:

1) Using a '++' repeat style for habits that have calendar constraints.
 I use this for some activities that must be done on Monday, or on
weekends.  This works, so there is no need to change the implementation.

2) Using a '+' repeat style is good for activities that can have a
backlog.  For example, preparing weekly reports is something that is
aided by the habit tracking information.  This also works.

This affects bullet 4, which presently implies that the repeat interval
must be a '.+' style. Would the following be clear:

4. The TODO has a scheduled date, usually with a '.+' style repeat
interval.  Other repeat styles may be used.  The '++' style can handle
habits with calendar constraints, e.g., "must be done on a Monday"; and
the '+' style can be useful for habits that can have a backlog.

R Horn

Re: Update for habit documentation

[Carsten Dominik]

Hi Robert,

would you like to formulate a patch to org.texi?

Thanks

- Carsten

On Sep 21, 2010, at 5:01 PM, Robert Horn wrote:

> I've been using habits and found additional uses that are actually
> implemented but not mentioned in the documentation.  What I've found
> useful are:
>
> 1) Using a '++' repeat style for habits that have calendar  
> constraints.
> I use this for some activities that must be done on Monday, or on
> weekends.  This works, so there is no need to change the  
> implementation.
>
> 2) Using a '+' repeat style is good for activities that can have a
> backlog.  For example, preparing weekly reports is something that is
> aided by the habit tracking information.  This also works.
>
> This affects bullet 4, which presently implies that the repeat  
> interval
> must be a '.+' style. Would the following be clear:
>
> 4. The TODO has a scheduled date, usually with a '.+' style repeat
> interval.  Other repeat styles may be used.  The '++' style can handle
> habits with calendar constraints, e.g., "must be done on a Monday";  
> and
> the '+' style can be useful for habits that can have a backlog.
>
> R Horn
>
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

Re: Update for habit documentation

[Robert Horn]

On 09/29/2010 12:07 PM, Carsten Dominik wrote:
> Hi Robert,
> 
> would you like to formulate a patch to org.texi?
> 

This is my proposed patch. I hope I've done this right.

*** org.texi	2010-10-06 09:06:20.000000000 -0400
--- org.texi-original	2010-07-21 12:42:48.000000000 -0400
***************
*** 3809,3818 ****
  @item
  The property @code{STYLE} is set to the value @code{habit}.
  @item
! The TODO has a scheduled date, usually with a @code{.+} style repeat
interval.
! A @code{++} style may be appropriate for habits with time constraints,
e.g.,
! must be done on weekends, or a @code{+} style for an unusual habit
that can
! have a backlog, e.g., weekly reports.
  @item
  The TODO may also have minimum and maximum ranges specified by using the
  syntax @samp{.+2d/3d}, which says that you want to do the task at
least every
--- 3809,3815 ----
  @item
  The property @code{STYLE} is set to the value @code{habit}.
  @item
! The TODO has a scheduled date, with a @code{.+} style repeat interval.
  @item
  The TODO may also have minimum and maximum ranges specified by using the
  syntax @samp{.+2d/3d}, which says that you want to do the task at
least every

Re: Update for habit documentation

[Carsten Dominik]

Applied, thanks!

- Carsten

On Oct 13, 2010, at 9:51 PM, Robert Horn wrote:

> On 09/29/2010 12:07 PM, Carsten Dominik wrote:
>> Hi Robert,
>>
>> would you like to formulate a patch to org.texi?
>>
>
> This is my proposed patch. I hope I've done this right.
>
> *** org.texi	2010-10-06 09:06:20.000000000 -0400
> --- org.texi-original	2010-07-21 12:42:48.000000000 -0400
> ***************
> *** 3809,3818 ****
>  @item
>  The property @code{STYLE} is set to the value @code{habit}.
>  @item
> ! The TODO has a scheduled date, usually with a @code{.+} style repeat
> interval.
> ! A @code{++} style may be appropriate for habits with time  
> constraints,
> e.g.,
> ! must be done on weekends, or a @code{+} style for an unusual habit
> that can
> ! have a backlog, e.g., weekly reports.
>  @item
>  The TODO may also have minimum and maximum ranges specified by  
> using the
>  syntax @samp{.+2d/3d}, which says that you want to do the task at
> least every
> --- 3809,3815 ----
>  @item
>  The property @code{STYLE} is set to the value @code{habit}.
>  @item
> ! The TODO has a scheduled date, with a @code{.+} style repeat  
> interval.
>  @item
>  The TODO may also have minimum and maximum ranges specified by  
> using the
>  syntax @samp{.+2d/3d}, which says that you want to do the task at
> least every

- Carsten