command line: relaxed checking of config creation (BMC #14805)

SyncEvolution used to insist on having a template when creating a
config from scratch. This was meant to address typos like "--configure
sheduleworld".  But when the command line contains enough information,
no template is needed.

The same logic was applied to configuring a source: if a source was not
among those defined by the template, configuring it was rejected as a
typo.

With this patch, there are two ways around these checks:
- --template none and/or
- specifying required properties on the command line

This patch also removes the special cases for "your SyncML server
account name/password". Username/password aren't always needed
(previous patch), nor are they always for a SyncML server anymore.

1 files changed, 17 insertions, 2 deletions

diff --git a/README.rst b/README.rst
index 8610601a..0c801353 100644
--- a/README.rst
+++ b/README.rst
@@ -300,9 +300,15 @@ a list of valid values.
 
 --configure|-c
   Modify the configuration files for the selected peer and/or sources.
+
   If no such configuration exists, then a new one is created using one
-  of the template configurations (see --template option). When
-  creating a new configuration and listing sources explicitly on the
+  of the template configurations (see --template option). Choosing a
+  template sets most of the relevant properties for the peer and the
+  default set of sources (see above for a list of those). Anything
+  specific to the user (like username/password) still has to be set
+  manually.
+
+  When creating a new configuration and listing sources explicitly on the
   command line, only those sources will be set to active in the new
   configuration, i.e. `syncevolution -c memotoo addressbook`
   followed by `syncevolution memotoo` will only synchronize the
@@ -310,6 +316,15 @@ a list of valid values.
   When modifying an existing configuration and sources are specified,
   then the source properties of only those sources are modified.
 
+  By default, creating a config requires a template. Source names on the
+  command line must match those in the template. This allows catching
+  typos in the peer and source names. But it also prevents some advanced
+  use cases. Therefore it is possible to disable these checks in two ways::
+
+    - use `--template none` or
+    - specify all required sync and source properties that are normally
+      in the templates on the command line (syncURL, backend, ...)
+
 --run|-r
   To prevent accidental sync runs when a configuration change was
   intended, but the `--configure` option was not used, `--run` must be