Documentation

- Updated task-sync man page discussion of different syncing options.
This commit is contained in:
Paul Beckingham 2013-11-03 13:43:54 -05:00
parent 6c63c4a196
commit 2ce8f4a416

View file

@ -20,13 +20,14 @@ There are three alternatives for syncing data, which are:
.SH OPTION 1: VERSION CONTROL SYSTEMS .SH OPTION 1: VERSION CONTROL SYSTEMS
There are several good VCS systems (git, hg, svn ...), and they function in a There are several good, distributed VCS systems (git, hg, ...) and centralized
similar fashion for our purposes. VCS systems (svn ...), and they function in a similar fashion for our purposes.
Setup is straightforward. You place your .task directory under revision Setup is straightforward. You place your .task directory under revision
control. You then need to perform a regular commit/push/pull to make sure that control. You then need to perform a regular commit/push/pull/update to make
the data is propagated when needed. You can even do this using shell scripts so sure that the data is propagated when needed. You can even do this using shell
that every task command is preceded by a 'pull' and followed by a 'push'. scripts so that every task command is preceded by a 'pull' and followed by a
'push'.
Strengths: Strengths:
.br .br
@ -71,7 +72,7 @@ Strengths:
Weaknesses: Weaknesses:
.br .br
- Tasks not properly merged - Tasks are not properly merged
.SH OPTION 3: TASK SERVER .SH OPTION 3: TASK SERVER
@ -86,10 +87,11 @@ Setup is a matter of creating an account on a Task Server (see your Task Server
provider or operate your own - see provider or operate your own - see
http://taskwarrior.org/projects/taskwarrior/wiki/Server_setup) http://taskwarrior.org/projects/taskwarrior/wiki/Server_setup)
Once you have an account, you'll receive a certificate, and a password. You'll Once you have an account, you'll receive a certificate, key and a password.
need to put the certificate somewhere like this: You'll need to put the certificate and key somewhere like this:
$ cp <name>.cert.pem ~/.task $ cp <name>.cert.pem ~/.task
$ cp <name>.key.pem ~/.task
Then you configure Taskwarrior, using the account details: Then you configure Taskwarrior, using the account details:
@ -135,6 +137,9 @@ Strengths:
.br .br
- Tolerates connectivity outage - Tolerates connectivity outage
Weaknesses:
.br
- You need to manage your own server, or gain access to a hosted server.
.SH "CREDITS & COPYRIGHTS" .SH "CREDITS & COPYRIGHTS"
Copyright (C) 2006 \- 2013 P. Beckingham, F. Hernandez. Copyright (C) 2006 \- 2013 P. Beckingham, F. Hernandez.