SYNOPSIS
yada yadayada 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
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 <[email protected]>.(c) 1999-2003 Piotr Roszatycki <[email protected]>.