dctrl2xml(1) [debian man page]

dctrl2xml(1)															      dctrl2xml(1)

NAME

       dctrl2xml - Debian control data to XML converter

SYNOPSIS

       dctrl2xml [-x | -j] [-f FILE]

DESCRIPTION

       dctrl2xml is a tool that converts Debian control data into an XML representation. It can be used to convert data which is normally found in
       debian/control, .changes, .dsc, Packages, Sources, and similar files to XML.

       For most fields dctrl2xml just uses the field name as element name and the field data as element content. For other fields, such as package
       interrelationship  fields  (Depends,  Build-Depends,  etc.)  or the Files field in .changes or Sources files, dctrl2xml additionally parses
       their field data to represent it in a more fine-structured form.

OPTIONS

       For a full summary of options, run dctrl2xml --help.

       --version
	      Show dctrl2xml's version number.

       -h, --help
	      Show help about options.

       -f FILE, --file=FILE
	      Read Debian control data from file FILE instead of standard input.  FILE can be either a plain text file or a  gzip,  bzip2  or  ZIP
	      file.

       -x, --xml
	      Output Debian control data as XML (default).

       -j, --json
	      Output Debian control data as JSON.

EXAMPLES

       dctrl2xml -f /var/lib/dpkg/available
	      Convert the whole dpkg(1) available file to XML and print it to standard output. This is a typical stress test for dctrl2xml.

       apt-cache show hello build-essential | dctrl2xml
	      Convert  the package records of the hello and build-essential packages to XML and print it to standard output. This is an example of
	      how dctrl2xml can be used in pipes where it reads the control data from standard input.

       apt-cache showsrc hello | dctrl2xml | xmllint --format -
	      This is similar to the above example, except that the xmllint(1) tool (which is in the libxml2-utils Debian package) is used to  re-
	      format  and  reindent dctrl2xml's output to make it more human readable and that the source package records of the hello package are
	      used.

       apt-cache showsrc hello | dctrl2xml -j
	      In this example hello's source package record is printed as JSON instead of XML.

SEE ALSO

       deb-control(5)

AUTHOR

       Written by Frank S. Thomas <fst@debian.org>.

								  20 August 2010						      dctrl2xml(1)

dpkg-scansources(1)						  dpkg utilities					       dpkg-scansources(1)

NAME

       dpkg-scansources - create Sources index files

SYNOPSIS

       dpkg-scansources [options] binary-dir [override-file [path-prefix]] > Sources

DESCRIPTION

       dpkg-scansources scans the given binary-dir for .dsc files.  These are used to create a Debian source index, which is output to stdout.

       The  override-file,  if	given,	is used to set priorities in the resulting index records and to override the maintainer field given in the
       .dsc files. The file can be compressed. See deb-override(5) for the format of this file. NB:  Since the override file is indexed by binary,
       not source, packages, there's a bit of a problem here. The current implementation uses the highest priority of all the binary packages pro-
       duced by a .dsc file for the priority of the source package, and the override entry for the first binary package listed in the .dsc file to
       modify maintainer information. This might change.

       The  path-prefix, if given, is prepended to the directory field in the generated source index. You generally use this to make the directory
       fields contain the path from the top of the Debian archive hierarchy.

       Note: If you want to access the generated Sources file with apt(8) you will probably need to compress the file with gzip(1)  (generating  a
       Sources.gz file). apt ignores uncompressed Sources files except on local access (i.e.  file:// sources).

OPTIONS

       -n, --no-sort
	   Don't sort the index records. Normally they are sorted by source package name.

       -e, --extra-override file
	   Scan file to find supplementary overrides (the file can be compressed). See deb-extra-override(5) for more information on its format.

       -s, --source-override file
	   Use	file  as  the  source override file (the file can be compressed).  The default is the name of the override file you specified with
	   .src appended.

	   The source override file is in a different format from the binary override file. It contains only two whitespace separated fields,  the
	   first  is  the  source package name and the second is the section. Blank lines and comment lines are ignored in the normal manner. If a
	   package appears in both files the source override takes precedence for setting the section.

       --debug
	   Turn debugging on.

       --help
	   Show the usage message and exit.

       --version
	   Show the version and exit.

SEE ALSO

       deb-override(5), deb-extra-override(5), dpkg-scanpackages(1).

AUTHOR

       Roderick Schertler <roderick@argon.org>

Debian Project							    2009-10-01						       dpkg-scansources(1)