[18:04] <somerville32> crimsun, I'm sad to hear you're leaving the community.
[18:05] <somerville32> crimsun, Are you going anywhere specific?
[18:05] <crimsun> ok, carried over from #ubuntu-motu, we'll be looking at paman in hardy
[18:05] <crimsun> this source package update is pretty straightforward, but I'll summarise the background.
[18:06] <crimsun> for hardy, we currently have a mess in the Applications>Sound & Video menu ala http://trilug.org/~crimsun/Screenshot.png
[18:07] <crimsun> the intent is to unclutter the menus similar to how the https://wiki.ubuntu.com/MenusRevisited spec was implemented.
[18:07] <crimsun> so, to start, we make sure our apt source is current for hardy, and then we grab the paman source package from hardy.
[18:08] <crimsun> `apt-get source paman`
[18:08] <crimsun> please note the version, 0.9.4-1
[18:09] <crimsun> the "upstream" version is 0.9.4, and the Debian source packaging revision is 1 (the hyphen is a separator).
[18:09] <crimsun> the version, 0.9.4-1, implies that this source package in Ubuntu hardy was synced directly from Debian without any changes.
[18:10] <crimsun> since we'll be amending the source package, we'll be sure to note that in the version string by appending "ubuntu1" after the Debian source packaging revision (1).
[18:10] <crimsun> the final version for our Ubuntu-modified source package will be 0.9.4-1ubuntu1.
[18:11] <crimsun> Luckily, the devscripts package (`apt-get install devscripts`) contains a 'dch' utility to make working with these versions easier.
[18:11] <crimsun> so, now, we'll begin editing our changelog
[18:12] <crimsun> `cd paman-0.9.4`
[18:12] <crimsun> the next thing we'll do is use the 'dch' utility to bump the version.
[18:12] <crimsun> `dch -i`
[18:12] <crimsun> note how the correct version and distribution release are inserted automatically at the top.
[18:12] <crimsun> paman (0.9.4-1ubuntu1) hardy; urgency=low
[18:13] <crimsun> I'll now outline the three things we need to do;
[18:13] <crimsun> 1) change the maintainer field ala https://wiki.ubuntu.com/DebianMaintainerField
[18:13] <crimsun> 2) create a patch to hide the menu item for paman
[18:14] <crimsun> 3) adjust the package control fields to work appropriately with our new MenusRevisited scheme
[18:14] <crimsun> ---  Step 1  ---
[18:15] <crimsun> since you're now editing debian/changelog, make an entry to note that, e.g., * Packaging:  maintainer field mangling
[18:16] <crimsun> save, then exit the editor you're using
[18:16] <crimsun> now the file that we'll be editing in step 1 is debian/control
[18:17] <crimsun> use an editor with that file, and scroll down to the fourth line
[18:17] <crimsun> "Maintainer: CJ van den Berg <cj@vdbonline.com>"
[18:17] <crimsun> we'll need to change that to "Maintainer: Ubuntu MOTU Developers <ubuntu-motu@lists.ubuntu.com>"
[18:18] <crimsun> next, we retain the original maintainer information by inserting a line below our new one: "XSBC-Original-Maintainer: CJ van den Berg <cj@vdbonline.com>"
[18:19] <crimsun> I'm now going to skip ahead to Step 3, since in that step, we edit the same file (debian/control)
[18:19] <crimsun> ---  Step 3 ---
[18:20] <crimsun> remember that one of the main points of this source package adjustment is to have the appropriate binary packages hinted
[18:20] <crimsun> thus, we need to add several binary package names to Recommends for paman
[18:21] <crimsun> in the "Package: paman" section, please see the Recommends control field
[18:21] <crimsun> currently paman only recommends pavumeter.  We want to amend that to recommend pavucontrol and padevchooser as well
[18:22] <crimsun> "Recommends: pavumeter, pavucontrol, padevchooser"
[18:22] <crimsun> now, we've finished editing debian/control, and thus, we've finished Steps 1 & 3.
[18:22] <crimsun> ---  Step 2  ---
[18:23] <crimsun> now we'll use a handy utility called cdbs-edit-patch to simplify creating a patch for the menu item
[18:24] <crimsun> when we list the contents of the patch directory (`ls debian/patches`), we see there's already one patch
[18:24] <crimsun> next, we check if that one patch is applied (`cat debian/patches/series`)
[18:25] <crimsun> we see that it is.
[18:25] <crimsun> now we'll create a patch that applies on top of that existing one.
[18:26] <crimsun> we'll name our new patch descriptively, say, 0050-MenusRevisited.patch
[18:26] <crimsun> we accomplish this with:
[18:26] <crimsun> `cdbs-edit-patch 0050-MenusRevisited`
[18:27] <crimsun> now, the appropriate line we'll add is "NoDisplay=true"
[18:27] <crimsun> we'll make this change in the shipped desktop file, src/paman.desktop
[18:28] <crimsun> simply appending that new line to the file is sufficient
[18:28] <crimsun> lookee there, a spelling error that we can correct in the Comment field
[18:28] <crimsun> (I changed mine to "Comment=Manage your PulseAudio sound server")
[18:29] <crimsun> that's all the edits we need to make to that desktop file
[18:29] <crimsun> save, then exit the editor
[18:29] <somerville32> I get dpkg-checkbuilddeps: Unmet build dependencies: quilt autotools-dev libpulse-dev libgtkmm-2.4-dev libglademm-2.4-dev lynx asciidoc xmlt when I attempt to use cdbs-edit-patch
[18:30] <crimsun> somerville32: in that case, you need `apt-get build-dep paman`
[18:32] <somerville32> crimsun, installing quilt seemed to correct the issue
[18:33] <crimsun> (right, that's sufficient for the problem at hand.  I'm being a bit more verbose to cover, for posterity/logs, what people may need without an sbuild or pbuilder)
[18:34]  * somerville32 nods.
[18:36] <crimsun> at this point, we've edited src/paman.desktop, so we need to preserve our changes in 0050-MenusRevisited.patch
[18:36] <crimsun> that's pretty straightforward:  we exit by using `exit`
[18:37] <crimsun> we're now back in the original directory, and we've a shiny new debian/patches/0050-MenusRevisited.patch
[18:37] <crimsun> next, we need to append that filename to debian/patches/series so that it's applied
[18:38] <crimsun> `echo 0050-MenusRevisited.patch>>debian/patches/series`
[18:38] <crimsun> and now, we summarise our changes by editing debian/changelog
[18:39] <crimsun> "* Patches:  Apply (new) patch to mask menu item ala MenusRevisited."
[18:40] <crimsun> the next-to-last step will be to regenerate the source package:
[18:40] <crimsun> `debuild -S -uc -us`
[18:42] <crimsun> finally, we'll generate a debdiff that we can attach to a bug report filed, using Launchpad, against the paman source package
[18:42] <crimsun> `cd ..`
[18:42] <crimsun> `debdiff paman_0.9.4-1.dsc paman_0.9.4-1ubuntu1.dsc paman_0.9.4-1ubuntu1.debdiff`
[18:43] <crimsun> err, sorry, that last command should be:
[18:43] <crimsun> `debdiff paman_0.9.4-1.dsc paman_0.9.4-1ubuntu1.dsc > paman_0.9.4-1ubuntu1.debdiff`
[18:44] <crimsun> and we've finished!
[18:49] <somerville32> crimsun, Should we update the standards version?
[18:49] <crimsun> if you wish to verify that 3.7.3 is adhered to and then update it in debian/control, sure.  I didn't, because I didn't verify.
[18:52] <somerville32> Okay
[18:52] <somerville32> I shall
[18:56] <crimsun> -> -motu
[20:18] <h1st0> echo !fonts > h1st0,  h1st0 Read the private message from ubotu
[20:19] <h1st0> hrm...
[20:23] <h1st0> test
[20:23] <h1st0> !test > h1st0
[20:24] <h1st0> !fonts > h1st0,   h1st0 Read the private message from ubotu.