This is an old revision of the document!
# Uncomment this to turn on verbose mode.
format as package name then version
"When working with a package which originated in Debian, use a version number derived from the Debian version number with ubuntu<revision> appended. i.e. Debian 1.0-2 becomes 1.0-2ubuntu1, followed by 1.0-2ubuntu2, etc. Packages not in debian yet should end with revision -0ubuntu1"
sofastatistics (0.6-0ubuntu1) jaunty stable; urgency=low # could be experimental, unstable etc
*ubuntu linux package for jaunty jackalope.
*a stable release. Any other comments about what has changed.
– Grant Paton-Simpson email@example.com Fri, 8 May 2009 18:52:02 +0000
The change details may in fact be any series of lines starting with at least two spaces, but conventionally each change starts with an asterisk and a separating space and continuation lines are indented so as to bring them in line with the start of the text above. Blank lines may be used here to separate groups of changes, if desired.
Doesn't like comma in first line - so jaunty karmic and lucid is fine but jaunty, karmic, and lucid = eof fault.
e.g. Depends: python (>=2.6.2-0ubuntu1), …
The relations allowed are: <<, <=, =, >= and >> for strictly earlier, earlier or equal, exactly equal, later or equal and strictly later, respectively.
main (as opposed to non-free or unknown or contrib) and a subsection e.g. main/python
The Debian archive maintainers provide the authoritative list of subsections. At present, they are: admin, base, comm, contrib, devel, doc, editors, electronics, embedded, games, gnome, graphics, hamradio, interpreters, kde, libs, libdevel, mail, math, misc, net, news, non-free, oldlibs, otherosfs, perl, python, science, shells, sound, tex, text, utils, web, x11.
Line 4 is the name and email address of the maintainer. Make sure that this field includes a valid "To: " header for an email, because after you upload it, the bug tracking system will use it to deliver bug emails to you. Avoid using commas, ampersands and parenthesis.
If your package is architecture independent (for example, a shell or Perl script, or a document), change this to "all", and read later in `rules' file, Section 4.4 about using the `binary-indep' rule instead of `binary-arch' for building the package.
This would apply to python as well.
Stats/analysis - favours ease-of-use over comprehensiveness # has to no more than 60 characters
A statistics, reporting and analysis package with an emphasis on ease-of-use. The goal is flexible input and beautiful output - i.e. lots of databases supported and attractive, ready-to-present output.
If using the GPL, make a selection - either GPL2 or GPL2+
If using the AGPL will need to fill this in manually.
From man dh_make
OPTIONS -c, --copyright <license> Use <license> type in copyright file. <license> can be gpl, lgpl, artistic or bsd. If this field is not specified the copy‐ right file has a space to fill in which sort of license is used. The field is case-insensitive so -c GPL works as well as -c gpl.
NB there must be a space before the description. And complete a full description. If you want a space between 2 lines use a . (dot).
List the directories actually used
NB no preceding slash
Not relevant to me.
"Any extra details or discrepancies between the original package and your debianized version should be documented here."
In rules, it wants tabs, not eight spaces. If using gedit, may need to paste tabs in so it doesn't autoconvert them (or untick “Insert spaces instead of tabs” option under Edit>Preferences>Editor).
E.g. (NB only showing examples of some sections, not a replacement for entire rules document)
build-stamp: configure-stamp # NB tab in front of each of the following
clean: # NB tab in front of each of the following
rm -f build-stamp configure-stamp
install: build # NB tab in front of each of the following
# Add here commands to install the package into debian/mydeb.
#$(MAKE) DESTDIR=$(CURDIR)/debian/mydeb install
mkdir -p $(CURDIR)/debian/mydeb
cp mydeb.py $(CURDIR)/debian/mydeb/usr/share/pyshared/mydeb/mydeb.py
mime.conf needs this line:
Icon is in /usr/share/pyshared/sofa/images/sofa_48x48.xpm
NB make executable to see as icon
Available Categories are:
For SOFA I want it to appear under Science. Putting Science on its own is not enough. Need Education as well.
What I haven't been able to figure out is where the "Categories" come from, and how they are parsed. If I leave for example "Education;" out of it, it will not show up in the "Science" menu, but in the "Others" menu. [[http://ubuntuforums.org/showpost.php?p=9744155&postcount=8 | Creating .debs - not exactly easy]]