2919
2906
"Makefile target just runs the ``dh`` script which will run everything needed."
2922
#: ../ubuntu-packaging-guide/packaging-new-software.rst:121
2909
#: ../ubuntu-packaging-guide/packaging-new-software.rst:113
2924
2911
"All of these file are explained in more detail in the :doc:`overview of the "
2925
2912
"debian directory<./debian-dir-overview>` article."
2928
#: ../ubuntu-packaging-guide/packaging-new-software.rst:124
2915
#: ../ubuntu-packaging-guide/packaging-new-software.rst:116
2929
2916
msgid "Finally commit the code to your packaging branch::"
2932
#: ../ubuntu-packaging-guide/packaging-new-software.rst:130
2919
#: ../ubuntu-packaging-guide/packaging-new-software.rst:122
2933
2920
msgid "Building the package"
2936
#: ../ubuntu-packaging-guide/packaging-new-software.rst:132
2923
#: ../ubuntu-packaging-guide/packaging-new-software.rst:124
2938
2925
"Now we need to check that our packaging successfully compiles the package "
2939
2926
"and builds the .deb binary package::"
2942
#: ../ubuntu-packaging-guide/packaging-new-software.rst:138
2929
#: ../ubuntu-packaging-guide/packaging-new-software.rst:130
2944
2931
"``bzr builddeb`` is a command to build the package in its current location. "
2945
2932
"The ``-us -uc`` tell it there is no need to GPG sign the package. The "
2946
2933
"result will be placed in ``..``."
2949
#: ../ubuntu-packaging-guide/packaging-new-software.rst:142
2936
#: ../ubuntu-packaging-guide/packaging-new-software.rst:134
2950
2937
msgid "You can view the contents of the package with::"
2953
#: ../ubuntu-packaging-guide/packaging-new-software.rst:146
2940
#: ../ubuntu-packaging-guide/packaging-new-software.rst:138
2955
2942
"Install the package and check it works (later you will be able to uninstall "
2956
2943
"it using ``sudo apt-get remove hello`` if you want)::"
2959
#: ../ubuntu-packaging-guide/packaging-new-software.rst:151
2946
#: ../ubuntu-packaging-guide/packaging-new-software.rst:143
2960
2947
msgid "You can also install all packages at once using::"
2963
#: ../ubuntu-packaging-guide/packaging-new-software.rst:156
2950
#: ../ubuntu-packaging-guide/packaging-new-software.rst:148
2964
2951
msgid "Next Steps"
2967
#: ../ubuntu-packaging-guide/packaging-new-software.rst:158
2954
#: ../ubuntu-packaging-guide/packaging-new-software.rst:150
2969
2956
"Even if it builds the .deb binary package, your packaging may have bugs. "
2970
2957
"Many errors can be automatically detected by our tool ``lintian`` which can "
3430
3412
"Precise) for security updates::"
3433
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:80
3415
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:79
3435
3417
"Update your patch to use the appropriate patch tags. Your patch should have "
3436
3418
"at a minimum the Origin, Description and Bug-Ubuntu tags. For example, edit "
3437
3419
"debian/patches/99-fix-a-vulnerability.patch to have something like::"
3440
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:91
3422
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:90
3442
3424
"Multiple vulnerabilities can be fixed in the same security upload; just be "
3443
3425
"sure to use different patches for different vulnerabilities."
3446
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:95
3428
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:94
3447
3429
msgid "Test and Submit your work"
3450
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:97
3432
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:96
3452
3434
"At this point the process is the same as for :doc:`fixing a regular bug in "
3453
3435
"Ubuntu<./fixing-a-bug>`. Specifically, you will want to:"
3456
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:100
3438
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:99
3458
3440
"Build your package and verify that it compiles without error and without any "
3459
3441
"added compiler warnings"
3444
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:101
3445
msgid "Upgrade to the new version of the package from the previous version"
3462
3448
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:102
3463
msgid "Upgrade to the new version of the package from the previous version"
3466
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:103
3468
3450
"Test that the new package fixes the vulnerability and does not introduce any "
3472
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:105
3454
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:104
3474
3456
"Submit your work via a Launchpad merge proposal and file a Launchpad bug "
3475
3457
"being sure to mark the bug as a security bug and to subscribe ``ubuntu-"
3476
3458
"security-sponsors``"
3479
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:109
3461
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:108
3481
3463
"If the security vulnerability is not yet public then do not file a merge "
3482
3464
"proposal and ensure you mark the bug as private."
3485
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:112
3467
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:111
3487
3469
"The filed bug should include a Test Case, i.e. a comment which clearly shows "
3488
3470
"how to recreate the bug by running the old version then how to ensure the "
3489
3471
"bug no longer exists in the new version."
3492
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:116
3474
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:115
3494
3476
"The bug report should also confirm that the issue is fixed in Ubuntu "
3495
3477
"versions newer than the one with the proposed fix (in the above example "
3524
3506
"can be moved to ``updates``."
3527
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:138
3509
#: ../ubuntu-packaging-guide/security-and-stable-release-updates.rst:137
3529
3511
"See the `Stable Release Updates wiki page <SRUWiki_>`_ for more information."
3514
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:3
3515
msgid "Setting up sbuild"
3518
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:5
3520
"``sbuild`` simplifies building Debian/Ubuntu binary package from source in "
3521
"clean environment. It allows to try debugging packages in environment "
3522
"similar (as opposed to ``pbuild``) to builders used by Launchpad."
3525
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:9
3527
"It works on different architectures and allows to build packages for other "
3528
"releases. It needs kernel supporting overlayfs."
3531
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:13
3532
msgid "Installing sbuild"
3535
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:15
3537
"To use sbuild, you need to install sbuild and other required packages and "
3538
"add yourself to the ``sbuild`` group::"
3541
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:21
3542
msgid "Create ``.sbuildrc`` in your home directory with following content::"
3545
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:50
3547
"Replace “Your Name <user@example.org>” with your name and e-mail address. "
3548
"Change default distribution if you want, but remember that you can specify "
3549
"target distribution when executing command."
3552
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:54
3554
"If you haven’t restarted your session after adding yourself to the "
3555
"``sbuild`` group, enter::"
3558
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:59
3560
"Generate GPG keypair for sbuild and create chroot for specified release::"
3563
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:64
3565
"This will create chroot for your current architecture. You might want to "
3566
"specify another architecture. For this, you can use ``--arch`` option. "
3570
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:71
3571
msgid "Using schroot"
3574
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:74
3575
msgid "Entering schroot"
3578
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:76
3580
"You can use ``schroot -c <release>-<architecture> [-u <USER>]`` to enter "
3581
"newly created chroot, but that’s not exactly the reason why you are using "
3585
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:83
3586
msgid "Using schroot for package building"
3589
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:85
3591
"To build package using sbuild chroot, we use (surprisingly) the ``sbuild`` "
3592
"command. For example, to build ``hello`` package from x86_64 chroot, after "
3593
"applying some changes::"
3596
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:98
3598
"To build package from source package (``.dsc``), use location of the source "
3599
"package as second parameter::"
3602
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:103
3604
"To make use of all power of your CPU, you can specify number of threads used "
3605
"for building using standard ``-j<threads>``::"
3608
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:109
3609
msgid "Maintaining schroots"
3612
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:112
3613
msgid "Listing chroots"
3616
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:114
3618
"To get list of all your sbuild chroots, use ``schroot -l``. The ``source:`` "
3619
"chroots are used as base of new schroots. Changes here aren’t recommended, "
3620
"but if you have specific reason, you can open it using something like::"
3623
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:122
3624
msgid "Updating schroots"
3627
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:124
3628
msgid "To upgrade the whole schroot::"
3631
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:129
3632
msgid "Expiring active schroots"
3635
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:131
3637
"If because of any reason, you haven’t stopped your schroot, you can expire "
3638
"all active schroots using::"
3641
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:137
3642
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:136
3643
msgid "Further reading"
3646
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:139
3647
msgid "There is `Debian wiki page <DebianWiki_>`_ covering sbuild usage."
3650
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:141
3651
msgid "`Ubuntu Wiki <UbuntuWiki_>`_ also has article about basics of sbuild."
3654
#: ../ubuntu-packaging-guide/setting-up-sbuild.rst:143
3656
"``sbuild`` manpages are covering details about sbuild usage and available "
3660
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:3
3661
msgid "ubuntu-dev-tools: Tools for Ubuntu developers"
3664
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:5
3666
"``ubuntu-dev-tools`` package is a collection of 30 tools created for making "
3667
"packaging work much easier for Ubuntu developers. It’s similar in scope to "
3668
"Debian ``devscripts`` package."
3671
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:10
3672
msgid "Setting up packaging environment"
3675
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:12
3677
"``setup-packaging-environment`` command allows to interactively set up "
3678
"packaging environment, including setting environment variables, installing "
3679
"required packages and ensuring that required repositories are enabled."
3682
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:17
3683
msgid "Environment variables"
3686
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:20
3687
msgid "Introducing yourself"
3690
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:22
3692
"``ubuntu-dev-tools`` configurations can be set using environment variables. "
3693
"It’s used for example in changelogs. For example, to set e-mail address (and "
3694
"full name), use ``UBUMAIL`` variable. It overrides the ``DEBEMAIL`` and "
3695
"``DEBFULLNAME`` variables used by ``devscripts``. To learn ``ubuntu-dev-"
3696
"tools`` about you, open `~/.bashrc` in text editor and add something like "
3700
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:30
3702
"Now, save this file and restart your terminal or use ``source ~/.bashrc``."
3705
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:33
3706
msgid "Changing preferred builder"
3709
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:35
3711
"Default builder is specified by ``UBUNTUTOOLS_BUILDER`` variable. To set "
3712
"between *pbuilder* (default), *pbuilder-dist*, and *sbuild*, change this "
3713
"variable. Example::"
3716
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:41
3717
msgid "Save file and restart terminal."
3720
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:43
3722
"You can also check whether to update the builder every time before building, "
3723
"by changing ``UBUNTUTOOLS_UPDATE_BUILDER`` from ``no`` (default) to ``yes``."
3726
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:47
3727
msgid "Downloading source packages"
3730
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:49
3732
"``ubuntu-dev-tools`` comes with ``pull-lp-source`` command, allowing to "
3733
"download source packages from Launchpad. Its usage is simple. To download "
3734
"latest source package for ubuntu-settings, use::"
3737
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:55
3739
"You can also specify release from which you want to download source or "
3740
"specify version of source package. ``-d`` option allows to download source "
3741
"package without extracting. A slightly more complex example would look like "
3745
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:61
3747
"``pull-debian-source`` package allows to do the same for Debian source "
3748
"packages. It has similar syntax."
3751
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:65
3752
msgid "Backporting packages"
3755
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:67
3757
"``ubuntu-dev-tools`` provides ``backportpackage`` allowing us to backport a "
3758
"package from specified release of Ubuntu or Debian. For example, to backport "
3759
"``bzr`` package from latest development release for your installed Ubuntu "
3763
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:74
3765
"This command allows to use more options. To specify Ubuntu release for which "
3766
"you are going to backport a package, use ``-d dest`` or ``--"
3767
"destination=DEST`` parameter, where ``DEST`` is Ubuntu release, for example "
3768
"``xenial``. You can specify more than one destination. In turn, ``-s "
3769
"SOURCE`` and ``--source=SOURCE`` specifies the Ubuntu or Debian release from "
3770
"which you are going to backport a package. ``-w DIR`` and ``--workdir=DIR`` "
3771
"specifies directory, where package files will be downloaded, unpacked and "
3772
"built. By default, it will create temporary directory that will be "
3773
"automatically deleted. ``-U`` or ``--update`` allows to update build "
3774
"environment before building package. ``-u`` or ``--upload`` allows to upload "
3775
"package after building (for example to PPAs) using ``dput``."
3778
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:86
3779
msgid "Requesting backports"
3782
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:88
3784
"``requestbackport`` command makes creating backports through Launchpad bugs "
3785
"much easier. It creates testing checklist that will be included in the bug. "
3786
"For example, to request backporting libqt5webkit5 from latest development "
3787
"branch to current stable release (without optional parameters)::"
3790
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:95
3792
"You should fulfill the checklist if you have already tested the backport."
3795
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:97
3797
"Additional options allows to specify destination of backport and its source, "
3798
"by using ``-d DEST`` or ``--destination=DEST`` and ``s SRC`` or ``--"
3802
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:101
3803
msgid "Other simple commands"
3806
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:103
3808
"``ubuntu-dev-tools`` also includes small utilities allowing to do simple "
3809
"tasks like checking whether .iso file is an Ubuntu installation media."
3812
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:107
3813
msgid "``ubuntu-iso``"
3816
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:109
3817
msgid "To do this, use ``ubuntu-iso <pathtoiso>``, for example::"
3820
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:114
3821
msgid "``bitesize``"
3824
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:116
3826
"“Bitesize” tag is used on Launchpad to describe tasks that are suitable for "
3827
"begineers who want to contribute to one of the projects. ``bitesize`` "
3828
"command allows to add “bitesize” tag to Launchpad bug with just simple "
3829
"command, by providing its number, like::"
3832
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:124
3836
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:126
3838
"``404main`` allows to check whether all of package build dependencies are "
3839
"included in main repository of specified Ubuntu distribution. Example::"
3842
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:131
3844
"If any of the required packages isn’t part of Ubuntu main repository, you "
3845
"can check whether the package fulfill `Ubuntu main inclusion requirements "
3846
"<Requirements_>`_ and request it."
3849
#: ../ubuntu-packaging-guide/ubuntu-dev-tools.rst:138
3851
"``ubuntu-dev-tools`` manpages are covering more about usage of this package."
3532
3854
msgid "translator-credits"
3534
3856
"Launchpad Contributions:\n"