From 036ab6838fd7cc4bd95ca3253d96c721fa23fd54 Mon Sep 17 00:00:00 2001
From: hachem <im@hachem.wtf>
Date: Wed, 30 Sep 2026 07:55:30 +0200
Subject: feat: add optinal tasks + proper replace

---
 todo.1 | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

(limited to 'todo.1')

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
-- 
cgit v1.3