Man Linux: Main Page and Category List

NAME

       yada - Yet Another Debianisation Aid

SYNOPSIS

       yada yada

       yada rebuild [file]

DESCRIPTION

       yada is a Debian packaging helper. It is intended to keep all the
       information relating to building and cleaning the source and binary
       packages into a single place, and to allow you to specify as much as
       possible of this declaratively. The ‘‘single place’’ is an augmented
       Debian control file named debian/packages, whose format is described in
       packages(7).

       The basic idea is very simple: everything that used to be scattered
       amongst many little files in your debian/ directory is now concentrated
       into a single file, debian/packages. There are only a couple of
       exceptions: debian/changelog is unchanged, and optional debian/yada is
       the yada script. debian/rules, debian/control and optional
       debian/templates are now generated from debian/packages by yada. Most
       of the other files in debian/ will then likely be redundant.

       So the only thing you now need to know to switch to yada is how to
       write debian/packages! See packages(7) for the gory details.

       When you’ve written debian/packages, you’ll want to run yada yada in
       order to install the changelog file into your debian/ directory, and
       then run yada generate in order to generate your new debian/rules and
       debian/control.  After that, your rules file should automatically
       regenerate both itself and debian/control as necessary. Failing that,
       run yada generate rules or yada generate control as required.

OPTIONS

       yada    This command creates an skeleton debian/packages file for you
               to fill in, if you don’t already have one and creates
               debian/changelog for initial release.

       rebuild rules
               yada reads debian/packages and generates a new rules file,
               debian/rules. Note that any existing rules file will be
               overwritten, and no backup will be kept.

       rebuild control
               yada reads debian/packages and generates a new control file,
               debian/control. Note that any existing control file will be
               overwritten, and no backup will be kept.

       rebuild templates
               yada reads debian/packages and generates a new optional
               templates file, debian/templates. Note that any existing
               templates file will be overwritten, and no backup will be kept.
               This file is created only if debian/packages contains any
               Templates: field. The file might be used with debconf-
               updatepo(1) command of po-debconf(7) system to regenerate
               DebConf translations located in debian/po/ directory.

       rebuild Regenerates all above required files if they don’t exists
               already.

FILES

       debian/packages
               contains package-specific information used in building both
               binary and source packages

       debian/changelog
               contains version-specific information about the package

       debian/control, debian/rules, debian/templates
               generated automatically

       debian/yada
               the script which controls building of the rules and control
               files, and which is used by the rules file

SEE ALSO

       packages(7)

DIAGNOSTICS

       yada prints an error message and bails out with a non-zero exit code if
       it detects an error.

BUGS

       This is the kind of software which cannot be bug-free; different people
       will want it to do different things. If you find a real bug, or you
       think a feature should work differently, report it via the Debian bug
       tracking system, and I’ll do my best.

AUTHORS

       (c) 1999 Charles Briscoe-Smith <cpbs@debian.org>.

       (c) 1999-2003 Piotr Roszatycki <dexter@debian.org>.