view release on metacpan or  search on metacpan

doc/chart.texi  view on Meta::CPAN

@item Tooltip
Moving the mouse over an entry (and keeping it still) opens a tooltip box
showing the stock name (if available), full date/times for the quote and last
trade, and the exchange timezone location.
@end table


@c ---------------------------------------------------------------------------
@node Intraday, Download, Watchlist, Top
@chapter Intraday
@cindex Intraday

@cindex @key{Ctrl-I}
The View/Intraday menu entry (@key{Ctrl-I}) or the Intraday button in the
watchlist (@pxref{Watchlist}) opens an intraday image window for the current
symbol, showing trading today, or so-far today.

Alas there are no longer any data sources with intraday images.

@c are only
@c available from a few data sources (@pxref{Data Sources}).

@c @cindex @key{Alt-R}
@c The default display is 1-day, downloaded when the window is opened (then
@c cached).  The option menu can select other timeframes such as 5-day, depending
@c on the data source.  The underlined mnemonics ``5'' etc in the menu are
@c accelerator keys, eg.@: @key{Alt-5}.  Click on Refresh (@key{Alt-R}) to update
@c as trading progresses through the day.
@c 
@c Multiple intraday windows can be opened, or a new symbol entered in the text
@c box to view a different symbol (press @key{Return} or click the ``Enter''
@c button).
@c 
@c To see the intraday for a symbol not in the database or watchlist just open an
@c intraday window for any symbol (or no symbol at all) then enter the desired
@c one.


@c ---------------------------------------------------------------------------
@node Download, Data Sources, Intraday, Top
@chapter Download
@cindex Download
@cindex Dialog, download

@cindex Tools/Download
The Tools/Download menu entry opens the download dialog.  Choose ``What'' to
download, either all symbols, the favourites list, or a particular symbol.
@c Then choose ``When'' for the period to download, either an update of new
@c available data, or back to a given year (where possible).

The default is an update of all symbols.  This is usually what's wanted, to
get all latest data.

Click on the ``Start'' button to begin.  The top box is the subprocesses
running, the middle box is the jobs running or queued, and errors are shown in
the lower text window.  If you're offline the errors will usually be ``host
name lookup failure'' or ``network unreachable''.  To abort select the job in
the middle box and click on ``Stop''.

The main chart display can be used while downloading, for instance to look
immediately at the first few symbols updated while the rest are still going.
Sometimes a database update can make the GUI block for a moment.

@section Update Current Chart
@cindex Update data

@cindex @key{Ctrl-U}
In the main Chart window, @key{Ctrl-U} starts an update download for the
currently viewed chart.  This is a good shortcut to grab new data for just one
symbol.  Download progress is shown in the main window statusbar (as well as
the download dialog).

@section Download Automation
@cindex @command{cron}
@cindex Automation, download

You can run @samp{chart --download} to do a command-line (non-GUI) download
(@pxref{Invocation}), for instance in a script perhaps when first going
online, or at selected times.  Progress messages are shown if the output is a
terminal.

Care should be taken not to hammer the various data sources when automating
downloads.  Keep update attempts to times when there should be new data, and
don't retry endlessly.

Chart tries to know when to expect new data, and will do nothing in an update
until then, but this is often imperfect.  Public holidays (with no data) are
not tracked, and it's easy for a data source to be delayed unexpectedly.


@c ---------------------------------------------------------------------------
@node Data Sources, Internationalization, Download, Top
@chapter Data Sources
@cindex Data sources
@cindex Sources, data

Note that data from each of these sources is subject to various disclaimers
and conditions for its use.  A summary of the restrictions is noted in each
section and links to the relevant parts of the web sites which should be
consulted for full information.

The minimum terms for a source in Chart are that personal non-commercial use
is permitted.  In fact that's usually all that's permitted, and in particular
further copying or distribution is generally not allowed (and this will
include derived forms like the graphs drawn by Chart).

@menu
* Finance Quote::
* MLC Funds::
* New Zealand Stock Exchange::
* Reserve Bank of Australia::
* Thrift Savings Plan::
* Yahoo Finance::
@end menu


@c ---------------------------------------------------------------------------
@c @node Athens Stock Exchange, Australian Stock Exchange, Data Sources, Data Sources
@c @section Athens Stock Exchange
@c @cindex Athens Stock Exchange
@c @cindex ATHEX