HOME

5h-3LL 1.0
DIR: /usr/share/doc/analog/docs
/usr/share/doc/analog/docs/
Current File : /usr/share/doc/analog/docs/startmac.html
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head>
<link rel=stylesheet type="text/css" href="anlgdocs.css">
<LINK REL="SHORTCUT ICON" HREF="favicon.ico">
<title>Readme for analog -- starting to use analog (Mac)</title>
</head>

<body>
[ <a href="Readme.html">Top</a> | <a href="start.html">Up</a> |
<a href="start.html">Prev</a> | <a href="custom.html">Next</a> |
<a href="map.html">Map</a> | <a href="indx.html">Index</a> ]
<h1><img src="analogo.gif" alt=""> Analog 6.0:
Starting to use analog on a Mac</h1>
<hr size=2 noshade>


Here is the really short summary:
<ol>
  <li>Edit <kbd>analog.cfg</kbd>
  <li>Run analog
  <li>Read <kbd>Report.html</kbd>
</ol>

<hr size=1 noshade>
When you download the Mac version of analog, it should unpack itself. (If it
doesn't, you might have to run StuffIt Expander on it). You should then find
in the analog directory a configuration file called <kbd>analog.cfg</kbd>
and the analog application itself, as well as the Readme, the
<a href="Licence.txt">Licence</a> and a couple of other files.
When you double-click on the analog
icon, it will run in its own window, and produce an output file called
<kbd>Report.html</kbd>. (For help in interpreting the output, see
<cite><a href="meaning.html">What the results mean</a></cite>.)
The window will then close if there weren't any warning messages, or stay open
for you to read them if there were.

<hr size=1 noshade>
You can configure analog by putting commands in the configuration file,
<kbd>analog.cfg</kbd>. Although this is less familiar to Mac users than
pressing buttons etc., it's really much simpler and more flexible when you get
used to it. One command you will need straight away is
<pre>
LOGFILE logfilename    # to set where your logfile lives
</pre>
The logfile must be stored locally -- analog won't use FTP or HTTP to fetch
it from the internet. There's a sample logfile supplied with the program.

<p>
There are already some configuration commands to get you started in the
configuration file, but there are lots of others available. You can find the
most common ones in the section on <a href="basiccmd.html">basic commands</a>
later in the Readme, and you can read about all of them in
the section on <a href="custom.html">customising analog</a>.
There are also some sample configuration files in the examples folder.

<hr size=1 noshade>
Another way to start analog is to drag a logfile onto the analog icon, in which
case analog will try to analyse it, or drag a configuration file onto the
icon, in which case analog will use the commands in that configuration file.
(Analog detects whether it's a configuration file or a logfile by whether
it starts with "<kbd># </kbd>" or not.) This enables you to create different
reports without having two copies of the application.

<p>
There is another way to give options, via
command line arguments. You'll see these mentioned in this Readme from time
to time, but MacOS before MacOS X doesn't have a command line, so ignore these
unless you've downloaded the Darwin version of analog.

<p>
If you want to compile your own version of analog (it's written in C), or
just to read the source code, it's available from the
<a href="http://www.analog.cx/">analog home page</a>.
(It's the same source code for all versions).

<hr size=2 noshade>
Go to the <a href="http://www.analog.cx/">analog home page</a>.
<p>
<address>Stephen Turner
<br>19 December 2004</address>
<p><em>Need help with analog? <a href="mailing.html">Use the analog-help
mailing list</a>.</em>
<p>
[ <a href="Readme.html">Top</a> | <a href="start.html">Up</a> |
<a href="start.html">Prev</a> | <a href="custom.html">Next</a> |
<a href="map.html">Map</a> | <a href="indx.html">Index</a> ]
</body> </html>