%PDF-
%PDF-
Mini Shell
Mini Shell
<html>
<head>
<title>AFPL Ghostscript maintenance procedures</title>
<!-- $Id: Maintain.htm,v 1.4.2.3 2000/12/02 22:15:09 raph Exp $ -->
</head>
<body>
<!-- [1.0 begin visible header] ============================================ -->
<!-- [1.1 begin headline] ================================================== -->
<table width="100%" border="0">
<tr><th align="center" bgcolor="#CCCC00"><font size=6>
AFPL Ghostscript maintenance procedures
</font>
</table>
<!-- [1.1 end headline] ==================================================== -->
<!-- [1.2 begin table of contents] ========================================= -->
<h2>Table of contents</h2>
<blockquote><ul>
<li><a href="#Introduction">Introduction</a>
<li><a href="#Problem_reporting">Problem reporting</a>
<ul>
<li><a href="#Uploading_test_data">Uploading test data</a>
</ul>
</ul></blockquote>
<!-- [1.2 end table of contents] =========================================== -->
<!-- [1.3 begin hint] ====================================================== -->
<p>For other information, see the <a href="Readme.htm">Ghostscript
overview</a> and the instructions on how to <a href="Build.htm">build
Ghostscript</a>.
<!-- [1.3 end hint] ======================================================== -->
<hr>
<!-- [1.0 end visible header] ============================================== -->
<!-- [2.0 begin contents] ================================================== -->
<h1><a name="Introduction"></a>Introduction</h1>
<p>
This document describes various maintenance procedures associated with AFPL
Ghostscript. It is only meant for developers actively working on AFPL
Ghostscript; some parts of it are only relevant to developers who are
members of the ghostscript group on SourceForge.
<hr>
<h1><a name="Problem_reporting"></a>Problem reporting</h1>
<h2><a name="#Uploading_test_data"></a>Uploading test data</h2>
<p>
SourceForge currently provides no supported method for associating test data
files with a problem report. Submitters can always include a URL in their
public report, but sometimes the test files need to remain private.
<p>
To allow uploading of private test files, we have set up a CVS tree on a
SourceForge server, accessible only to members of the ghostscript group.
The simplest way to access this tree is to place the following script in
<b><tt>/usr/local/bin</tt></b> under the name (say) <b><tt>cvs3</tt></b>:
<blockquote><pre>
#!/bin/sh
exec env CVS_RSH=ssh cvs -z3 -d<em>{username}</em>@ghostscript.sourceforge.net:/home/groups/ghostscript/cvs "$@"
</pre></blockquote>
<p>
where <em>{username}</em> is your SourceForge user name. The relevant
directories in this tree are called
<blockquote><pre>
bug-data/<em>{bug#}</em>/<em>{file}</em>
</pre></blockquote>
The file named <tt>report</tt> should contain any bug report information
(such as the name or company of the original submitter) that shouldn't be
included in the public bug posting, if needed. For example, the contents of
<tt>bug-data/102146/</tt> are
<blockquote><pre>
bp-dist.pdf bp-gs.pdf bp.ps report
</pre></blockquote>
<p>
Assuming you keep a local checked-out copy of the private CVS tree under a
directory named <b><tt>sf</tt></b>, the procedure for creating the structure
for bug # 109999 with an uploaded data file might look like this:
<blockquote><pre>
cd sf/bug-data
mkdir 109999
cvs3 add 109999
<em>If a report file is required:</em>
<em>Create report file as </em><tt>109999/report</tt>
cvs3 add 109999/report
<em>If test files are required:</em>
<em>Copy test file to </em><tt>109999/xyz</tt>
cvs3 add 109999/xyz
<em>etc.</em>
cvs3 commit
</pre></blockquote>
<!-- [2.0 end contents] ==================================================== -->
<!-- [3.0 begin visible trailer] =========================================== -->
<hr>
<font size=2>
<p>Copyright © 2000 Aladdin Enterprises. All rights reserved.
<p>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.
<p>
Ghostscript version 6.50, 2 December 2000
</font>
<!-- [3.0 end visible trailer] ============================================= -->
</body>
</html>
Zerion Mini Shell 1.0