Fix discontinuity in chapter 3, "Fixing a bug"

Bug #1805976 reported by ianmacs on 2018-11-30
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Ubuntu Packaging Guide
Undecided
Unassigned

Bug Description

Wanting to learn how to package software for ubuntu, I have followed the "Ubuntu Packaging Guide", chapters 1, 2 and 3, and in chapter 3 I have to stop following the guide because it does not explain in enough detail what I need to do next.

I have taken the suggestion and found a bug to work on in the "bitesize" bugs and selected #590300. I have pulled the source with

pull-lp-source shadow cosmic

which creates several files and one directory in my current directory. The next instruction in the packaging guide is to run

edit-patch 99-new-patch

quote: "This will copy the packaging to a temporary directory. You can now edit files with a text editor or apply patches from upstream..."

What is missing: The guide does not tell me from which directory I should run this command. It does not tell me if 99-new-patch is always the name that I should use, or if I should chose a different name, and how to choose a name. It does not tell me what it means with "the packaging" that is copied. And it does not explain that this command drops me in another shell when executed from the newly created directory, and probably continues its work when I exit from this shell, which I only discovered while writing this bug report after having given up already.

ianmacs (ianmacs2018) wrote :

When continuing with section 3.8 of the guide, the next step

quilt header --dep3 -e

is supposed to let me modify some author info of the newly created patch. Instead, it seems to change the author infor of the previous patch.

ianmacs (ianmacs2018) wrote :

In section 3.9, I felt lost when finding out the version to inser in

pbuilder-dist <release> build ../<package>_<version>.dsc

I looked this up in the debian/changelog file, and it seemed I should use 1:4.5-1ubuntu4 here.

pbuilder-dist cosmic build ../shadow_1:.dsc

ianmacs (ianmacs2018) wrote :

Sent the previous comment too early. Completing here:

In section 3.9, I felt lost when finding out the version to inser in

pbuilder-dist <release> build ../<package>_<version>.dsc

I looked this up in the debian/changelog file, and it seemed I should use 1:4.5-1ubuntu4 here.

pbuilder-dist cosmic build ../shadow_1:.4.5-1ubuntu4.dsc

but when running this, I got the error

Traceback (most recent call last):
  File "/usr/bin/pbuilder-dist", line 508, in <module>
    main()
  File "/usr/bin/pbuilder-dist", line 501, in main
    sys.exit(subprocess.call(app.get_command(args)))
  File "/usr/bin/pbuilder-dist", line 214, in get_command
    dsc = debian.deb822.Dsc(open(dsc_files[0]))
IOError: [Errno 2] No such file or directory: '../shadow_1:4.5-1ubuntu4.dsc'

I then examined the naming of *.dsc files in .. and removed the "1:" part, and this worked. The guide should explain how to find the correct version number to specify here.

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

Other bug subscribers