3 Installing

The following programs and libraries are required, see their respective documentation for installation instructions.

• Perl 5.10 or higher
  http://www.perl.org
• Gtk 2 libraries, version 2.12 or higher.
  http://www.gtk.org
• Gtk2-Perl, version 1.200 or higher.
  http://gtk2-perl.sourceforge.net
• The large number of Perl modules listed in Makefile.PL, all of which are available from CPAN,
  http://www.cpan.org

Chart uses an ExtUtils::MakeMaker build system. A basic build and install can be made as follows. This will install under ‘/usr/local’.

     perl Makefile.PL
     make
     make install

The usual ExtUtils::MakeMaker options and build targets are available. Here are some other notes,

Optional Software

Various optional features and their required Perl modules are set out in the optional_features section of META.yml. Some of the smart Perl install tools might offer them in an automated way, otherwise look at META.yml and install desired things manually. The most interesting options include Finance::Quote (see Finance Quote), Genius Trader and TA-Lib (see Other Indicator Packages).

HTTP Compression

If Compress::Zlib is installed when Chart runs then LWP is setup to request compression in HTTP downloads. Currently only a few servers actually make use of this, but it's a good speedup when the server does.

HTTPS

For https protocol the LWP::Protocol::https module is required. In libwww 6 and up it comes separately and expresses its required supporting modules, in libwww 5 see the README.SSL on the recommended Crypt::SSLeay module (using OpenSSL). Data sources needing https include MLC Funds.

Documentation

The source for the manual you're now reading is doc/chart.texi, in Texinfo format (see Texinfo).

HTML format chart.html is installed as lib/App/Chart/doc/chart.html with the source code. It can be viewed with the Help commands within Chart, or with any browser. The following make targets can build other formats,

          make info      Info
          make dvi       TeX DVI
          make ps        PostScript
          make pdf       PDF

producing files doc/chart.info, doc/chart.dvi, etc. They need enough of Chart's Perl dependencies installed to run the doc/weights.pl script, then Info requires makeinfo (see Creating an Info File) and DVI, PS and PDF require various TeX and Texinfo tools. PDF also requires either epstopdf from Texlive or TeTeX, or ps2pdf from Ghostscript. makeinfo can produce other formats, including DocBook and XML (see Options for makeinfo).

Scrollkeeper

A Scrollkeeper entry (http://scrollkeeper.sourceforge.net) doc/chart.omf is included for the manual (HTML form). It can be used by Gnome help (Yelp) and similar programs. Currently it's not automatically installed but you can copy it to /usr/share/omf/chart/chart.omf and run scrollkeeper-update.

Copyright 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Kevin Ryde

Chart 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, or (at your option) any later version.