Reported-by: Mark Wooding <mdw@distorted.org.uk>
Signed-off-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
Whether to allow cargo to make network access. nailing-cargo
always passes `--offline` to cargo, unless `--online` is in
Whether to allow cargo to make network access. nailing-cargo
always passes `--offline` to cargo, unless `--online` is in
- force. The default is offline, unless the cargo subcommand is
- one which implies online (currently, `fetch`).
+ force. The default value depends on the configuration and the
+ cargo subcommand - see `[misc]` `online` in "Configuration".
Configuration
=============
Configuration
=============
cargo architecture name.
Only keys starting with an ascii uppercase letter are relevant, since
cargo architecture name.
Only keys starting with an ascii uppercase letter are relevant, since
-all other names are not looked up in this alias map.
+other names are not looked up in this alias map.
+
+`[misc]`: Miscellaneous individual nailing-cargo config
+-------------------------------------------------------
+
+ * `online`: boolean, specifying whether to pass `--offline` to cargo
+ (cargo's default is online mode). The default is offline, unless
+ nailing-cargo can see that the cargo subcommand being invoked is
+ one which requires online access (currently, `fetch`), in which
+ case the default is online.
Running the command
===================
Running the command
===================