2793
2780
"Makefile target just runs the ``dh`` script which will run everything needed."
2796
#: ../ubuntu-packaging-guide/packaging-new-software.rst:121
2783
#: ../ubuntu-packaging-guide/packaging-new-software.rst:113
2798
2785
"All of these file are explained in more detail in the :doc:`overview of the "
2799
2786
"debian directory<./debian-dir-overview>` article."
2802
#: ../ubuntu-packaging-guide/packaging-new-software.rst:124
2789
#: ../ubuntu-packaging-guide/packaging-new-software.rst:116
2803
2790
msgid "Finally commit the code to your packaging branch::"
2806
#: ../ubuntu-packaging-guide/packaging-new-software.rst:130
2793
#: ../ubuntu-packaging-guide/packaging-new-software.rst:122
2807
2794
msgid "Building the package"
2810
#: ../ubuntu-packaging-guide/packaging-new-software.rst:132
2797
#: ../ubuntu-packaging-guide/packaging-new-software.rst:124
2812
2799
"Now we need to check that our packaging successfully compiles the package "
2813
2800
"and builds the .deb binary package::"
2816
#: ../ubuntu-packaging-guide/packaging-new-software.rst:138
2803
#: ../ubuntu-packaging-guide/packaging-new-software.rst:130
2818
2805
"``bzr builddeb`` is a command to build the package in its current location. "
2819
2806
"The ``-us -uc`` tell it there is no need to GPG sign the package. The "
2820
2807
"result will be placed in ``..``."
2823
#: ../ubuntu-packaging-guide/packaging-new-software.rst:142
2810
#: ../ubuntu-packaging-guide/packaging-new-software.rst:134
2824
2811
msgid "You can view the contents of the package with::"
2827
#: ../ubuntu-packaging-guide/packaging-new-software.rst:146
2814
#: ../ubuntu-packaging-guide/packaging-new-software.rst:138
2829
2816
"Install the package and check it works (later you will be able to uninstall "
2830
2817
"it using ``sudo apt-get remove hello`` if you want)::"
2833
#: ../ubuntu-packaging-guide/packaging-new-software.rst:151
2820
#: ../ubuntu-packaging-guide/packaging-new-software.rst:143
2834
2821
msgid "You can also install all packages at once using::"
2837
#: ../ubuntu-packaging-guide/packaging-new-software.rst:156
2824
#: ../ubuntu-packaging-guide/packaging-new-software.rst:148
2838
2825
msgid "Next Steps"
2841
#: ../ubuntu-packaging-guide/packaging-new-software.rst:158
2828
#: ../ubuntu-packaging-guide/packaging-new-software.rst:150
2843
2830
"Even if it builds the .deb binary package, your packaging may have bugs. "
2844
2831
"Many errors can be automatically detected by our tool ``lintian`` which can "
3304
3286
"Precise) for security updates::"
3307
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:80
3289
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:79
3309
3291
"Update your patch to use the appropriate patch tags. Your patch should have "
3310
3292
"at a minimum the Origin, Description and Bug-Ubuntu tags. For example, edit "
3311
3293
"debian/patches/99-fix-a-vulnerability.patch to have something like::"
3314
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:91
3296
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:90
3316
3298
"Multiple vulnerabilities can be fixed in the same security upload; just be "
3317
3299
"sure to use different patches for different vulnerabilities."
3320
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:95
3302
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:94
3321
3303
msgid "Test and Submit your work"
3324
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:97
3306
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:96
3326
3308
"At this point the process is the same as for :doc:`fixing a regular bug in "
3327
3309
"Ubuntu<./fixing-a-bug>`. Specifically, you will want to:"
3330
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:100
3312
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:99
3332
3314
"Build your package and verify that it compiles without error and without any "
3333
3315
"added compiler warnings"
3318
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:101
3319
msgid "Upgrade to the new version of the package from the previous version"
3336
3322
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:102
3337
msgid "Upgrade to the new version of the package from the previous version"
3340
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:103
3342
3324
"Test that the new package fixes the vulnerability and does not introduce any "
3346
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:105
3328
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:104
3348
3330
"Submit your work via a Launchpad merge proposal and file a Launchpad bug "
3349
3331
"being sure to mark the bug as a security bug and to subscribe ``ubuntu-"
3350
3332
"security-sponsors``"
3353
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:109
3335
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:108
3355
3337
"If the security vulnerability is not yet public then do not file a merge "
3356
3338
"proposal and ensure you mark the bug as private."
3359
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:112
3341
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:111
3361
3343
"The filed bug should include a Test Case, i.e. a comment which clearly shows "
3362
3344
"how to recreate the bug by running the old version then how to ensure the "
3363
3345
"bug no longer exists in the new version."
3366
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:116
3348
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:115
3368
3350
"The bug report should also confirm that the issue is fixed in Ubuntu "
3369
3351
"versions newer than the one with the proposed fix (in the above example "
3398
3380
"can be moved to ``updates``."
3401
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:138
3383
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:137
3403
3385
"See the `Stable Release Updates wiki page <SRUWiki_>`_ for more information."
3388
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:3
3389
msgid "Setting up sbuild"
3392
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:5
3394
"``sbuild`` simplifies building Debian/Ubuntu binary package from source in "
3395
"clean environment. It allows to try debugging packages in environment "
3396
"similar (as opposed to ``pbuild``) to builders used by Launchpad."
3399
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:9
3401
"It works on different architectures and allows to build packages for other "
3402
"releases. It needs kernel supporting overlayfs."
3405
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:13
3406
msgid "Installing sbuild"
3409
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:15
3411
"To use sbuild, you need to install sbuild and other required packages and "
3412
"add yourself to the ``sbuild`` group::"
3415
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:21
3416
msgid "Create ``.sbuildrc`` in your home directory with following content::"
3419
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:50
3421
"Replace “Your Name <user@example.org>” with your name and e-mail address. "
3422
"Change default distribution if you want, but remember that you can specify "
3423
"target distribution when executing command."
3426
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:54
3428
"If you haven’t restarted your session after adding yourself to the "
3429
"``sbuild`` group, enter::"
3432
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:59
3434
"Generate GPG keypair for sbuild and create chroot for specified release::"
3437
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:64
3439
"This will create chroot for your current architecture. You might want to "
3440
"specify another architecture. For this, you can use ``--arch`` option. "
3444
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:71
3445
msgid "Using schroot"
3448
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:74
3449
msgid "Entering schroot"
3452
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:76
3454
"You can use ``schroot -c <release>-<architecture> [-u <USER>]`` to enter "
3455
"newly created chroot, but that’s not exactly the reason why you are using "
3459
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:83
3460
msgid "Using schroot for package building"
3463
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:85
3465
"To build package using sbuild chroot, we use (surprisingly) the ``sbuild`` "
3466
"command. For example, to build ``hello`` package from x86_64 chroot, after "
3467
"applying some changes::"
3470
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:98
3472
"To build package from source package (``.dsc``), use location of the source "
3473
"package as second parameter::"
3476
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:103
3478
"To make use of all power of your CPU, you can specify number of threads used "
3479
"for building using standard ``-j<threads>``::"
3482
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:109
3483
msgid "Maintaining schroots"
3486
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:112
3487
msgid "Listing chroots"
3490
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:114
3492
"To get list of all your sbuild chroots, use ``schroot -l``. The ``source:`` "
3493
"chroots are used as base of new schroots. Changes here aren’t recommended, "
3494
"but if you have specific reason, you can open it using something like::"
3497
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:122
3498
msgid "Updating schroots"
3501
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:124
3502
msgid "To upgrade the whole schroot::"
3505
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:129
3506
msgid "Expiring active schroots"
3509
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:131
3511
"If because of any reason, you haven’t stopped your schroot, you can expire "
3512
"all active schroots using::"
3515
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:137
3516
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:136
3517
msgid "Further reading"
3520
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:139
3521
msgid "There is `Debian wiki page <DebianWiki_>`_ covering sbuild usage."
3524
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:141
3525
msgid "`Ubuntu Wiki <UbuntuWiki_>`_ also has article about basics of sbuild."
3528
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:143
3530
"``sbuild`` manpages are covering details about sbuild usage and available "
3534
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:3
3535
msgid "ubuntu-dev-tools: Tools for Ubuntu developers"
3538
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:5
3540
"``ubuntu-dev-tools`` package is a collection of 30 tools created for making "
3541
"packaging work much easier for Ubuntu developers. It’s similar in scope to "
3542
"Debian ``devscripts`` package."
3545
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:10
3546
msgid "Setting up packaging environment"
3549
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:12
3551
"``setup-packaging-environment`` command allows to interactively set up "
3552
"packaging environment, including setting environment variables, installing "
3553
"required packages and ensuring that required repositories are enabled."
3556
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:17
3557
msgid "Environment variables"
3560
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:20
3561
msgid "Introducing yourself"
3564
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:22
3566
"``ubuntu-dev-tools`` configurations can be set using environment variables. "
3567
"It’s used for example in changelogs. For example, to set e-mail address (and "
3568
"full name), use ``UBUMAIL`` variable. It overrides the ``DEBEMAIL`` and "
3569
"``DEBFULLNAME`` variables used by ``devscripts``. To learn ``ubuntu-dev-"
3570
"tools`` about you, open `~/.bashrc` in text editor and add something like "
3574
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:30
3576
"Now, save this file and restart your terminal or use ``source ~/.bashrc``."
3579
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:33
3580
msgid "Changing preferred builder"
3583
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:35
3585
"Default builder is specified by ``UBUNTUTOOLS_BUILDER`` variable. To set "
3586
"between *pbuilder* (default), *pbuilder-dist*, and *sbuild*, change this "
3587
"variable. Example::"
3590
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:41
3591
msgid "Save file and restart terminal."
3594
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:43
3596
"You can also check whether to update the builder every time before building, "
3597
"by changing ``UBUNTUTOOLS_UPDATE_BUILDER`` from ``no`` (default) to ``yes``."
3600
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:47
3601
msgid "Downloading source packages"
3604
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:49
3606
"``ubuntu-dev-tools`` comes with ``pull-lp-source`` command, allowing to "
3607
"download source packages from Launchpad. Its usage is simple. To download "
3608
"latest source package for ubuntu-settings, use::"
3611
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:55
3613
"You can also specify release from which you want to download source or "
3614
"specify version of source package. ``-d`` option allows to download source "
3615
"package without extracting. A slightly more complex example would look like "
3619
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:61
3621
"``pull-debian-source`` package allows to do the same for Debian source "
3622
"packages. It has similar syntax."
3625
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:65
3626
msgid "Backporting packages"
3629
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:67
3631
"``ubuntu-dev-tools`` provides ``backportpackage`` allowing us to backport a "
3632
"package from specified release of Ubuntu or Debian. For example, to backport "
3633
"``bzr`` package from latest development release for your installed Ubuntu "
3637
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:74
3639
"This command allows to use more options. To specify Ubuntu release for which "
3640
"you are going to backport a package, use ``-d dest`` or ``--"
3641
"destination=DEST`` parameter, where ``DEST`` is Ubuntu release, for example "
3642
"``xenial``. You can specify more than one destination. In turn, ``-s "
3643
"SOURCE`` and ``--source=SOURCE`` specifies the Ubuntu or Debian release from "
3644
"which you are going to backport a package. ``-w DIR`` and ``--workdir=DIR`` "
3645
"specifies directory, where package files will be downloaded, unpacked and "
3646
"built. By default, it will create temporary directory that will be "
3647
"automatically deleted. ``-U`` or ``--update`` allows to update build "
3648
"environment before building package. ``-u`` or ``--upload`` allows to upload "
3649
"package after building (for example to PPAs) using ``dput``."
3652
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:86
3653
msgid "Requesting backports"
3656
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:88
3658
"``requestbackport`` command makes creating backports through Launchpad bugs "
3659
"much easier. It creates testing checklist that will be included in the bug. "
3660
"For example, to request backporting libqt5webkit5 from latest development "
3661
"branch to current stable release (without optional parameters)::"
3664
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:95
3666
"You should fulfill the checklist if you have already tested the backport."
3669
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:97
3671
"Additional options allows to specify destination of backport and its source, "
3672
"by using ``-d DEST`` or ``--destination=DEST`` and ``s SRC`` or ``--"
3676
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:101
3677
msgid "Other simple commands"
3680
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:103
3682
"``ubuntu-dev-tools`` also includes small utilities allowing to do simple "
3683
"tasks like checking whether .iso file is an Ubuntu installation media."
3686
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:107
3687
msgid "``ubuntu-iso``"
3690
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:109
3691
msgid "To do this, use ``ubuntu-iso <pathtoiso>``, for example::"
3694
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:114
3695
msgid "``bitesize``"
3698
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:116
3700
"“Bitesize” tag is used on Launchpad to describe tasks that are suitable for "
3701
"begineers who want to contribute to one of the projects. ``bitesize`` "
3702
"command allows to add “bitesize” tag to Launchpad bug with just simple "
3703
"command, by providing its number, like::"
3706
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:124
3710
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:126
3712
"``404main`` allows to check whether all of package build dependencies are "
3713
"included in main repository of specified Ubuntu distribution. Example::"
3716
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:131
3718
"If any of the required packages isn’t part of Ubuntu main repository, you "
3719
"can check whether the package fulfill `Ubuntu main inclusion requirements "
3720
"<Requirements_>`_ and request it."
3723
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:138
3725
"``ubuntu-dev-tools`` manpages are covering more about usage of this package."
3406
3728
msgid "translator-credits"
3408
3730
"Launchpad Contributions:\n"