From 317b7f5d40c8817482308a1e4bf72ed30d80c67a Mon Sep 17 00:00:00 2001
From: Paul Beckingham <paul@beckingham.net>
Date: Wed, 29 Dec 2010 22:54:32 -0500
Subject: [PATCH] Bug #587

- Fixed bug #587, where the man page needed clarification on quoting some
  arguments to prevent them from being broken up by the shell (thanks to
  Steve Rader).
---
 AUTHORS        |  1 +
 ChangeLog      |  3 +++
 doc/man/task.1 | 13 +++++++++++++
 3 files changed, 17 insertions(+)

diff --git a/AUTHORS b/AUTHORS
index a5715646a..4a7c7042c 100644
--- a/AUTHORS
+++ b/AUTHORS
@@ -71,4 +71,5 @@ suggestions:
   Thomas Sattler
   Erlan Sergaziev
   Eric Fluger
+  Steve Rader
 
diff --git a/ChangeLog b/ChangeLog
index 2c4b2d27c..31f0a027d 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -54,6 +54,9 @@
    uri was taken from taskrc.
  + Applied patch to fix bug #581, in which backslashes in annotations and
    descriptions caused problems (thanks to Itay Perl).
+ + Fixed bug #587, where the man page needed clarification on quoting some
+   arguments to prevent them from being broken up by the shell (thanks to
+   Steve Rader).
 
 ------ old releases ------------------------------
 
diff --git a/doc/man/task.1 b/doc/man/task.1
index 8ef1984eb..5b10ab059 100644
--- a/doc/man/task.1
+++ b/doc/man/task.1
@@ -568,6 +568,19 @@ as description:
 $ task add -- project:Home needs scheduling
 .RE
 
+In other situations, the shell sees spaces and breaks up arguments.  For
+example, this command:
+
+.RS
+$ task 123 /from this/to that/
+.RE
+
+is broken up into several arguments, which is corrected with quotes:
+
+.RS
+$ task 123 "/from this/to that/"
+.RE
+
 .SH CONFIGURATION FILE AND OVERRIDE OPTIONS
 Taskwarrior stores its configuration in a file in the user's home directory:
 ~/.taskrc . The default configuration file can be overridden with