Quote backslash-containing arguments in doc/tutorial.py.
authorW. Trevor King <wking@drexel.edu>
Wed, 29 Sep 2010 11:42:59 +0000 (07:42 -0400)
committerW. Trevor King <wking@drexel.edu>
Wed, 29 Sep 2010 11:42:59 +0000 (07:42 -0400)
doc/tutorial.txt

index 13e06944eec3bccfaa3c887dabf62bc80cc3053f..1e0b95709410e6d451b50dc9d2eed84e1e5fd602 100644 (file)
@@ -106,13 +106,20 @@ and you want to analyze them all.
 
 You then can ``cd`` (change directory) to the directory::
 
-    hooke> cd --path c:\curves
+    hooke> cd --path "c:\curves"
 
-Type ``pwd`` (print working directory) to check the directory is correct.::
+Hooke parses it's commandline using `POSIX rules`_, so you need to
+quote arguments with backslashes to keep them from being expanded as
+escape sequences (e.g. ``\t`` → ``TAB``).
+
+Type ``pwd`` (print working directory) to check the directory is
+correct.::
 
     hooke> pwd
     c:\curves
 
+.. _POSIX rules: http://docs.python.org/library/shlex#parsing-rules
+
 You can list the files in the directory using ``ls`` or ``dir``
 (they’re synonyms).::