X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=blobdiff_plain;f=po4a%2Fpo%2Fbest-pkging-practices.pot;h=928d316d854f3b157ea6faba2c0a17db3e7d216c;hp=82efd3d156646b769bc1af929c6f71476f0cff7e;hb=6484c3554309c0613fff3885ea68b7e657a1d0e5;hpb=c987e0e1ba5bd2ccca8315bad98d1b0dbc50a318 diff --git a/po4a/po/best-pkging-practices.pot b/po4a/po/best-pkging-practices.pot index 82efd3d..928d316 100644 --- a/po4a/po/best-pkging-practices.pot +++ b/po4a/po/best-pkging-practices.pot @@ -7,13 +7,14 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2010-06-03 21:58-0400\n" +"POT-Creation-Date: 2011-10-12 09:49+0300\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=utf-8\n" -"Content-Transfer-Encoding: ENCODING" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" #. type: Content of: #: best-pkging-practices.dbk:7 @@ -1617,7 +1618,7 @@ msgstr "" #: best-pkging-practices.dbk:1119 msgid "" "The short description should be kept short (50 characters or so) so that it " -"may be accomodated by most debconf interfaces. Keeping it short also helps " +"may be accommodated by most debconf interfaces. Keeping it short also helps " "translators, as usually translations tend to end up being longer than the " "original." msgstr "" @@ -1768,7 +1769,7 @@ msgid "" "The short description should be phrased in the form of a question which " "should be kept short and should generally end with a question mark. Terse " "writing style is permitted and even encouraged if the question is rather " -"long (remember that translations are often longer than original versions)" +"long (remember that translations are often longer than original versions)." msgstr "" #. type: Content of: <chapter><section><section><section><section><itemizedlist><listitem><para> @@ -1929,7 +1930,7 @@ msgid "" "the default value for a language choice), consider using the special " "_Default type documented in <citerefentry> " "<refentrytitle>po-debconf</refentrytitle> <manvolnum>7</manvolnum> " -"</citerefentry>)." +"</citerefentry>." msgstr "" #. type: Content of: <chapter><section><title> @@ -2312,25 +2313,33 @@ msgid "" "search .|grep transitional</command>." msgstr "" +#. type: Content of: <chapter><section><section><para> +#: best-pkging-practices.dbk:1674 +msgid "" +"Also, it is recommended to adjust its section to <literal>oldlibs</literal> " +"and its priority to <literal>extra</literal> in order to ease " +"<command>deborphan</command>'s job." +msgstr "" + #. type: Content of: <chapter><section><section><title> -#: best-pkging-practices.dbk:1676 -msgid "Best practices for <filename>.orig.tar.{gz,bz2,lzma}</filename> files" +#: best-pkging-practices.dbk:1683 +msgid "Best practices for <filename>.orig.tar.{gz,bz2,xz}</filename> files" msgstr "" #. type: Content of: <chapter><section><section><para> -#: best-pkging-practices.dbk:1678 +#: best-pkging-practices.dbk:1685 msgid "" "There are two kinds of original source tarballs: Pristine source and " "repackaged upstream source." msgstr "" #. type: Content of: <chapter><section><section><section><title> -#: best-pkging-practices.dbk:1682 +#: best-pkging-practices.dbk:1689 msgid "Pristine source" msgstr "" #. type: Content of: <chapter><section><section><section><para><footnote><para> -#: best-pkging-practices.dbk:1686 +#: best-pkging-practices.dbk:1693 msgid "" "We cannot prevent upstream authors from changing the tarball they distribute " "without also incrementing the version number, so there can be no guarantee " @@ -2341,15 +2350,15 @@ msgid "" "upstream notices that he wasn't using maximal compression in his original " "distribution and then re-<command>gzip</command>s it), that's just too bad. " "Since there is no good way to upload a new " -"<filename>.orig.tar.{gz,bz2,lzma}</filename> for the same version, there is " +"<filename>.orig.tar.{gz,bz2,xz}</filename> for the same version, there is " "not even any point in treating this situation as a bug." msgstr "" #. type: Content of: <chapter><section><section><section><para> -#: best-pkging-practices.dbk:1684 +#: best-pkging-practices.dbk:1691 msgid "" "The defining characteristic of a pristine source tarball is that the " -"<filename>.orig.tar.{gz,bz2,lzma}</filename> file is byte-for-byte identical " +"<filename>.orig.tar.{gz,bz2,xz}</filename> file is byte-for-byte identical " "to a tarball officially distributed by the upstream author.<placeholder " "type=\"footnote\" id=\"0\"/> This makes it possible to use checksums to " "easily verify that all changes between Debian's version and upstream's are " @@ -2359,7 +2368,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><para> -#: best-pkging-practices.dbk:1704 +#: best-pkging-practices.dbk:1711 msgid "" "There is no universally accepted guidelines that upstream authors follow " "regarding to the directory structure inside their tarball, but " @@ -2369,12 +2378,12 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><para> -#: best-pkging-practices.dbk:1712 +#: best-pkging-practices.dbk:1719 msgid "It unpacks the tarball in an empty temporary directory by doing" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><screen> -#: best-pkging-practices.dbk:1715 +#: best-pkging-practices.dbk:1722 #, no-wrap msgid "" "zcat " @@ -2383,7 +2392,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><para> -#: best-pkging-practices.dbk:1720 +#: best-pkging-practices.dbk:1727 msgid "" "If, after this, the temporary directory contains nothing but one directory " "and no other files, <command>dpkg-source</command> renames that directory to " @@ -2393,7 +2402,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><para> -#: best-pkging-practices.dbk:1729 +#: best-pkging-practices.dbk:1736 msgid "" "Otherwise, the upstream tarball must have been packaged without a common " "top-level directory (shame on the upstream author!). In this case, " @@ -2403,12 +2412,12 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><title> -#: best-pkging-practices.dbk:1740 +#: best-pkging-practices.dbk:1747 msgid "Repackaged upstream source" msgstr "" #. type: Content of: <chapter><section><section><section><para> -#: best-pkging-practices.dbk:1742 +#: best-pkging-practices.dbk:1749 msgid "" "You <emphasis role=\"strong\">should</emphasis> upload packages with a " "pristine source tarball if possible, but there are various reasons why it " @@ -2418,24 +2427,24 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><para> -#: best-pkging-practices.dbk:1749 +#: best-pkging-practices.dbk:1756 msgid "" "In these cases the developer must construct a suitable " -"<filename>.orig.tar.{gz,bz2,lzma}</filename> file himself. We refer to such " -"a tarball as a repackaged upstream source. Note that a repackaged upstream " +"<filename>.orig.tar.{gz,bz2,xz}</filename> file himself. We refer to such a " +"tarball as a repackaged upstream source. Note that a repackaged upstream " "source is different from a Debian-native package. A repackaged source still " "comes with Debian-specific changes in a separate " "<filename>.diff.gz</filename> or " -"<filename>.debian.tar.{gz,bz2,lzma}</filename> and still has a version " -"number composed of <replaceable>upstream-version</replaceable> and " +"<filename>.debian.tar.{gz,bz2,xz}</filename> and still has a version number " +"composed of <replaceable>upstream-version</replaceable> and " "<replaceable>debian-version</replaceable>." msgstr "" #. type: Content of: <chapter><section><section><section><para> -#: best-pkging-practices.dbk:1758 +#: best-pkging-practices.dbk:1765 msgid "" "There may be cases where it is desirable to repackage the source even though " -"upstream distributes a <filename>.tar.{gz,bz2,lzma}</filename> that could in " +"upstream distributes a <filename>.tar.{gz,bz2,xz}</filename> that could in " "principle be used in its pristine form. The most obvious is if " "<emphasis>significant</emphasis> space savings can be achieved by " "recompressing the tar archive or by removing genuinely useless cruft from " @@ -2444,12 +2453,12 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><para> -#: best-pkging-practices.dbk:1767 -msgid "A repackaged <filename>.orig.tar.{gz,bz2,lzma}</filename>" +#: best-pkging-practices.dbk:1774 +msgid "A repackaged <filename>.orig.tar.{gz,bz2,xz}</filename>" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><para> -#: best-pkging-practices.dbk:1772 +#: best-pkging-practices.dbk:1779 msgid "" "<emphasis role=\"strong\">should</emphasis> be documented in the resulting " "source package. Detailed information on how the repackaged source was " @@ -2463,7 +2472,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><para><footnote><para> -#: best-pkging-practices.dbk:1787 +#: best-pkging-practices.dbk:1794 msgid "" "As a special exception, if the omission of non-free files would lead to the " "source failing to build without assistance from the Debian diff, it might be " @@ -2475,7 +2484,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><para> -#: best-pkging-practices.dbk:1785 +#: best-pkging-practices.dbk:1792 msgid "" "<emphasis role=\"strong\">should not</emphasis> contain any file that does " "not come from the upstream author(s), or whose contents has been changed by " @@ -2483,7 +2492,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><para> -#: best-pkging-practices.dbk:1798 +#: best-pkging-practices.dbk:1805 msgid "" "<emphasis role=\"strong\">should</emphasis>, except where impossible for " "legal reasons, preserve the entire building and portablility infrastructure " @@ -2495,7 +2504,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><para> -#: best-pkging-practices.dbk:1807 +#: best-pkging-practices.dbk:1814 msgid "" "(<emphasis>Rationale:</emphasis> It is common for Debian users who need to " "build software for non-Debian platforms to fetch the source from a Debian " @@ -2504,7 +2513,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><para> -#: best-pkging-practices.dbk:1814 +#: best-pkging-practices.dbk:1821 msgid "" "<emphasis role=\"strong\">should</emphasis> use " "<filename><replaceable>packagename</replaceable>-<replaceable>upstream-version</replaceable>.orig</filename> " @@ -2513,19 +2522,19 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><section><orderedlist><listitem><para> -#: best-pkging-practices.dbk:1822 +#: best-pkging-practices.dbk:1829 msgid "" "<emphasis role=\"strong\">should</emphasis> be gzipped or bzipped with " "maximal compression." msgstr "" #. type: Content of: <chapter><section><section><section><title> -#: best-pkging-practices.dbk:1829 +#: best-pkging-practices.dbk:1836 msgid "Changing binary files" msgstr "" #. type: Content of: <chapter><section><section><section><para> -#: best-pkging-practices.dbk:1831 +#: best-pkging-practices.dbk:1838 msgid "" "Sometimes it is necessary to change binary files contained in the original " "tarball, or to add binary files that are not in it. This is fully supported " @@ -2539,12 +2548,12 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><title> -#: best-pkging-practices.dbk:1846 +#: best-pkging-practices.dbk:1853 msgid "Best practices for debug packages" msgstr "" #. type: Content of: <chapter><section><section><para> -#: best-pkging-practices.dbk:1848 +#: best-pkging-practices.dbk:1855 msgid "" "A debug package is a package with a name ending in -dbg, that contains " "additional information that <command>gdb</command> can use. Since Debian " @@ -2556,7 +2565,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><para> -#: best-pkging-practices.dbk:1856 +#: best-pkging-practices.dbk:1863 msgid "" "It is up to a package's maintainer whether to create a debug package or " "not. Maintainers are encouraged to create debug packages for library " @@ -2569,7 +2578,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><para> -#: best-pkging-practices.dbk:1866 +#: best-pkging-practices.dbk:1873 msgid "" "Some debug packages may contain an entire special debugging build of a " "library or other binary, but most of them can save space and build time by " @@ -2585,7 +2594,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><para> -#: best-pkging-practices.dbk:1878 +#: best-pkging-practices.dbk:1885 msgid "" "The debugging symbols can be extracted from an object file using " "<command>objcopy --only-keep-debug</command>. Then the object file can be " @@ -2596,7 +2605,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><para> -#: best-pkging-practices.dbk:1886 +#: best-pkging-practices.dbk:1893 msgid "" "The <command>dh_strip</command> command in <systemitem " "role=\"package\">debhelper</systemitem> supports creating debug packages, " @@ -2608,7 +2617,7 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><para> -#: best-pkging-practices.dbk:1893 +#: best-pkging-practices.dbk:1900 msgid "" "Note that the debug package should depend on the package that it provides " "debugging symbols for, and this dependency should be versioned. For " @@ -2616,7 +2625,41 @@ msgid "" msgstr "" #. type: Content of: <chapter><section><section><screen> -#: best-pkging-practices.dbk:1897 +#: best-pkging-practices.dbk:1904 #, no-wrap msgid "Depends: libfoo (= ${binary:Version})\n" msgstr "" + +#. type: Content of: <chapter><section><section><title> +#: best-pkging-practices.dbk:1908 +msgid "Best practices for meta-packages" +msgstr "" + +#. type: Content of: <chapter><section><section><para> +#: best-pkging-practices.dbk:1910 +msgid "" +"A meta-package is a mostly empty package that makes it easy to install a " +"coherent set of packages that can evolve over time. It achieves this by " +"depending on all the packages of the set. Thanks to the power of APT, the " +"meta-package maintainer can adjust the dependencies and the user's system " +"will automatically get the supplementary packages. The dropped packages that " +"were automatically installed will be also be marked as removal candidates " +"(and are even automatically removed by <command>aptitude</command>). " +"<systemitem role=\"package\">gnome</systemitem> and <systemitem " +"role=\"package\">linux-image-amd64</systemitem> are two examples of " +"meta-packages (built by the source packages <systemitem " +"role=\"package\">meta-gnome2</systemitem> and <systemitem " +"role=\"package\">linux-latest</systemitem>)." +msgstr "" + +#. type: Content of: <chapter><section><section><para> +#: best-pkging-practices.dbk:1924 +msgid "" +"The long description of the meta-package must clearly document its purpose " +"so that the user knows what he will lose if he removes the package. Being " +"explicit about the consequences is recommended. This is particularly " +"important for meta-packages which are installed during initial installation " +"and that have not been explicitly installed by the user. Those tend to be " +"important to ensure smooth system upgrades and the user should be " +"discouraged from uninstalling them to avoid potential breakages." +msgstr ""