Changes between Version 13 and Version 14 of AnatomyOfAPackage

Timestamp:

01/23/13 18:07:46 (11 years ago)

Author:

jdreed

Comment:

--

AnatomyOfAPackage

@@ -11 +11 @@
  * '''`debian/copyright`''':  A human-readable description of the copyright status of the package.   See [wiki:Copyright] for what to use in the Athena repository.
  * '''`debian/rules`''': The executable makefile used to build the binary package.  See [wiki:Rules].
+ * '''`debian/source/format`''': If present, it contains the version of the source package (either 1.0 or 3.0).  If absent, debuild will generally create a version 1.0 source package.
 
 N.B. The control file can be generated from the control.in file with the following invocation, from within the package's root directory:
@@ -29 +30 @@
  * `debian/`''`package`''`.postinst`,  `debian/`''`package`''`.preinst`, `debian/`''`package`''`.postrm`, `debian/`''`package`''`.prerm`: The package's maintainer scripts.  See MaintainerScripts for more information.
 
+== Creating a package ==
+
+While you can create all the special files listed above from scratch, Debhelper provides a tool to make things easy for you.  Assuming you have a piece of software in a directory whose name is of the format ''package-version'' (e.g. `foobar-1.0`), you can use the `dh_make` command:
+
+{{{
+dh_make -c gpl -s --createorig
+}}}
+
+That will create a single binary (`-s`) package with the GPL license (`-c gpl`), and will create a .orig tarball for you in the parent directory (`--createorig`).  It will create all the required files for you in the `debian` directory, and then a variety of optional example files (with the `.ex` extension), which you can either customize or delete.  
+
 Next: [wiki:BuildingAPackage]