Include .out file(s) in the distribution (#77)

[etc/vim.git] / docs / usage.md

diff --git a/docs/usage.md b/docs/usage.md
index c27c74411d97894491c408c0c0d1e5e23b57c0bb..69ce846dea421ef8d88a86961b9dfe81117b316b 100644 (file)
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -2,28 +2,32 @@
 
 ## Installation
 
 
 ## Installation
 

-*Black* can be installed by running `pip install black`.
+*Black* can be installed by running `pip install black`.  It requires
+Python 3.6.0+ to run but you can reformat Python 2 code with it, too.
+

 
 ## Usage
 
 To get started right away with sensible defaults:
 
 ```
 
 ## Usage
 
 To get started right away with sensible defaults:
 
 ```

-black {source_file}
+black {source_file_or_directory}

 ```
 
 ```
 

+

 ### Command line options
 
 ### Command line options
 

-Some basics about the command line help, `black --help`:
+Black doesn't provide many options.  You can list them by running
+`black --help`:

 
 

-```
+```text

 Usage: black [OPTIONS] [SRC]...
 
   The uncompromising code formatter.
 
 Options:
 Usage: black [OPTIONS] [SRC]...
 
   The uncompromising code formatter.
 
 Options:

-  -l, --line-length INTEGER  How many character per line to allow.  [default:
-                             88]
+  -l, --line-length INTEGER  How many character per line to allow.
+                             [default: 88]

   --check                    Don't write back the files, just return the
                              status.  Return code 0 means nothing would
                              change.  Return code 1 means some files would be
   --check                    Don't write back the files, just return the
                              status.  Return code 0 means nothing would
                              change.  Return code 1 means some files would be


@@ -44,7 +48,8 @@ Options:
 * exits with code 0 unless an internal error occured (or `--check` was
   used).
 
 * exits with code 0 unless an internal error occured (or `--check` was
   used).
 

-## Important note about the pre-release of Black
+
+## NOTE: This tool is alpha quality at the moment

 
 *Black* can already successfully format itself and the standard library.
 It also sports a decent test suite.  However, it is still very new.
 
 *Black* can already successfully format itself and the standard library.
 It also sports a decent test suite.  However, it is still very new.