comparison: docs/man/dav-sync.1.man
docs/man/dav-sync.1.man
- changeset 440
- a62d312d8e53
- parent 438
- 329d57cddae8
- child 563
- 3dffe58a573f
equal
deleted
inserted
replaced
| 439:e85c93b59d1c | 440:a62d312d8e53 |
|---|---|
| 12 \f[I]arguments\f[]... | 12 \f[I]arguments\f[]... |
| 13 .SH DESCRIPTION | 13 .SH DESCRIPTION |
| 14 .PP | 14 .PP |
| 15 TODO | 15 TODO |
| 16 .SH COMMANDS | 16 .SH COMMANDS |
| 17 .PP | 17 .TP |
| 18 pull [\f[B]\-cldr\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] | 18 .B pull [\f[B]\-cldr\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] |
| 19 .PP | 19 Pulls all changes from the server. |
| 20 push [\f[B]\-cldr\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] | 20 All new or modified files are downloaded and all files deleted on the |
| 21 .PP | 21 server are deleted locally. |
| 22 archive [\f[B]\-cld\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] | 22 If a file is also locally modified and conflict detection is not |
| 23 .PP | 23 disabled, the local file is renamed and an entry in the conflict |
| 24 resolve\-conflicts \f[I]directory\f[] | 24 database is added. |
| 25 .PP | 25 .RS |
| 26 delete\-conflicts \f[I]directory\f[] | 26 .RE |
| 27 .PP | 27 .TP |
| 28 trash\-info \f[I]directory\f[] | 28 .B push [\f[B]\-cldr\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] |
| 29 .PP | 29 Pushes all local changes to the server. |
| 30 empty\-trash \f[I]directory\f[] | 30 This uploads all locally modified files and deletes all locally deleted |
| 31 .PP | 31 files on the server. |
| 32 add\-tag [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] \f[I]tag\f[] | 32 If conflict detection is not disabled, all files that are also modified |
| 33 .PP | 33 on the server will be skipped. |
| 34 remove\-tag [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] \f[I]tag\f[] | 34 .RS |
| 35 .PP | 35 .RE |
| 36 set\-tags [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] \f[I]tags\f[] | 36 .TP |
| 37 .PP | 37 .B archive [\f[B]\-cld\f[]] [\f[B]\-t\f[] \f[I]tags\f[]] \f[I]directory\f[] |
| 38 list\-tags [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] | 38 Uploads all new and modified files to the server. |
| 39 The command is similar to the push command (with the same conflict | |
| 40 behavior), however it does not delete files on the server. | |
| 41 .RS | |
| 42 .RE | |
| 43 .TP | |
| 44 .B resolve\-conflicts \f[I]directory\f[] | |
| 45 Removes conflict entries from the database. | |
| 46 This does not merge any files. | |
| 47 All files which are marked as conflict are normal files after running | |
| 48 this command. | |
| 49 In other words: by executing this command you assert that \f[B]you\f[] | |
| 50 have resolved the conflicts. | |
| 51 .RS | |
| 52 .RE | |
| 53 .TP | |
| 54 .B delete\-conflicts \f[I]directory\f[] | |
| 55 Deletes all files that are marked as a conflict. | |
| 56 This will always delete the files and does not move them to the trash | |
| 57 directory. | |
| 58 Use this command with caution. | |
| 59 .RS | |
| 60 .RE | |
| 61 .TP | |
| 62 .B trash\-info \f[I]directory\f[] | |
| 63 Shows the trash directory path for a \f[I]directory\f[], the number of | |
| 64 files currently in the trash and the space they consume. | |
| 65 .RS | |
| 66 .RE | |
| 67 .TP | |
| 68 .B empty\-trash \f[I]directory\f[] | |
| 69 Removes all files from the trash of the given \f[I]directory\f[]. | |
| 70 .RS | |
| 71 .RE | |
| 72 .TP | |
| 73 .B add\-tag [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] \f[I]tag\f[] | |
| 74 Adds a \f[I]tag\f[] to a SyncDirectory \f[I]file\f[]. | |
| 75 The \f[I]file\f[] argument must denote a local file path. | |
| 76 .RS | |
| 77 .RE | |
| 78 .TP | |
| 79 .B remove\-tag [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] \f[I]tag\f[] | |
| 80 Removes a \f[I]tag\f[] from a SyncDirectory \f[I]file\f[]. | |
| 81 See \f[B]add\-tag\f[]. | |
| 82 .RS | |
| 83 .RE | |
| 84 .TP | |
| 85 .B set\-tags [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] \f[I]tags\f[] | |
| 86 Sets the list of \f[I]tags\f[] for a SyncDirectory \f[I]file\f[]. | |
| 87 This command behaves, as if you would remove all tags with | |
| 88 \f[B]remove\-tag\f[] and add the \f[I]tags\f[] with \f[B]add\-tag\f[]. | |
| 89 .RS | |
| 90 .RE | |
| 91 .TP | |
| 92 .B list\-tags [\f[B]\-s\f[] \f[I]syncdir\f[]] \f[I]file\f[] | |
| 93 List all tags for the specified \f[I]file\f[]. | |
| 94 .RS | |
| 95 .RE | |
| 96 .SH CONFIGURATION COMMANDS | |
| 97 .TP | |
| 98 .B add\-directory | |
| 99 Runs an interactive assistant to create a SyncDirectory. | |
| 100 .RS | |
| 101 .RE | |
| 102 .TP | |
| 103 .B list\-directories | |
| 104 Lists all available SyncDirectories. | |
| 105 .RS | |
| 106 .RE | |
| 107 .TP | |
| 108 .B check\-config | |
| 109 Validates the \f[B]$HOME/.dav/sync.xml\f[] configuration file. | |
| 110 .RS | |
| 111 .RE | |
| 112 .TP | |
| 113 .B check\-repositories | |
| 114 Checks if every repository used by sync\-directories is configured and | |
| 115 available. | |
| 116 This command outputs the status for each repository. | |
| 117 It returns zero when all repositories are all available and non\-zero | |
| 118 otherwise. | |
| 119 .RS | |
| 120 .RE | |
| 39 .SH GENERAL OPTIONS | 121 .SH GENERAL OPTIONS |
| 40 .PP | 122 .PP |
| 41 The following options can be used with all commands. | 123 The following options can be used with all commands. |
| 42 .TP | 124 .TP |
| 43 .B \f[B]\-v\f[] | 125 .B \-v |
| 44 Verbose output. | 126 Verbose output. |
| 45 .RS | 127 .RS |
| 46 .RE | 128 .RE |
| 47 .SH COMMAND OPTIONS | 129 .SH COMMAND OPTIONS |
| 48 .TP | 130 .TP |
| 49 .B \f[B]\-c\f[] | 131 .B \-c |
| 50 Disable conflict detection. | 132 Disable conflict detection. |
| 51 .RS | 133 .RS |
| 52 .RE | 134 .RE |
| 53 .TP | 135 .TP |
| 54 .B \f[B]\-d\f[] | 136 .B \-d |
| 55 Don\[aq]t lock the repository. | 137 Don\[aq]t lock the repository. |
| 56 .RS | 138 .RS |
| 57 .RE | 139 .RE |
| 58 .TP | 140 .TP |
| 59 .B \f[B]\-l\f[] | 141 .B \-l |
| 60 Lock the repository before access. | 142 Lock the repository before access. |
| 61 .RS | 143 .RS |
| 62 .RE | 144 .RE |
| 63 .TP | 145 .TP |
| 64 .B \f[B]\-t\f[] \f[I]tags\f[] | 146 .B \-s \f[I]syncdir\f[] |
| 147 If multiple SyncDirectories contain a local file, this option must be | |
| 148 used to resolve the ambiguity. | |
| 149 .RS | |
| 150 .RE | |
| 151 .TP | |
| 152 .B \-t \f[I]tags\f[] | |
| 65 Only sync files which have the specified tags. | 153 Only sync files which have the specified tags. |
| 66 .RS | 154 .RS |
| 67 .RE | 155 .RE |
| 68 .TP | 156 .TP |
| 69 .B \f[B]\-r\f[] | 157 .B \-r |
| 70 Remove ressources not matching the tag filter. | 158 Remove ressources not matching the tag filter. |
| 71 .RS | 159 .RS |
| 72 .RE | 160 .RE |
| 73 .SH SEE ALSO | 161 .SH SEE ALSO |
| 74 .PP | 162 .PP |
