CVS-AUTORELEASEDEB.CONF(5)				User Contributed Perl Documentation				CVS-AUTORELEASEDEB.CONF(5)

NAME

       cvs-autoreleasedeb.conf - Configuration for cvs-autoreleasedeb

SYNOPSIS

	 /etc/cvs-autoreleasedeb.conf
	 $HOME/.cvs-autoreleasedeb/conf

DESCRIPTION

       The cvs-autoreleasedeb configuration file is writed in XML, because XML is easy to work with multiple-level data, but it's already in the
       TODO list to use a better format.

       As a good XML file, this config file has the following header.

	 <?xml version="1.0" encoding="ISO-8859-1"?>
	 <!DOCTYPE cvs-autoreleasedeb [
	 <!ELEMENT sources (server)+>
	 <!ELEMENT server (package)+>
	 <!ATTLIST server
	  name CDATA #REQUIRED
	  options CDATA #REQUIRED>
	 <!ELEMENT package (option)+>
	 <!ATTLIST package
	  name CDATA #REQUIRED
	  cvsroot CDATA #REQUIRED
	  prefix CDATA #REQUIRED
	  tag CDATA #REQUIRED>
	 <!ELEMENT option EMPTY>
	 <!ATTLIST option
	  name CDATA #REQUIRED
	  value CDATA #REQUIRED>
	 ]>

       Which, in fact, tells the structure of the XML file. But in the case you don't know XML, this header tells that, in the sources, you have
       servers, which have packages, which have options. A server has the "name" and the "option" properies, a package has "name", "cvsroot",
       "prefix" and "tag" properties and an option has "name" and "value" property.

       Before explaining how the options affects the script, you must know that in the current version, all the tags and properties MUST be lower-
       case (it's already on the TODO list).

CONFIGURATION SECTIONS

       server

       This is the master section, tells what server to dupload. Actually, the "name" property of the server is used as the "--to" parameter to
       dupload. Packages are declared inside servers. Also, the "options" property tells aditional parameters to cvs-buildpackage for every pack-
       age in this server.

       package

       The package itself, the "name" property is used as the module name for cvs checkout. The "cvsroot" property is passed to cvs as the CVSROOT
       and the "prefix" is placed before the module name, used if your package is inside some other directory than the cvs root.  Optionally, you
       can inform a tag to checkout the sources from.

       option

       Specify an option to a package.	The following options are accepted and increment the following text to the cvs-buildpackage command:
       binary-source = 1: "-b"

EXAMPLE

       In the case you still didn't understand the config file, follows an example:

	 <server name="intern">
	   <package name="cvs-autoreleasedeb" cvsroot=":pserver:ruoso@ozonio:/var/cvs" prefix="">
	   </package>
	   <package name="someotherpackage" cvsroot=":pserver:ruoso@ozonio:/var/cvs" prefix="">
	     <option name="binary-source" value="1"/>
	   </package>
	 </server>

SEE ALSO

       cvs-buildpackage(1), cvs(1), cvs-autoreleasedeb(1), dupload(1)

AUTHOR

       This  manual page was written by Daniel Ruoso <daniel@ruoso.com>, for the Debian GNU/Linux system.

perl v5.8.7							    2006-08-04						CVS-AUTORELEASEDEB.CONF(5)