|
|
|
|
CSSC Documentation
CSSC Reference Manual
The CSSC manual is the principal source of information on how to use
GNU CSSC. This manual is provided with the source distribution and is
in Texinfo format. This can easily be transformed into Postscript or
HTML, as well as the GNU Info format.
The
HTML version of the CSSC manual
is available online and is updated
daily.
CSSC Manual Pages
No manual pages are provided with CSSC; all reference material is
included in the CSSC Reference Manual. The
reason for this is that it is the policy of the GNU Project that GNU programs should
use Texinfo as their principal form of documentation (see the GNU Coding
Standards for more information).
However,
The Open Group's Single
Unix Standard contains reference information which is very much
like manual pages. However, please remember that the functionality
described in the Single Unix Standard does not always correspond
precisely with the functionality of CSSC (and most of the differences
are in fact desctibed in the manual).
The standard does not include entries for cdc, prt and sccsdiff.
Test suite
The CSSC Test Suite is documented in the CSSC
Reference manual, but we also have a summary of the coverage of the test
suite which is occasionally updated by hand.
Documentation from the Source Distribution
The documentation listed below is included in the CSSC source
distribution, and in fact the links below simply link into the CVS
repository for the CSSC code.
|
BUGS
|
The BUGS file lists some bugs in CSSC which are known to exist. This
file is obsolescent; remaining bugs should be reported via the
CSSC Bug Tracker.
|
|
CREDITS
|
The CREDITS file lists the people who have contributed to the
development of GNU CSSC.
|
|
CREDITS.short.txt
|
The CREDITS.short.txt file briefly lists the people who have contributed to the
development of GNU CSSC.
|
|
Platforms
|
The Platforms file lists the systems on which CSSC is known to work,
and provides any system-specific information about how CSSC should be
compiled or installed on various platforms.
|
|
TESTING
|
The TESTING file provides instructions on how to use the CSSC Test
Suite to ensure that CSSC runs correctly on your system, or that any
changes you have made to CSSC have not broken something else. See
the CSSC manual for more detailed
instructions on how to use the test suite.
|
|
TODO
|
The TODO file is obsolete and has been replaced by the
automated bug tracking system.
|
|
tests-todo.txt
|
This is a list of descriptions of tests that we need to create in
order to increase the code coverage of the existing test suite.
|
|
borrowed-files.txt
|
The borrowed-files.txt file lists those files which are included in
the CSSC source distribution, but which originally came from some
other package.
|
|
missing.txt
|
The missing.txt file lists some features which are missing from GNU
CSSC but which are present in the Unix SCCS suite.
|
|
patches.txt
|
The patches.txt file explains how you should submit code patches for
GNU CSSC.
|
|
style.txt
|
The style.txt file explains the coding stye adopted for GNU CSSC.
|
Other Documentation
Almost all the CSSC documentation is provided either in the
manual itself or elsewhere in the
source distribution. However, what other documentation there is is
listed below.
|
ManLUG Presentation
|
A talk I gave at
ManLUG
is available online, in the form of its
Magicpoint source. If you don't have
Magicpoint, the source is only a
text file and is reasonably human-readable. You can find that
here.
|
| Included and Excluded Deltas |
This document details how CSSC handles included and excluded
deltas, including some bugs that remain in CSSC. |
|