summaryrefslogtreecommitdiff
path: root/gs/doc/Bug-info.htm
blob: b472902df8bce632791b71cc2813f9e498f7adaa (plain)
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
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Reporting Ghostscript problems</title>
<!-- $Id$ -->
<link rel="stylesheet" type="text/css" href="gs.css" title="Ghostscript Style">
</head>

<body>
<!-- [1.0 begin visible header] ============================================ -->

<!-- [1.1 begin headline] ================================================== -->

<h1>Reporting Ghostscript problems</h1>

<!-- [1.1 end headline] ==================================================== -->

<!-- [1.0 end visible header] ============================================== -->

<!-- [2.0 begin contents] ================================================== -->

<!-- [2.0 end contents] ==================================================== -->

<!-- [3.0 begin visible trailer] =========================================== -->
<hr>

<p>
The Ghostscript development team wants Ghostscript to be of high quality,
but we have limited resources for responding to problems, so please read
this document carefully.  Read each section in order, and follow the
instructions in the first one that applies to your situation.  We appreciate
problem reports, since they help us improve the quality of Ghostscript, but
please help us by following the procedure below.

<p>
While we do try to respond to all reports, we give priority to the following
classes of users:

<ol>
<li>Beta testers who have actually given us at least one report on some beta
version supplied to them.

<li>People developing drivers for Ghostscript or applications based on it,
and that will be made freely available.

<li>People who express serious interest in <a
href="New-user.htm#Commercial_use">licensing Ghostscript commercially</a>.

<li>Other people who have signed up as testers of developer releases.

</ol>

<p>
We currently have access to systems running Linux, Solaris, Microsoft
Windows (various versions), and MacOS; gcc, Borland C++ Builder, Watcom C++,
Microsoft Visual C++, and Metrowerks CodeWarrior.  If your problem turns
out to be specific to some other hardware or software configuration, it may
take longer to track down, since we will have to rely on other users to
help.

<h2>Check that you have a good copy of the most recent version.</h2>

<p>
Go to

<blockquote>
<a href="http://sourceforge.net/project/showfiles.php?group_id=1897"
class="offsite">
http://sourceforge.net/project/showfiles.php?group_id=1897</a>
</blockquote>

<p>
and see if the version number of your Ghostscript installation is the
highest number listed there in the applicable File Module.  The
<b><tt>ghostscript</tt></b> module lists stable releases; the
<b><tt>gs-beta</tt></b> module lists beta versions.  You can
find the version number of your installation by executing

<blockquote><pre>
gs --version
</pre></blockquote>

<p>
(or <b><tt>gswin32c</tt></b>, or whatever your Ghostscript executable is
named).

<p>
If you aren't running the most recent version, please get the most recent
version and install it, per the instructions in <a
href="Install.htm">Install.htm</a>.  Check whether the problem is still
there.  If it is, go on to the next step.

<p>
Even if you are running the most recent version, it is possible that you may
be running a modified copy.  We are confident that copies on the SourceForge
site just mentioned, our other master distribution site on
<a href="ftp://mirror.cs.wisc.edu/pub/mirrors/ghost/"
class="offsite">mirror.cs.wisc.edu</a>, and CD-ROMs of commercial
Linux
distributions are good; if you got Ghostscript somewhere else, please update
it from one of these places, and check whether the problem is still there
before proceeding.

<h2>Check whether your problem is already known.</h2>

<p>
Go to 

<blockquote>
<a href="http://sourceforge.net/bugs/?group_id=1897" class="offsite">
http://sourceforge.net/bugs/?group_id=1897</a>
</blockquote>

<p>
and see whether your problem is already known.  If it is, you may want to
add a follow-up comment to the report.  If it isn't, go on to the next step.

<h2>Have you ever run Ghostscript successfully?</h2>

<p>
If your problem is connected with installing or configuring Ghostscript, and
you haven't yet been able to run it successfully, we're sorry, but we can't
provide help.  You might want to re-read the <a
href="Install.htm">instructions</a> for installing Ghostscript, mentioned
above.  If that doesn't help, all we can suggest is that you post your
problem to the Usenet newsgroup <a
href="news:comp.lang.postscript">comp.lang.postscript</a>.  If, after you
find the solution, you have suggestions for improving the documentation,
please let us know.

<h2>Reproduce the problem with Ghostscript alone.</h2>

<p>
If you are running Ghostscript through some other piece of software, such as
a GUI-based viewer, you will have to reproduce the problem with Ghostscript
alone before we can look at it.

<ul>

<li>If you are running Ghostscript through Ghostview (for Unix and Linux),
try to run the same file through Ghostscript (<b><tt>gs</tt></b>) without
using Ghostview.  If you don't know how to do this, or the problem doesn't
show up, please contact <a
href="mailto:ghostview@cs.wisc.edu">ghostview@cs.wisc.edu</a>.

<li>If you are running Ghostscript through GSview (for MS Windows and OS/2),
try to run the same file through Ghostscript (<b><tt>gswin32</tt></b> or
<b><tt>gswin32c</tt></b>) without using GSview.  To find out more details
about how GSview is calling Ghostscript, start GSview with debugging enabled
(e.g. <b><tt>gsview&nbsp;/d</tt></b>): these details can be seen using "File
| Show Messages" and can be copied to the clipboard for pasting into a text
document.  If you have trouble doing this, or if you can't reproduce the
original problem with Ghostscript alone, please contact <a
href="mailto:gsview@ghostgum.com.au">gsview@ghostgum.com.au</a>.

<li>If you are running Ghostscript through any other software (e.g.,
<b><tt>dvips</tt></b>, a printer spooler, etc.), we are sorry, but we cannot
help you unless you can tell us how to produce the problem using Ghostscript
alone.

</ul>

<h2>Check whether you are using a third-party printer driver.</h2>

<p>
The file <b><tt>src/devs.mak</tt></b> lists all the drivers about which we
can answer questions; the file <b><tt>src/contrib.mak</tt></b> lists all the
other drivers.  If you are using a driver listed in the latter file, please
try to reproduce the problem using a driver listed in the former.  If you
can't, please contact the author of the problem driver.

<h2>Send us a problem report.</h2>

<p>
Please go to the problem reporting form in <a
href="Bug-form.htm">Bug-form.htm</a> and follow its instructions.

<!-- [3.0 begin visible trailer]
============================================= -->
<hr>

<p>
<small>Copyright &copy; 2000 Aladdin Enterprises.  All
rights reserved.</small>

<p>
<small>This file is part of AFPL Ghostscript.  See the
<a href="Public.htm">Aladdin Free Public License</a> (the "License") for
full details of the terms of using, copying, modifying, and 
redistributing AFPL Ghostscript.</small>

<p>
<small>Ghostscript version 7.02, 22 September 2001


<!-- [3.0 end visible trailer] ============================================= -->

</body>
</html>