1 files changed, 13 insertions, 3 deletions
diff --git a/todo.1 b/todo.1
index 9deb04e..c9eb00f 100644
--- a/todo.1
+++ b/todo.1
@@ -40,6 +40,14 @@ for deeper levels
 .BI \- " name"
 A subtask of the task above it, indented further. A task is finished
 automatically once all of its subtasks are done.
+.TP
+.BI * " name"
+An optional task, shown with parentheses
+.RB ( "( )" )
+instead of a checkbox.
+.PP
+Within each section, items are grouped \(em required, then optional, then done
+\(em with a blank line between the groups.
 .PP
 Each task carries one of three states, written in its checkbox:
 .B [\ ]
@@ -79,7 +87,7 @@ Enter insert mode at the cursor.
 Append to the item's text.
 .TP
 .B R
-Replace the item's text.
+Enter replace mode, overtyping characters from the cursor.
 .TP
 .B x
 Toggle the item between done and not done.
@@ -147,8 +155,10 @@ The default list. Each line is a task
 .RB ( "[ ] text" ", " "[-] text" ", " "[x] text" ),
 a section
 .RB ( "= name" ),
-or a subtask
-.RB ( "- name" ).
+a subtask
+.RB ( "- name" ),
+or an optional task
+.RB ( "* name" ).
 Override the location with
 .BR $TODO_FILE .
 .SH ENVIRONMENT