This is the Debian Linux packaging scripts for the packages stored in the
Concurrent Version System (CVS). This package has been put together by
Manoj Srivastava <srivasta@debian.org>.


INSTALLATION NOTES:

 This package is meant to help people who have imported the sources of
 their Debian packages into CVS, and do most of the work in a checked out
 CVS tree. It does require the original sources (as required by
 dpkg-buildpackage) to exist in a ``work directory'' (well, that is where
 the program does it's work, not the human).

 For example, I have my CVS checked out tree under /usr/local/src/Work, and
 say, for make, the checked out directory tree is /usr/local/src/Work/make
 I keep the original sources in /usr/local/src/Packages/make/ (used to be
 my work directory before I moved things into CVS).

 The package is naturally set up to work for that. I set the root
 directory in /etc/cvsdeb.conf (you may also use ~/.cvsdeb.conf) to be
 /usr/local/src/Packages, and, when I am satisfied with a package, I
 commit my changes, and tag the package with debian_version_X_XX
 (which is good practice anyway). Then I just type
 __> cvs-buildpackage -rsudo,
 and the newly tagged files are exported into
 /usr/local/src/Packages/make/make-X.XX, the original sources are already
 in /usr/local/src/Packages/make/make_X.XX.orig.tar.gz, and so
 dpkg-buildpackage is run for me, and after signing things a couple of
 times, I have the finished packages in /usr/local/src/Packages/make/.

 Simple, huh?

 Oh, by giving extra information to cvs-buildpackage, you could extract any
 older version from the CVS repository (you don't have to have an checked
 out tree to use this package), which is really convenient.

CVS TAG CONVENTIONS

 |======================================================================|
 |Upstream Version    | <version>                                       |
 |Debian Revision     | <revision>                                      |
 |Orig tar file name  | package_<version>.orig.tar.gz                   |
 |Debian package name | package_<version>-<revision>_<arch>.deb         |
 |CVS Vendor tag      | upstream_version_<version  | \                  |
 |                    |           tr -c "[-_a-zA-Z0-9]" "_">            |
 |CVS current tag     | debian_version_<version-revision  | \           |
 |                    |                  tr -c "[-_a-zA-Z0-9]" "_">     |
 |======================================================================|

 Examples:
 |======================================================================|
 |                    | upstream sources       | Debian only package    |
 |======================================================================|
 |Upstream Version    | 2.76                   | 3.38                   |
 |Debian Revision     | 1.2                    |                        |
 |Orig tar file name  | make_2.76.orig.tar.gz  |                        |
 |Debian package name | make_2.76-1.2_i386.deb | kpkg_3.38_i386.deb     |
 |CVS Vendor tag      | upstream_version_2_76  | upstream_version_3_38  |
 |CVS current tag     | debian_version_2_76-1_2| debian_version_3_38    |
 |======================================================================|

 Note that the epoch numbers are ignored while determining the CVS tag
 name (they are generally used to change dpkg's opinion of package
 ordering, and are generally not relevant for CVS tags).

CUSTOMIZATION:


The value of a variable can be set so:
  a) Defaults exist in the script. These are the values used if no
     customization is done.
  b) Variables can be set in the config file /etc/cvsdeb.conf or in
     ~/.cvsdeb.conf.  These values override the defaults.
  c) Some variables can also be set by setting a corresponding environment
     variables.  These values override the config file and the defaults
  d) Using cvs-buildpackage options. This overrides all the above methods.

Please see cvsdeb.conf (5).


--
Manoj Srivastava                        <srivasta@debian.org>
PGP Key ID: 1024/C7261095
Key fingerprint =  CB D9 F4 12 68 07 E4 05  CC 2D 27 12 1D F5 E8 6E
