Mercurial > gcp
annotate README @ 58:58091eac8c8e
exit status updated and shown in manpage
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Mon, 20 Jun 2011 12:57:15 +0200 |
| parents | b0c96e4ab9d8 |
| children | 67385805ae48 |
| rev | line source |
|---|---|
|
40
8cd8cd9da541
updated date in source code & README + updated links
Goffi <goffi@goffi.org>
parents:
31
diff
changeset
|
1 gcp v0.1.2 |
|
8cd8cd9da541
updated date in source code & README + updated links
Goffi <goffi@goffi.org>
parents:
31
diff
changeset
|
2 (c) Jérôme Poisson aka Goffi 2010, 2011 |
| 19 | 3 |
| 4 gcp (Goffi's cp) is a files copier. | |
| 5 | |
| 6 | |
| 7 ** LICENSE ** | |
| 8 | |
| 9 gcp is free software: you can redistribute it and/or modify | |
| 10 it under the terms of the GNU General Public License as published by | |
| 11 the Free Software Foundation, either version 3 of the License, or | |
| 12 (at your option) any later version. | |
| 13 | |
| 14 gcp is distributed in the hope that it will be useful, | |
| 15 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
| 17 GNU General Public License for more details. | |
| 18 | |
| 19 You should have received a copy of the GNU General Public License | |
| 20 along with gcp. If not, see <http://www.gnu.org/licenses/>. | |
| 21 | |
| 22 | |
| 23 | |
| 24 ** WTF ? ** | |
|
21
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
25 gcp is a file copier, loosely inspired from cp, but with high level functionalities like: |
| 22 | 26 - progression indicator |
| 27 - gcp continue copying even when there is an issue: he just skip the file with problem, and go on | |
|
24
154fe67bae72
Journal double-entry check + unicode source_path fix + typo
Goffi <goffi@goffi.org>
parents:
22
diff
changeset
|
28 - journalization: gcp write what he is doing, this allow to know which files were effectively copied |
| 22 | 29 - fixing names to be compatible with the target filesystem (e.g. removing incompatible chars like "?" or "*" on vfat) |
| 30 - if you launch a copy when an other is already running, the files are added to the first queue, this avoid your hard drive to move its read/write head all the time | |
| 31 - files saving: you can keep track of files you have copied, and re-copy them later (useful when, for example, you always copy some free music to all your friends). | |
| 32 - gcp will be approximately option-compatible with cp (approximately because the behaviour is not exactly the same, see below) | |
| 19 | 33 |
| 34 /!\ WARNING /!\ | |
| 35 gcp is at an early stage of development, and really experimental: use at your own risks ! | |
| 36 | |
| 37 ** How to use it ? ** | |
| 38 Pretty much like cp (see gcp --help). | |
| 39 Please note that the behaviour is not exactly the same as cp, even if gcp want to be option-compatible. Mainly, the destination filenames can be changed (by default, can be deactivated). | |
| 40 gcp doesn't implement yet all the options from cp, but it's planed. | |
| 41 | |
|
21
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
42 ** journalizaion ** |
|
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
43 The journal is planed to be used by gcp itself, buts remains human-readable. It is located in ~/.gcp/journal |
|
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
44 |
|
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
45 3 states are used: |
|
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
46 - OK means the file is copied and all operation were successful |
|
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
47 - PARTIAL means the file is copied, but something went wrong (e.g. changing the permissions of the file) |
|
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
48 - FAILED: the file is *not* copied |
|
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
49 |
|
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
50 after the state, a list of things which went wront are show, separated by ", " |
|
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
51 |
| 19 | 52 ** What's next ? ** |
| 53 | |
|
21
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
54 Several improvment are already planed |
| 19 | 55 - copy queue management (moving copy order) |
| 56 - advanced console interface | |
| 57 - notification (xmpp and maybe mail) when a long copy is finished | |
|
21
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
58 - retry for files which were not correctly copied |
| 19 | 59 - badly encoded unicode filenames fix |
|
21
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
60 - file copy integrity check |
| 19 | 61 |
| 62 ... and other are with a "maybe" | |
| 63 - graphic interface | |
| 64 - desktop (Kde, Gnome, XFCE, ...) integration | |
|
21
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
65 - distant copy (ftp) |
|
8603fcb8615a
--no-unicode-fix commented, and README update
Goffi <goffi@goffi.org>
parents:
19
diff
changeset
|
66 - basic server mode, for copying files on network without the need of nfs or other heavy stuff |
| 19 | 67 |
| 68 ** Credits ** | |
| 69 | |
| 70 A big big thank to the authors/contributors of... | |
| 71 | |
| 22 | 72 progressbar: |
| 73 gcp use ProgressBar (http://pypi.python.org/pypi/progressbar/2.2), a class coded by Nilton Volpato which allow the textual representation of progression. | |
| 19 | 74 |
| 22 | 75 GLib: |
| 76 This heavily used library is used here for the main loop, event catching, and for DBus. Get it at http://library.gnome.org/devel/glib/ | |
| 19 | 77 |
| 22 | 78 DBus: |
| 79 This excellent IPC is in the heart of gcp. Get more information at www.freedesktop.org/wiki/Software/dbus | |
| 19 | 80 |
| 22 | 81 python and its amazing standard library: |
| 82 gcp was coded quickly for my own need thanks to this excellent and efficient language and its really huge standard library. Python can be download at www.python.org | |
| 19 | 83 |
| 84 If I forgot any credit, please contact me (mail below) to fix it. | |
| 85 | |
|
44
07e4c8f96a6e
README updated (contributions + thx)
Goffi <goffi@goffi.org>
parents:
40
diff
changeset
|
86 Big thanks to contributors and package mainteners |
|
07e4c8f96a6e
README updated (contributions + thx)
Goffi <goffi@goffi.org>
parents:
40
diff
changeset
|
87 |
|
07e4c8f96a6e
README updated (contributions + thx)
Goffi <goffi@goffi.org>
parents:
40
diff
changeset
|
88 ** Contributions ** |
|
50
b0c96e4ab9d8
Thomas Preud'homme email address update
Goffi <goffi@goffi.org>
parents:
44
diff
changeset
|
89 2011: Thomas Preud'homme <robotux@celest.fr>: manpage, stat resolution fix |
|
44
07e4c8f96a6e
README updated (contributions + thx)
Goffi <goffi@goffi.org>
parents:
40
diff
changeset
|
90 |
|
07e4c8f96a6e
README updated (contributions + thx)
Goffi <goffi@goffi.org>
parents:
40
diff
changeset
|
91 |
| 19 | 92 |
| 93 ** Contact ** | |
| 94 | |
| 95 You can contact me at goffi@goffi.org . | |
|
40
8cd8cd9da541
updated date in source code & README + updated links
Goffi <goffi@goffi.org>
parents:
31
diff
changeset
|
96 You'll find the latest version on my ftp: ftp://ftp.goffi.org/gcp, or check the wiki ( http://wiki.goffi.org/wiki/Gcp ) |
|
8cd8cd9da541
updated date in source code & README + updated links
Goffi <goffi@goffi.org>
parents:
31
diff
changeset
|
97 Please report any bug on http://bugs.goffi.org |
| 19 | 98 You can also have a look to my other main projects (and maybe to the smaller ones too ;) ): |
| 99 - lm (list movie): a tool to list movies using IMdB data, loosely inspired from ls | |
| 100 - SàT: my main project, a jabber/XMPP client, which is a brick to many others things I have in mind | |
| 101 | |
| 102 Don't hesitate to give feedback :) |