Update TODO.
[clive-utils.git] / INSTALL
blob2464357d76edd21a1ff6e6250ad2426083831446
2             clive-utils installation
4  Normally you can do "make install". This will install the scripts
5  in your own ~/bin/ directory. If you want to do a global install,
6  you can do (as root):
8     # make prefix=/usr install
10  The manual pages are installed by default, if you do not need them:
12     # make WITH_MAN=no install
14  When you uninstall, be sure to use the same prefix. For example:
16     # make prefix=/usr uninstall
18  Developers may also find the following make target useful:
20     man # generate clive.1 from clive (req. pod2man)
23             clive-utils prerequisites
25  - Perl 5.8+
26  - Config::Tiny
27  - WWW::Curl (4.05+)
28  - Tk 
29  - Tk::Tree
30  - Tk::DialogBox
31  - HTML::TokeParser
32  - XML::RSS::LibXML
33  - URI::Escape
34  - HTML::Strip
35  - Crypt::PasswdMD5
36  - Crypt::Twofish
38  Optional (some features will be disabled without them):
39  - Clipboard        # --paste
40  - Tk::FontDialog   # GUI: Edit / Preferences (change font)
42  Note that you can install these modules from CPAN, typically (as root):
44    # cpan install $modulename
46  Many distros have made the above modules available as packages.
49             Getting started with clive utilities
51  Typical use:
53     % clivefeed "http://youtube.com/rss/user/communitychannel/videos.rss"
54     % clivescan "http://youtube.com"
56  Be sure to read the manual pages. See also examples/config file.