Merge pull request #2675 from owncloud/issue-2674

files_external:list --importable-format documentation

Author: phil-davis

modules/admin_manual/pages/configuration/server/occ_command/files_external_commands.adoc

@@ -47,12 +47,13 @@ files_external:list [--show-password] [--full] [-a|--all] [-s|--short] [--] [<us
 
 [width="100%",cols="20%,70%",]
 |===
-| `--show-password`   | User to add the mount configurations for, if not set the mount will
-be added as system mount.
-| `--full`            | Don't save the imported mounts, only list the new mounts.
-| `-a, --all`         | Show both system-wide mounts and all personal mounts.
-| `-s, --short`       | Show only a reduced mount info.
-| `--output=[OUTPUT]` | The output format to use (`plain`, `json` or `json_pretty`, default is `plain`).
+| `--show-password`        | Show passwords and secrets
+| `--mount-options         | Show all mount options independent if they are set to their default value or not
+| `--full`                 | Don't truncate long values in table output
+| `-a, --all`              | Show both system-wide mounts and all personal mounts.
+| `-s, --short`            | Show only a reduced mount info.
+| `-i, --importable-format | Provide output values in a format compatible with files_external:import
+| `--output=[OUTPUT]`      | The output format to use (`plain`, `json` or `json_pretty`, default is `plain`).
 |===
 
 === Example
@@ -68,6 +69,12 @@ be added as system mount.
 +----------+------------------+----------+
 ----
 
+NOTE: The `--importable-format` option helps to make the technical mount settings visible.
+To see all settings you still need to use the other options such as `--show-password`,
+`--full` and `--all`. When you want to export the mount settings for later import,
+use the `files_external:export` command. `files_external:export` ensures that all the
+necessary settings are included in the output.
+
 == files_external:applicable
 
 Manage applicable users and groups for a mount.