2777
2764
"Makefile target just runs the ``dh`` script which will run everything needed."
2780
#: ../ubuntu-packaging-guide/packaging-new-software.rst:121
2767
#: ../ubuntu-packaging-guide/packaging-new-software.rst:113
2782
2769
"All of these file are explained in more detail in the :doc:`overview of the "
2783
2770
"debian directory<./debian-dir-overview>` article."
2786
#: ../ubuntu-packaging-guide/packaging-new-software.rst:124
2773
#: ../ubuntu-packaging-guide/packaging-new-software.rst:116
2787
2774
msgid "Finally commit the code to your packaging branch::"
2790
#: ../ubuntu-packaging-guide/packaging-new-software.rst:130
2777
#: ../ubuntu-packaging-guide/packaging-new-software.rst:122
2791
2778
msgid "Building the package"
2794
#: ../ubuntu-packaging-guide/packaging-new-software.rst:132
2781
#: ../ubuntu-packaging-guide/packaging-new-software.rst:124
2796
2783
"Now we need to check that our packaging successfully compiles the package "
2797
2784
"and builds the .deb binary package::"
2800
#: ../ubuntu-packaging-guide/packaging-new-software.rst:138
2787
#: ../ubuntu-packaging-guide/packaging-new-software.rst:130
2802
2789
"``bzr builddeb`` is a command to build the package in its current location. "
2803
2790
"The ``-us -uc`` tell it there is no need to GPG sign the package. The "
2804
2791
"result will be placed in ``..``."
2807
#: ../ubuntu-packaging-guide/packaging-new-software.rst:142
2794
#: ../ubuntu-packaging-guide/packaging-new-software.rst:134
2808
2795
msgid "You can view the contents of the package with::"
2811
#: ../ubuntu-packaging-guide/packaging-new-software.rst:146
2798
#: ../ubuntu-packaging-guide/packaging-new-software.rst:138
2813
2800
"Install the package and check it works (later you will be able to uninstall "
2814
2801
"it using ``sudo apt-get remove hello`` if you want)::"
2817
#: ../ubuntu-packaging-guide/packaging-new-software.rst:151
2804
#: ../ubuntu-packaging-guide/packaging-new-software.rst:143
2818
2805
msgid "You can also install all packages at once using::"
2821
#: ../ubuntu-packaging-guide/packaging-new-software.rst:156
2808
#: ../ubuntu-packaging-guide/packaging-new-software.rst:148
2822
2809
msgid "Next Steps"
2825
#: ../ubuntu-packaging-guide/packaging-new-software.rst:158
2812
#: ../ubuntu-packaging-guide/packaging-new-software.rst:150
2827
2814
"Even if it builds the .deb binary package, your packaging may have bugs. "
2828
2815
"Many errors can be automatically detected by our tool ``lintian`` which can "
3288
3270
"Precise) for security updates::"
3291
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:80
3273
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:79
3293
3275
"Update your patch to use the appropriate patch tags. Your patch should have "
3294
3276
"at a minimum the Origin, Description and Bug-Ubuntu tags. For example, edit "
3295
3277
"debian/patches/99-fix-a-vulnerability.patch to have something like::"
3298
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:91
3280
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:90
3300
3282
"Multiple vulnerabilities can be fixed in the same security upload; just be "
3301
3283
"sure to use different patches for different vulnerabilities."
3304
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:95
3286
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:94
3305
3287
msgid "Test and Submit your work"
3308
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:97
3290
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:96
3310
3292
"At this point the process is the same as for :doc:`fixing a regular bug in "
3311
3293
"Ubuntu<./fixing-a-bug>`. Specifically, you will want to:"
3314
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:100
3296
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:99
3316
3298
"Build your package and verify that it compiles without error and without any "
3317
3299
"added compiler warnings"
3302
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:101
3303
msgid "Upgrade to the new version of the package from the previous version"
3320
3306
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:102
3321
msgid "Upgrade to the new version of the package from the previous version"
3324
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:103
3326
3308
"Test that the new package fixes the vulnerability and does not introduce any "
3330
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:105
3312
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:104
3332
3314
"Submit your work via a Launchpad merge proposal and file a Launchpad bug "
3333
3315
"being sure to mark the bug as a security bug and to subscribe ``ubuntu-"
3334
3316
"security-sponsors``"
3337
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:109
3319
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:108
3339
3321
"If the security vulnerability is not yet public then do not file a merge "
3340
3322
"proposal and ensure you mark the bug as private."
3343
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:112
3325
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:111
3345
3327
"The filed bug should include a Test Case, i.e. a comment which clearly shows "
3346
3328
"how to recreate the bug by running the old version then how to ensure the "
3347
3329
"bug no longer exists in the new version."
3350
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:116
3332
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:115
3352
3334
"The bug report should also confirm that the issue is fixed in Ubuntu "
3353
3335
"versions newer than the one with the proposed fix (in the above example "
3382
3364
"can be moved to ``updates``."
3385
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:138
3367
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:137
3387
3369
"See the `Stable Release Updates wiki page <SRUWiki_>`_ for more information."
3372
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:3
3373
msgid "Setting up sbuild"
3376
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:5
3378
"``sbuild`` simplifies building Debian/Ubuntu binary package from source in "
3379
"clean environment. It allows to try debugging packages in environment "
3380
"similar (as opposed to ``pbuild``) to builders used by Launchpad."
3383
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:9
3385
"It works on different architectures and allows to build packages for other "
3386
"releases. It needs kernel supporting overlayfs."
3389
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:13
3390
msgid "Installing sbuild"
3393
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:15
3395
"To use sbuild, you need to install sbuild and other required packages and "
3396
"add yourself to the ``sbuild`` group::"
3399
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:21
3400
msgid "Create ``.sbuildrc`` in your home directory with following content::"
3403
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:50
3405
"Replace “Your Name <user@example.org>” with your name and e-mail address. "
3406
"Change default distribution if you want, but remember that you can specify "
3407
"target distribution when executing command."
3410
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:54
3412
"If you haven’t restarted your session after adding yourself to the "
3413
"``sbuild`` group, enter::"
3416
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:59
3418
"Generate GPG keypair for sbuild and create chroot for specified release::"
3421
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:64
3423
"This will create chroot for your current architecture. You might want to "
3424
"specify another architecture. For this, you can use ``--arch`` option. "
3428
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:71
3429
msgid "Using schroot"
3432
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:74
3433
msgid "Entering schroot"
3436
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:76
3438
"You can use ``schroot -c <release>-<architecture> [-u <USER>]`` to enter "
3439
"newly created chroot, but that’s not exactly the reason why you are using "
3443
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:83
3444
msgid "Using schroot for package building"
3447
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:85
3449
"To build package using sbuild chroot, we use (surprisingly) the ``sbuild`` "
3450
"command. For example, to build ``hello`` package from x86_64 chroot, after "
3451
"applying some changes::"
3454
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:98
3456
"To build package from source package (``.dsc``), use location of the source "
3457
"package as second parameter::"
3460
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:103
3462
"To make use of all power of your CPU, you can specify number of threads used "
3463
"for building using standard ``-j<threads>``::"
3466
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:109
3467
msgid "Maintaining schroots"
3470
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:112
3471
msgid "Listing chroots"
3474
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:114
3476
"To get list of all your sbuild chroots, use ``schroot -l``. The ``source:`` "
3477
"chroots are used as base of new schroots. Changes here aren’t recommended, "
3478
"but if you have specific reason, you can open it using something like::"
3481
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:122
3482
msgid "Updating schroots"
3485
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:124
3486
msgid "To upgrade the whole schroot::"
3489
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:129
3490
msgid "Expiring active schroots"
3493
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:131
3495
"If because of any reason, you haven’t stopped your schroot, you can expire "
3496
"all active schroots using::"
3499
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:137
3500
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:136
3501
msgid "Further reading"
3504
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:139
3505
msgid "There is `Debian wiki page <DebianWiki_>`_ covering sbuild usage."
3508
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:141
3509
msgid "`Ubuntu Wiki <UbuntuWiki_>`_ also has article about basics of sbuild."
3512
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:143
3514
"``sbuild`` manpages are covering details about sbuild usage and available "
3518
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:3
3519
msgid "ubuntu-dev-tools: Tools for Ubuntu developers"
3522
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:5
3524
"``ubuntu-dev-tools`` package is a collection of 30 tools created for making "
3525
"packaging work much easier for Ubuntu developers. It’s similar in scope to "
3526
"Debian ``devscripts`` package."
3529
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:10
3530
msgid "Setting up packaging environment"
3533
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:12
3535
"``setup-packaging-environment`` command allows to interactively set up "
3536
"packaging environment, including setting environment variables, installing "
3537
"required packages and ensuring that required repositories are enabled."
3540
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:17
3541
msgid "Environment variables"
3544
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:20
3545
msgid "Introducing yourself"
3548
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:22
3550
"``ubuntu-dev-tools`` configurations can be set using environment variables. "
3551
"It’s used for example in changelogs. For example, to set e-mail address (and "
3552
"full name), use ``UBUMAIL`` variable. It overrides the ``DEBEMAIL`` and "
3553
"``DEBFULLNAME`` variables used by ``devscripts``. To learn ``ubuntu-dev-"
3554
"tools`` about you, open `~/.bashrc` in text editor and add something like "
3558
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:30
3560
"Now, save this file and restart your terminal or use ``source ~/.bashrc``."
3563
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:33
3564
msgid "Changing preferred builder"
3567
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:35
3569
"Default builder is specified by ``UBUNTUTOOLS_BUILDER`` variable. To set "
3570
"between *pbuilder* (default), *pbuilder-dist*, and *sbuild*, change this "
3571
"variable. Example::"
3574
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:41
3575
msgid "Save file and restart terminal."
3578
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:43
3580
"You can also check whether to update the builder every time before building, "
3581
"by changing ``UBUNTUTOOLS_UPDATE_BUILDER`` from ``no`` (default) to ``yes``."
3584
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:47
3585
msgid "Downloading source packages"
3588
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:49
3590
"``ubuntu-dev-tools`` comes with ``pull-lp-source`` command, allowing to "
3591
"download source packages from Launchpad. Its usage is simple. To download "
3592
"latest source package for ubuntu-settings, use::"
3595
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:55
3597
"You can also specify release from which you want to download source or "
3598
"specify version of source package. ``-d`` option allows to download source "
3599
"package without extracting. A slightly more complex example would look like "
3603
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:61
3605
"``pull-debian-source`` package allows to do the same for Debian source "
3606
"packages. It has similar syntax."
3609
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:65
3610
msgid "Backporting packages"
3613
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:67
3615
"``ubuntu-dev-tools`` provides ``backportpackage`` allowing us to backport a "
3616
"package from specified release of Ubuntu or Debian. For example, to backport "
3617
"``bzr`` package from latest development release for your installed Ubuntu "
3621
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:74
3623
"This command allows to use more options. To specify Ubuntu release for which "
3624
"you are going to backport a package, use ``-d dest`` or ``--"
3625
"destination=DEST`` parameter, where ``DEST`` is Ubuntu release, for example "
3626
"``xenial``. You can specify more than one destination. In turn, ``-s "
3627
"SOURCE`` and ``--source=SOURCE`` specifies the Ubuntu or Debian release from "
3628
"which you are going to backport a package. ``-w DIR`` and ``--workdir=DIR`` "
3629
"specifies directory, where package files will be downloaded, unpacked and "
3630
"built. By default, it will create temporary directory that will be "
3631
"automatically deleted. ``-U`` or ``--update`` allows to update build "
3632
"environment before building package. ``-u`` or ``--upload`` allows to upload "
3633
"package after building (for example to PPAs) using ``dput``."
3636
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:86
3637
msgid "Requesting backports"
3640
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:88
3642
"``requestbackport`` command makes creating backports through Launchpad bugs "
3643
"much easier. It creates testing checklist that will be included in the bug. "
3644
"For example, to request backporting libqt5webkit5 from latest development "
3645
"branch to current stable release (without optional parameters)::"
3648
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:95
3650
"You should fulfill the checklist if you have already tested the backport."
3653
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:97
3655
"Additional options allows to specify destination of backport and its source, "
3656
"by using ``-d DEST`` or ``--destination=DEST`` and ``s SRC`` or ``--"
3660
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:101
3661
msgid "Other simple commands"
3664
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:103
3666
"``ubuntu-dev-tools`` also includes small utilities allowing to do simple "
3667
"tasks like checking whether .iso file is an Ubuntu installation media."
3670
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:107
3671
msgid "``ubuntu-iso``"
3674
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:109
3675
msgid "To do this, use ``ubuntu-iso <pathtoiso>``, for example::"
3678
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:114
3679
msgid "``bitesize``"
3682
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:116
3684
"“Bitesize” tag is used on Launchpad to describe tasks that are suitable for "
3685
"begineers who want to contribute to one of the projects. ``bitesize`` "
3686
"command allows to add “bitesize” tag to Launchpad bug with just simple "
3687
"command, by providing its number, like::"
3690
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:124
3694
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:126
3696
"``404main`` allows to check whether all of package build dependencies are "
3697
"included in main repository of specified Ubuntu distribution. Example::"
3700
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:131
3702
"If any of the required packages isn’t part of Ubuntu main repository, you "
3703
"can check whether the package fulfill `Ubuntu main inclusion requirements "
3704
"<Requirements_>`_ and request it."
3707
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:138
3709
"``ubuntu-dev-tools`` manpages are covering more about usage of this package."
3390
3712
msgid "translator-credits"