Merge lp:~laney/ubuntu-packaging-guide/new-software-no-sign into lp:ubuntu-packaging-guide

[Iain Lane]

We should be consistent about signing/not-signing builds at least within the same page.

[lp:~laney/ubuntu-packaging-guide/new-software-no-sign]

120. By Daniel Holbach on 2012-07-08

merged lp:~laney/ubuntu-packaging-guide/new-package-no-debuild

121. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-07-16

Launchpad automatic translations update.

122. By Daniel Holbach on 2012-08-09

merged lp:~mitya57/ubuntu-packaging-guide/add-guide-css

123. By Daniel Holbach on 2012-08-09

merged lp:~jjesse/ubuntu-packaging-guide/fixes-bug950227

124. By Daniel Holbach on 2012-08-09

merged lp:~andrewsomething/ubuntu-packaging-guide/lp942754

[Daniel Holbach (dholbach)]

Hello Iain,

http://developer.ubuntu.com/packaging/html/getting-set-up.html explains how to set up a GPG key. Personally, I'd assume that people would have read it beforehand as it's one of the first articles in the list. Do you think we should link to it in the Packaging New Software article?

Alternatively I think we should at least explain the impact of "-us -uc", ie they won't be able to upload it to a PPA for example.

Let me know what you think.

[lp:~laney/ubuntu-packaging-guide/new-software-no-sign]

125. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-08-17

Launchpad automatic translations update.

126. By Daniel Holbach on 2012-08-22

merged lp:~andrewsomething/ubuntu-packaging-guide/fix-single-html

127. By Daniel Holbach on 2012-08-22

