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
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
|
<html>
<head>
<!-- This file has been generated by unroff 1.0, 03/01/02 11:35:49. -->
<!-- Do not edit! -->
<STYLE TYPE="text/css">
<!--
A:link{text-decoration:none}
A:visited{text-decoration:none}
A:active{text-decoration:none}
-->
</STYLE>
<title>ploticus: correspondence, troubleshooting, and bug reports</title>
<body bgcolor=D0D0EE vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td>
<table cellpadding=2 width=550><tr>
<td><br><h2>Correspondence, troubleshooting, and bug reports</h2></td>
<td align=right>
<small>
<a href="../doc/Welcome.html"><img src="../doc/ploticus.gif" border=0></a><br>
<a href="../doc/Welcome.html">Welcome</a>
<a href="../gallery/index.html">Gallery</a>
<a href="../doc/Contents.html">Handbook</a>
<td></tr></table>
</td></tr>
<td>
<br>
<br>
<title>Manual page for Correspondence,_troubleshooting,_and_bug_reports(PL)</title>
</head>
<body>
<h2>CORRESPONDENCE</h2>
<a href="http://ploticus.sourceforge.net/sgpr.html">Steve Grubb</a> is the author of ploticus.
<p>
You can reach me by email at
<tt>
<a href="mailto:scg@jax.org">scg@jax.org</a>
</tt>, or by posting to the
<a href="http://groups.yahoo.com/group/ploticus">ploticus news group</a>
(you don't have to join the newsgroup to post or browse).<tt> </tt>
I reserve the right to use your message in the
<a href="Feedback.html">
user feedback page
</a>
or
<a href="Faq.html">
FAQ
</a>
.<tt> </tt>
If you have interesting examples or web sites that use ploticus, please send the
URLs or script files.<tt> </tt>
<br><br><br>
<h2>TROUBLESHOOTING</h2>
Here are some troubleshooting tips and common snafus:
<ul>
<li>
Unix users should download gzip tar files.<tt> </tt>
Zip files are intended only for PC environments (text files have CR/LF line terminators).<tt> </tt>
<br>
<br>
<li>
Before compiling, review the <b>Makefile</b> and follow the simple 3-step
installation guide.<tt> </tt>
<br>
<br>
<li>
An ANSI-compliant C compiler such as <b>gcc</b> is required to compile the source code.<tt> </tt>
<br>
<br>
<li>
After building, do a quick test. From within the <tt>src</tt> directory type <tt>pl stock.htm</tt>.<tt> </tt>
For further testing see <tt> pltestsuite </tt>, or run some gallery examples.<tt> </tt>
<br>
<br>
<li>
If you get this error: <tt>pl error 4899: No PLOTICUS_PREFABS env var (or hardcoded Makefile
PREFABS_DIR) found</tt>, it indicates that no default prefabs directory was specified
at build time and that each user must have the
<b>PLOTICUS_PREFABS</b> environment variable set and exported.<tt> </tt>
It must contain the full pathname of the directory where
ploticus prefabs reside, as included in the download.
<br>
<br>
<li>
Be sure you know which version you are executing
(you might have earlier ploticus versions on your system and not realize it).<tt> </tt>
Use <tt>pl -version</tt> to print the ploticus
version; use the unix command <tt>which pl</tt> to print the file that you
are actually executing when you type <tt>pl</tt>.<tt> </tt>
<br>
<br>
<li>
Unix builds do not read native PC text files. This problem occurs
if pl is compiled on a unix machine and you feed it native PC text files,
either as scripts or data files.
Symptoms may include truncated multi-line text
items, or garbage characters appearing at the end of text items.
<br>
<br>
<li>
If an image result contains blank areas at the top or side, it is probably because
the image is larger than 8" x 8" in one or both dimensions. To generate images larger than
8" x 8" a sufficient <b>pagesize</b> must be specified, either on the command line or via
proc page.
<br>
<br>
<li>
If viewing result images in a browser, remember that image caching is usually
being done, and that you might not be seeing the most recently generated image,
even when you Reload or Refresh.<tt> </tt>
<br><br><br>
</ul>
<h2>BUG REPORTS</h2>
Much of the incremental improvement in this package has been due to
the careful bug reports that have been sent in by attentive users. Thanks!<tt> </tt>
Bug reports should be sent to <tt>
<a href="mailto:scg@jax.org">
scg@jax.org
</a>
</tt> or may be posted to the
<a href="http://yahoogroups.com/group/ploticus">
ploticus news group.<tt> </tt>
</a>
<p>
When reporting a problem, please supply the following info:
<dl>
<dt><dd><p>
<b>1.</b> the OS environment where you invoked pl (eg. linux, solaris, windows/NT, etc.)
<dt><dd><p>
<b>2.</b> <tt> pl </tt> version number (type <tt> pl -version </tt> to find out).<tt> </tt>
<dt><dd><p>
<b>3.</b> exactly how you invoke <tt>pl</tt>. Using a prefab? CGI mode? By typing in a pl command?<tt> </tt>
Via perl or PHP? With or without a config file? Provide the exact pl command used.<tt> </tt>
Since there are now a number of possibilities,
this is especially important.
<dt><dd><p>
<b>4.</b> a self-contained example that demonstrates the problem. Usually the first thing
I do is attempt to reproduce the problem here.<tt> </tt>
<br>
<br>
</td></tr>
<td align=right>
<a href="../doc/Welcome.html">
<img src="../doc/ploticus.gif" border=0></a><br><small>data display engine <br>
<a href="../doc/Copyright.html">Copyright Steve Grubb</a>
<br>
<br>
<center>
<img src="../gallery/all.gif">
</center>
</td></tr>
</table>
</dl>
<p><hr>
Markup created by <em>unroff</em> 1.0, <tt> </tt> <tt> </tt>March 01, 2002.
</body>
</html>
|
