Update download docs [ci skip]
@@ -23,11 +23,11 @@ type `spacy --help`.
## Download {#download}
Download [models](/usage/models) for spaCy. The downloader finds the
-best-matching compatible version, uses pip to download the model as a package
-and automatically creates a [shortcut link](/usage/models#usage) to load the
-model by name. Direct downloads don't perform any compatibility checks and
-require the model name to be specified with its version (e.g.
-`en_core_web_sm-2.0.0`).
+best-matching compatible version, uses `pip install` to download the model as a
+package and creates a [shortcut link](/usage/models#usage) if the model was
+downloaded via a shortcut. Direct downloads don't perform any compatibility
+checks and require the model name to be specified with its version (e.g.
+`en_core_web_sm-2.2.0`).
> #### Downloading best practices
>
@@ -40,16 +40,16 @@ require the model name to be specified with its version (e.g.
> also allow you to add it as a versioned package dependency to your project.
```bash
-$ python -m spacy download [model] [--direct]
+$ python -m spacy download [model] [--direct] [pip args]
```
| Argument | Type | Description |
-| ---------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model` | positional | Model name or shortcut (`en`, `de`, `en_core_web_sm`). |
| `--direct`, `-d` | flag | Force direct download of exact model version. |
-| other <Tag variant="new">2.1</Tag> | - | Additional installation options to be passed to `pip install` when installing the model package. For example, `--user` to install to the user home directory. |
+| pip args <Tag variant="new">2.1</Tag> | - | Additional installation options to be passed to `pip install` when installing the model package. For example, `--user` to install to the user home directory or `--no-deps` to not install model dependencies. |
| `--help`, `-h` | flag | Show help message and available arguments. |
-| **CREATES** | directory, symlink | The installed model package in your `site-packages` directory and a shortcut link as a symlink in `spacy/data`. |
+| **CREATES** | directory, symlink | The installed model package in your `site-packages` directory and a shortcut link as a symlink in `spacy/data` if installed via shortcut. |
## Link {#link}
@@ -369,7 +369,7 @@ $ python -m spacy train [lang] [output_path] [train_path] [dev_path]
```
| Argument | Type | Description |
-| ----------------------------------------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| --------------------------------------------------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `lang` | positional | Model language. |
| `output_path` | positional | Directory to store model in. Will be created if it doesn't exist. |
| `train_path` | positional | Location of JSON-formatted training data. Can be a file or a directory of files. |