Upload to quantal. (LP: #1004017)

128. By Daniel Holbach on 2012-08-22

Added COPYING.GPL3 text, fixed a mistake in debian/copyright. Thanks Séb.

129. By Daniel Holbach on 2012-08-23

merged lp:~takluyver/ubuntu-packaging-guide/python-english

130. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-08-28

Launchpad automatic translations update.

131. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-08-29

Launchpad automatic translations update.

132. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-08-30

Launchpad automatic translations update.

133. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-08-31

Launchpad automatic translations update.

134. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-09-01

Launchpad automatic translations update.

135. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-09-02

Launchpad automatic translations update.

136. By Daniel Holbach on 2012-09-03

workaround for bug 1043232, disable LANGS, so the build for Japanese PDFs is not attempted

137. By Daniel Holbach on 2012-09-05

merged lp:~donkirkby/ubuntu-packaging-guide/typos

138. By Benjamin Drung on 2012-09-05

Remove trailing spaces.

139. By Benjamin Drung on 2012-09-05

Remove tabs and trailing spaces in debian/copyright.

140. By Benjamin Drung on 2012-09-05

Run wrap-and-sort.

141. By Benjamin Drung on 2012-09-05

Prepare the upload to Debian.

We use Ubuntu Developers <email address hidden> as
Maintainer. Ubuntu Developers, who also are DDs and want to do the
uploads to Debian, should add themselves to the Uploader list.

142. By Andrew Starr-Bochicchio on 2012-09-05

Merge lp:~dholbach/ubuntu-packaging-guide/fix-add-languages-script

143. By Benjamin Drung on 2012-09-05

Add a tutorial with a specific example of how to fix a bug. (LP: #1045396)

144. By Benjamin Drung on 2012-09-05

Fix typo from previous merge.

145. By Benjamin Drung on 2012-09-06

Compress source tarball with xz.

146. By Benjamin Drung on 2012-09-06

Release 0.2.3 to Debian unstable.

147. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-09-09

Launchpad automatic translations update.

148. By Daniel Holbach on 2012-09-09

merged lp:~mitya57/ubuntu-packaging-guide/fixes

149. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-09-10

Launchpad automatic translations update.

150. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-09-11

Launchpad automatic translations update.

151. By Daniel Holbach on 2012-09-11

fix a typo and a syntax error

152. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-09-12

Launchpad automatic translations update.

153. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-09-15

Launchpad automatic translations update.

154. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-09-16

Launchpad automatic translations update.

155. By Benjamin Drung on 2012-09-16

Fix typo (consider appeared twice).

156. By Launchpad Translations on behalf of ubuntu-packaging-guide-team on 2012-09-17

Launchpad automatic translations update.

[Daniel Holbach (dholbach)]

Ping?

[lp:~laney/ubuntu-packaging-guide/new-software-no-sign]

157. By Daniel Holbach on 2012-09-17

merged lp:~doctormo/ubuntu-packaging-guide/ubuntu-styled-images

158. By Iain Lane on 2012-09-17

Minor language corrections/improvements.

"the compile" sounds odd.

159. By Iain Lane on 2012-09-17

Don't sign packages until we need to (for upload). Explain a bit what signing is and point to getting started.

160. By Iain Lane on 2012-09-17

Merge my previous branch

[Iain Lane (laney)]

I added some more text, let me know what you think

[Daniel Holbach (dholbach)]

Looks great. Thanks a bunch!

review: Approve

=== modified file 'ubuntu-packaging-guide/libraries.rst'
--- ubuntu-packaging-guide/libraries.rst	2012-03-20 22:02:49 +0000
+++ ubuntu-packaging-guide/libraries.rst	2012-09-17 08:28:18 +0000
@@ -109,9 +109,9 @@
 
     $ bzr builddeb -- -nc
 
-The ``-nc`` will cause it to finish at the end of the compile without removing
-the build.  Change to the build and run ``dpkg-gensymbols`` for the library
-package::
+The ``-nc`` will cause it to finish at the end of compilation without removing
+the built files.  Change to the build and run ``dpkg-gensymbols`` for the
+library package::
 
     $ cd ../build-area/libnova-0.12.2/
     $ dpkg-gensymbols -plibnova-0.12-2 > symbols.diff
@@ -123,7 +123,7 @@
 Which will create a file named similar to ``dpkg-gensymbolsnY_WWI`` that lists
 all the symbols.  It also lists the current package version.  We can remove the
 packaging version from that listed in the symbols file because new symbols are
-not generally added by new packaging versions::
+not generally added by new packaging versions, but by the upstream developers::
 
     $ sed -i s,-0ubuntu2,, dpkg-gensymbolsnY_WWI
 

=== modified file 'ubuntu-packaging-guide/packaging-new-software.rst'
--- ubuntu-packaging-guide/packaging-new-software.rst	2012-08-28 23:27:17 +0000
+++ ubuntu-packaging-guide/packaging-new-software.rst	2012-09-17 08:28:18 +0000
@@ -51,7 +51,7 @@
 
     $ make
 
-If the compile completes successfully you can install and run the program::
+If compilation completes successfully you can install and run the program::
 
     $ sudo make install
     $ hello
@@ -135,7 +135,7 @@
     $ cd ../../
 
 ``bzr builddeb`` is a command to build the package in its current location.
-The ``-us -uc`` tell it there is no need to GPG sign the compile.  The result
+The ``-us -uc`` tell it there is no need to GPG sign the package.  The result
 will be placed in ``..``.  
 
 You can view the contents of the package with::
@@ -163,11 +163,16 @@
 After making a fix to the packaging you can rebuild using ``-nc`` "no clean"
 without having to build from scratch::
 
-    $ bzr builddeb -- -nc
+    $ bzr builddeb -- -nc -us -uc
 
 Having checked that the package builds locally you should ensure it builds on a
-clean system using ``pbuilder``. If you haven't set up ``pbuilder-dist``
-yet, :doc:`do so now<./getting-set-up>`::
+clean system using ``pbuilder``. Since we are going to upload to a PPA
+(Personal Package Archive) shortly, this upload will need to be *signed* to
+allow Launchpad to verify that the upload comes from you (you can tell the
+upload will be signed because the ``-us`` and ``-uc`` flags are not passed to
+``bzr builddeb`` like they were before). For signing to work you need to have
+set up GPG. If you haven't set up ``pbuilder-dist`` or GPG yet, :doc:`do so
+now<./getting-set-up>`::
 
     $ bzr builddeb -S
     $ cd ../build-area
@@ -178,9 +183,9 @@
 
     $ bzr push lp:~<lp-username>/+junk/hello-package
 
-Uploading it to a PPA (Personal Package Archive) will ensure it builds
-and give an easy way for you and others to test the binary packages.
-You will need to set up a PPA in Launchad then upload with ``dput``::
+Uploading it to a PPA will ensure it builds and give an easy way for you and
+others to test the binary packages.  You will need to set up a PPA in Launchad
+then upload with ``dput``::
 
     $ dput ppa:<lp-username> hello_2.7-0ubuntu1.changes