diff --git a/README.markdown b/README.markdown
index eb298cc..5bb2c6e 100644
--- a/README.markdown
+++ b/README.markdown
@@ -22,7 +22,8 @@
 3. [TodoTxt Files](#todotxt-files)
 4. [Completion](#completion)
 5. [Hierarchical Sort](#hierarchical-sort)
-6. [Mappings](#mappings)
+6. [Recurrence](#recurrence)
+7. [Mappings](#mappings)
     1. [Sort](#sort)
     2. [Priorities](#priorities)
     3. [Dates](#dates)
@@ -231,6 +232,26 @@ Examples:
 
 This is a non-standard but widely adopted keyword.
 
+## Recurrence
+
+By adding a `rec:` tag to your task, when you complete (`<LocalLeader>x`) or
+postpone (`<LocalLeader>p`) the task, a new recurrence will be created due after
+the specified amount of time.
+
+The format is:
+    `rec:[+][count][d|w|m|y]`
+
+Where:
+    d = days, w = weeks, m = months, y = years
+    The optional `+` specifies strict recurrence (see below)
+
+Examples:
+    *   `rec:2w` - Recurs two weeks after the task is completed.
+    *   `rec:3d` - Recurs three days after the task is completed.
+    *   `rec:+1w` - Recurs one week from the due date (strict)
+
+This is a non-standard but widely adopted keyword.
+
 ## Mappings
 
 By default todo-txt.vim sets all the mappings described in this section. To
@@ -311,3 +332,10 @@ disable this behavior by setting the following global variable:
 ### Format
 
 + `<LocalLeader>ff` : Try to fix todo.txt format
+
+## Fold
+
+Todo.txt files can be folded by projects or context (see `:help fold`), by
+default they are foldable by context, to use project fold :
+
+    let g:Todo_fold_char='+'
diff --git a/doc/todo.txt b/doc/todo.txt
index f5d89eb..a561db0 100644
--- a/doc/todo.txt
+++ b/doc/todo.txt
@@ -29,6 +29,7 @@ Table of Contents                                          *TodoTxt-Contents* ~
         7.3 Dates....................................|TodoTxt-Dates|
         7.4 Done.txt.................................|TodoTxt-Done|
         7.5 Format...................................|TodoTxt-Format|
+    8. Fold..........................................|TodoTxt-Fold|
 
 ===============================================================================
 1. Release notes                                       *TodoTxt-ReleaseNotes* ~
@@ -339,3 +340,12 @@ disable this behavior by setting the following global variable:
 7.5 Format                                                     *TodoTxt-format*
 
     `<LocalLeader>ff` : Try to fix todo.txt format
+
+===============================================================================
+8. Fold                                                         *TodoTxt-fold* ~
+
+Todo.txt files can be folded by projects or context (see |fold|), by default
+they are foldable by context, to use project fold :
+>
+
+    let g:Todo_fold_char='+'