From 297f48a07c866c566014a6479972c2d6c95e4d54 Mon Sep 17 00:00:00 2001
From: Federico Hernandez <ultrafredde@gmail.com>
Date: Thu, 3 Jun 2010 06:52:13 +0200
Subject: [PATCH] Bug Fix #211 - it was unclear which commands modify a task
 description

- rearranged commands on man page.
- new subsection for the "modifying" commands.
---
 doc/man/task.1 | 60 ++++++++++++++++++++++++++------------------------
 1 file changed, 31 insertions(+), 29 deletions(-)

diff --git a/doc/man/task.1 b/doc/man/task.1
index 49ec59fe4..45e65b07f 100644
--- a/doc/man/task.1
+++ b/doc/man/task.1
@@ -21,39 +21,18 @@ Adds a new task to the task list.
 .B log [tags] [attrs] description
 Adds a new task that is already completed, to the task list.
 
-.TP
-.B append [tags] [attrs] description
-Appends information to an existing task.
-
-.TP
-.B prepend [tags] [attrs] description
-Prepends information to an existing task.
-
 .TP
 .B annotate ID description
 Adds an annotation to an existing task.
 
 .TP
-.B ID [tags] [attrs] [description]
-Modifies the existing task with provided information.
-
-.TP
-.B ID /from/to/
-Performs one substitution on task description and annotation for fixing mistakes.
-
-.TP
-.B ID /from/to/g
-Performs all substitutions on task description and annotation for fixing mistakes.
+.B info ID
+Shows all data and metadata for the specified task.
 
 .TP
 .B ID
 With an ID but no specific command, task runs the "info" command.
 
-.TP
-.B edit ID
-Launches an editor to let you modify all aspects of a task directly.
-Use carefully.
-
 .TP
 .B undo
 Reverts the most recent action.
@@ -70,10 +49,6 @@ Duplicates the specified task and allows modifications.
 .B delete ID
 Deletes the specified task from task list.
 
-.TP
-.B info ID
-Shows all data and metadata for the specified task.
-
 .TP
 .B start ID
 Marks the specified task as started.
@@ -150,6 +125,10 @@ Displays all possible colors, or a sample.
 .B version
 Shows the task version number
 
+.TP
+.B help
+Shows the long usage text.
+
 .TP
 .B config [name [value | '']]
 Shows the current settings in the task configuration file.  Also supports
@@ -168,9 +147,32 @@ Finally, this command removes any 'name=...' entry from the .taskrc file:
 
     task config name
 
+.SH MODIFYING SUBCOMMANDS
+
 .TP
-.B help
-Shows the long usage text.
+.B ID [tags] [attrs] [description]
+Modifies the existing task with provided information.
+
+.TP
+.B ID /from/to/
+Performs one substitution on task description and annotation for fixing mistakes.
+
+.TP
+.B ID /from/to/g
+Performs all substitutions on task description and annotation for fixing mistakes.
+
+.TP
+.B edit ID
+Launches an editor to let you modify all aspects of a task directly.
+Use carefully.
+
+.TP
+.B append [tags] [attrs] description
+Appends information to an existing task.
+
+.TP
+.B prepend [tags] [attrs] description
+Prepends information to an existing task.
 
 .SH REPORT SUBCOMMANDS