annotate README @ 105:20be00928875

Lower default setuptools version From 0d607b6ed49eab758fd9b272e148f032e65fb2e2 Mon Sep 17 00:00:00 2001 python-setuptools 5.7 is not yet in Debian, so we need to set the default version to 5.5 (the current version in sid) to avoid the newer version to be downloaded from pypi.
author Matteo Cypriani <mcy@lm7.fr>
date Tue, 09 Sep 2014 22:09:51 -0400
parents abc0ae944030
children 5bb3b7e25bf6
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
104
abc0ae944030 new minor release to fix installation on pypi
Goffi <goffi@goffi.org>
parents: 102
diff changeset
1 urwid-satext v0.4.1
72
e497bf7e3060 version update
Goffi <goffi@goffi.org>
parents: 71
diff changeset
2 (c) Jérôme Poisson aka Goffi 2008, 2009, 2010, 2011, 2012, 2013, 2014
100
4629924c136f Changelog + version update
Goffi <goffi@goffi.org>
parents: 72
diff changeset
3 (c) Adrien Cossa 2014
30
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
4
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
5 urwid-satext, or urwid SàT extensions, is a widgets library based on Urwid
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
6
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
7
72
e497bf7e3060 version update
Goffi <goffi@goffi.org>
parents: 71
diff changeset
8 ** LICENCE **
30
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
9
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
10 urwid-satext is free software: you can redistribute it and/or modify
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
11 it under the terms of the GNU Lesser General Public License as published by
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
12 the Free Software Foundation, either version 3 of the License, or
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
13 (at your option) any later version.
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
14
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
15 urwid-satext is distributed in the hope that it will be useful,
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
18 GNU Lesser General Public License for more details.
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
19
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
20 You should have received a copy of the GNU Lesser General Public License
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
21 along with urwid-satext. If not, see <http://www.gnu.org/licenses/>.
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
22
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
23
72
e497bf7e3060 version update
Goffi <goffi@goffi.org>
parents: 71
diff changeset
24 ** About **
30
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
25 urwid-satext is a widgets based on top of the excellent Urwid (http://excess.org/urwid/) console user interface library.
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
26 It was originally made for the "Salut à Toi" project, an XMPP/Jabber multi-frontend client, but was eventually separated to be used by other urwid projects.
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
27
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
28
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
29 ** Installation **
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
30
102
ba19778eabf2 set the minimal version of urwid to 1.2.0
souliane <souliane@mailoo.org>
parents: 100
diff changeset
31 Install the dependency: urwid >= 1.2.0
ba19778eabf2 set the minimal version of urwid to 1.2.0
souliane <souliane@mailoo.org>
parents: 100
diff changeset
32
ba19778eabf2 set the minimal version of urwid to 1.2.0
souliane <souliane@mailoo.org>
parents: 100
diff changeset
33 Just type as root:
30
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
34 $ python setup.py install
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
35
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
36 ** What are the widgets provided ? **
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
37
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
38
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
39 ** How to use it ? **
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
40
34
875ff127b2dd - i18n management: gettext integration + french translation
Goffi <goffi@goffi.org>
parents: 30
diff changeset
41 You can see the documentation at http://wiki.goffi.org/wiki/urwid-satext .
875ff127b2dd - i18n management: gettext integration + french translation
Goffi <goffi@goffi.org>
parents: 30
diff changeset
42 Also check examples directory.
30
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
43
72
e497bf7e3060 version update
Goffi <goffi@goffi.org>
parents: 71
diff changeset
44
30
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
45 ** Credit **
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
46
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
47 A big big thank to the authors/contributors of Urwid (http://excess.org/urwid/), of course.
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
48 Nothing would be possible without Python (http://www.python.org/), Gnu and the Free Software Foundation (http://www.gnu.org, http://www.fsf.org/), the Linux Kernel (http://www.kernel.org/), and the coder of the tools I use like Vim (http://www.vim.org/), Mercurial (http://www.selenic.com/mercurial/wiki/), or all the KDE stuff (http://www.kde.org/ and of course http://amarok.kde.org/), and also XFCE (http://www.xfce.org), etc. Thanks thanks thanks, thank to everybody in the Free (Libre) chain for making a part of the dream.
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
49
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
50 If I forgot any credit (and I probably have), please contact me (mail below) to fix it.
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
51
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
52
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
53 ** Contact **
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
54
72
e497bf7e3060 version update
Goffi <goffi@goffi.org>
parents: 71
diff changeset
55 You can contact me on goffi@goffi.org (e-mail) or goffi@jabber.fr (xmpp)
30
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
56 my blog (in french) is at http://www.goffi.org
72
e497bf7e3060 version update
Goffi <goffi@goffi.org>
parents: 71
diff changeset
57 SàT official site: http://www.salut-a-toi.org
30
1aeb3540aa49 files reorganisation after project separation. new README, and COPYING files
Goffi <goffi@goffi.org>
parents:
diff changeset
58 urwid-satext wiki page is at http://wiki.goffi.org/wiki/urwid-satext , you will find there link to the latests release, the repository, etc.