owncloudcmd and owncloud.cfg need better documentation

[ghost]

The documentation for owncloudcmd and owncloud.cfg is insufficient to actually help set up and be able to sync using owncloudcmd.

Anyone who reads that documentation to try to sync with an owncloud server will likely not be able to. The documentation doesn't even explain all the necessary steps to actually set up the local owncloud directory. There is no information about where, if anywhere, the local owncloud directory is supposed to be specified in owncloud.cfg.

There is insufficient information about the auth process and whether its even possible to store the credentials in owncloud.cfg. Also, if someone is trying to specify the auth credentials as command-line switches to owncloudcmd as in the example, what about complex passwords that are likely to contain characters such as *$%& which are likely to confuse BASH?

Finally, there is no comprehensive listing of every available option for owncloud.cfg which there should be for reference purposes.

The closest information I could dig up on the web is the article "Headless Command Line Sync for ownCloud on Linux" which also is not comprehensive enough and uses old options.

[danimo]

https://github.com/owncloud/mirall/blob/1.7/doc/owncloudcmd.1.rst is more specific about the owncloudcmd. As owncloudcmd does not read anything from owncloud.cfg (anymore), this part is obsolete. also, owncloud.cfg does not contain passwords. The alternative, if you do not want to specify the commands as a parameter with --password (which takes special chars just fine if you put them inside single quotes), you can use netrc (5).

[naude]

I struggled implementing owncloudcmd on an ubuntu 14.04 headless server and finally got it working by importing the opensuse.org repositories from this page https://software.opensuse.org/download/package?project=isv:ownCloud:desktop&package=owncloud-client

Created an ownCloud directory in the headless server's user home dir and thanks to danimo updating the ownlcoudcmd not needing the confdir it then worked lovely doing this

$ owncloudcmd -u owncloudusername -p 'owncloudpass' /home/headlessuser/ownCloud/ https://ownclouddom/cloud/remote.php/webdav/