1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
.\" -*- mode: nroff; -*-
.\" This is the template for the manual page of ctioga2
.\"
.\" Copyright 2009 by Vincent Fourmond
.\"
.\" This program 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 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details (in the COPYING file).
.\"
.\" write-header
.\" We want to use the .URL command
.\" .mso www.tmac
.\" Do we ??
.SH NAME
ctioga2 \- a command-line front-end for the Tioga plotting library
.SH SYNOPSIS
.B ctioga2
.I arguments
\&.\|.\|.
.SH DESCRIPTION
.B ctioga2
is a command-line front-end to the wonderful Tioga plotting
library. It aims at plotting quickly both data files and mathematical
functions, with however the possibility of a high control over the
details.
The main feature that was introduced compared to the old
.B ctioga
is that it is now possible to use command files for
.BR ctioga2 :
every single command-line option corresponds to a command, whose name
is written. Just give the command the same arguments as to the
command-line option. To read a command file, feed it to the
.B -f
command-line option.
.SH EXAMPLES
Here are a few examples, both from command-line and using the
corresponding files.
.TP 8
.BI ctioga2 \ File.dat
Produces a file \fIPlot.pdf\fR showing the second column of File.dat
as a function of the first.
.P
The corresponding command file would be:
#!/usr/bin/env ctioga2 -f
plot(File.dat)
.SH OPTIONS
.\" write-commands
.SH TYPES
Most of the commands accept one or more arguments, which have
different types. Here are the meanings of those types.
.\" write-types
.SH ENVIRONMENT VARIABLES
If the environment variables
.B CTIOGA2_PRE
or
.B CTIOGA2_POST
are set, they are split into words according to shell rules (see the
Shellwords.shellwords ruby function for more information) and
prepended or appended to the command-line arguments. They don't leave
any trace in the actual command-line (so, for instance,
.B --echo
won't be aware of them).
.SH AUTHOR
.B ctioga2
was written by Vincent Fourmond.
.B Tioga
was written by Bill Paxton.
.SH BUGS
.B ctioga2
is most certainly not bug-free. You can use the facility at
.B rubyforge.org
to report any bug you notice:
.IR http://rubyforge.org/tracker/?group_id=8218 .
You can also use the same facility for feature requests and to provide
use with patches.
Alternatively, you can use the forums at
.I http://rubyforge.org/forum/?group_id=8218
or the
.I ctioga2-users@rubyforge.org
mailing list to report any kind of problems or suggestions.
.SH "SEE ALSO"
.BR xpdf (1),
.BR pdflatex (1),
.BR open (1),
.BR gnuplot (1),
.BR ctioga "(1) (the original ctioga)"
The original tarball includes an
.I examples/
with various examples demonstrating different features of
.B ctioga2\fR,
and in particular the different ways to use it: command-line or
command-file.
It also includes a
.I tests/
directory containing test shell scripts. Runnning these shell scripts
should give you a decent idea of
.BR ctioga2 's
possibilities while assuring that it did install properly.
Useful information, documentation and most up-to-date news can be
found at
.BR ctioga2 's
website, at
.IR http://ctioga2.rubyforge.org/ .
More information about
.B Tioga
and its rdoc documentation can be found at
.IR http://www.kitp.ucsb.edu/~paxton/tioga.html .
|