"Packaging New Software" instructions don't work right

Bug #1898410 reported by Pierre Abbat
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Ubuntu Packaging Guide
New
Undecided
Unassigned

Bug Description

I've been writing software for decades, but I'm new to making binary packages of it. I use CMake and out-of-source builds; my source code is in ~/src/foo, my binaries are compiled in ~/build/foo/bar where bar is the type of build, and so I figured I should create a ~/package/ directory to make packages. So I installed the packages recommended for building packages and ran this:

phma@puma:~/package$ bzr dh-make mirasol 0.1.0 ~/build/mirasol/cdbg/mirasol-0.1.0-Source.tar.bz2
bzr: ERROR: Either run the command from an existing branch of upstream, or move mirasol aside and a new branch will be created there.

To someone who doesn't know Debian packaging, this error is quite unclear. The man page of bzr is no help; it doesn't mention the dh-make command.

I looked at the ~/package directory; it contains the tarball and a directory mirasol which contains the source code. From the error I got from running dh_make, I'm guessing that the directory should be named "mirasol-0.1.0", but bzr created the directory, and I don't know how to tell it to include the version number.

The prompt in the instructions is just "$". Could you add the directory to the prompt?

Revision history for this message
Dmitry Shachnev (mitya57) wrote :

Hi!

If you are starting packaging for a new project, I think Git would be a better choice than Bzr. In any case, you can run dh-make, fixup the packaging, and then add the files to your favourite version control system.

I personally never used "bzr dh-make", but you can also look at its --help option, maybe that will give some clue.

Revision history for this message
Pierre Abbat (phma-a) wrote :

This bug is referring to https://packaging.ubuntu.com/html/packaging-new-software.html .

Where would you recommend I read about how to package software? Why is a version control system needed for packaging software?

Revision history for this message
Bram Stolk (b-stolk) wrote (last edit ):

This guide maybe should not be using brz?

The fact that it tells you to install an old version of Ubuntu, because "brz dh_make" is no longer available, is reader-unfriendly.

If the version control is simply used to diff between the original and packaged tree, then it should be a lot easier to just copy the original tree and diff between top level directories?

Is there a non-brz version of this guide available?

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.