changeset 19:7eb698246bec

README: first draft
author Goffi <>
date Tue, 28 Sep 2010 17:15:55 +0800
parents 9d015d756c0f
children da8353f26f4b
files README
diffstat 1 files changed, 82 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Tue Sep 28 17:15:55 2010 +0800
@@ -0,0 +1,82 @@
+gcp v0.1
+(c) Jérôme Poisson aka Goffi 2010
+gcp (Goffi's cp) is a files copier.
+** LICENSE **
+gcp is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+gcp is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+GNU General Public License for more details.
+You should have received a copy of the GNU General Public License
+along with gcp.  If not, see <>.
+** WTF ? **
+gcp is a file copier, loosely inspired from cp, but with high level functionnalities like:
+- progression indicator
+- gcp continue coping even when there is an issue: he just skip the file with problem, and go on
+- journalization: gcp write what he is doing, this allow to now which files where effectively copied
+- fixing names to be compatible with the target filesystem (e.g. removing incompatible chars like "?" or "*" on vfat)
+- if you launch a copy when an other is already running, the files are added to the first queue, this avoir you hard drive to move its head all the time
+- 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).
+- gcp will be approximately option-compatible with cp (approximately because the behaviour is not exactly the same, see below)
+/!\ WARNING /!\
+gcp is at an early stage of development, and really experimental: use at your own risks !
+** How to use it ? **
+Pretty much like cp (see gcp --help). 
+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).
+gcp doesn't implement yet all the options from cp, but it's planed.
+** What's next ? **
+Several improvment are already planed:
+- copy queue management (moving copy order)
+- advanced console interface
+- notification (xmpp and maybe mail) when a long copy is finished
+- retry for files which where not correctly copied
+- badly encoded unicode filenames fix
+... and other are with a "maybe"
+- graphic interface
+- desktop (Kde, Gnome, XFCE, ...) integration
+** Credits **
+A big big thank to the authors/contributors of...
+gcp use ProgressBar (, a class coded by Nilton Volpato which allow the textual representation of progression.
+This heavily used library is used here for the main loop and event catchins, and for DBus also
+This excellent IPC is in the heart of gcp
+python and its amazing standard library:
+gcp was coded quickly for my own need thanks to this excellent and efficient language and its really huge standard library.
+If I forgot any credit, please contact me (mail below) to fix it.
+** Contact **
+You can contact me at .
+You'll find the latest version on my website: (it's mainly in french, I will probably make a little part in english in the future).
+You can also have a look to my other main projects (and maybe to the smaller ones too ;) ):
+- lm (list movie): a tool to list movies using IMdB data, loosely inspired from ls
+- SàT: my main project, a jabber/XMPP client, which is a brick to many others things I have in mind
+Don't hesitate to give feedback :)