AFPL Ghostscript maintenance procedures

## Table of contents

> - Introduction
> - Problem reporting
>   - Uploading test data

For other information, see the Ghostscript overview and the instructions on how to build Ghostscript.

# Introduction

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.

# Problem reporting

## Uploading test data

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.

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 `/usr/local/bin` under the name (say) `cvs3`:

>     #!/bin/sh
>     exec env CVS_RSH=ssh cvs -z3 -d{username}@ghostscript.sourceforge.net:/home/groups/ghostscript/cvs "$@"

where {username} is your SourceForge user name. The relevant directories in this tree are called

>     bug-data/{bug#}/{file}

The file named `report` 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 `bug-data/102146/` are

>     bp-dist.pdf  bp-gs.pdf    bp.ps	    report

Assuming you keep a local checked-out copy of the private CVS tree under a directory named `sf`, the procedure for creating the structure for bug # 109999 with an uploaded data file might look like this:

>     cd sf/bug-data
>     mkdir 109999
>     cvs3 add 109999
>     If a report file is required:
>     	Create report file as 109999/report
>     	cvs3 add 109999/report
>     If test files are required:
>     	Copy test file to 109999/xyz
>     	cvs3 add 109999/xyz
>     	etc.
>     cvs3 commit

Copyright © 2000 Aladdin Enterprises. All rights reserved.

This file is part of AFPL Ghostscript. See the Aladdin Free Public License (the "License") for full details of the terms of using, copying, modifying, and redistributing AFPL Ghostscript.

Ghostscript version 6.50, 2 December 2000