Dear Debian I18N people, I would like to know if some of you would be interested in translating the svn-buildpackage manpages. svn-buildpackage already includes fr.po. So do not translate it to these languages (the translators will be contacted separately). language translated fuzzy untranslated ----------------------------------------------------- fr 266 172 2 Please send the updated file to me, or submit it as a wishlist bug against svn-buildpackage, including "manpage" in the bug title. The deadline for receiving the updated translation is Tue, 21 Sep 2010 22:11:02 +0100. If you have read so far, please find the POT file in attachment. Thanks in advance,
# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2009-12-22 11:49+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=CHARSET\n" "Content-Transfer-Encoding: ENCODING" #. type: Content of the dhfirstname entity #: doc/HOWTO.xml:8 doc/overview.xml:3 msgid "<firstname>Neil</firstname>" msgstr "" #. type: Content of the dhsurname entity #: doc/HOWTO.xml:9 doc/overview.xml:4 msgid "<surname>Williams</surname>" msgstr "" #. type: Content of the dhdate entity #: doc/HOWTO.xml:10 doc/overview.xml:5 msgid "<date>May 2009</date>" msgstr "" #. type: Content of the dhsection entity #: doc/HOWTO.xml:11 doc/overview.xml:6 msgid "<manvolnum>1</manvolnum>" msgstr "" #. type: Content of the dhemail entity #: doc/HOWTO.xml:12 doc/overview.xml:7 msgid "<email>codehelp@debian.org</email>" msgstr "" #. type: Content of the dhusername entity #: doc/HOWTO.xml:13 msgid "Eduard Bloch" msgstr "" #. type: Content of the dhucpackage entity #: doc/HOWTO.xml:14 doc/overview.xml:9 msgid "<refentrytitle>svn-buildpackage</refentrytitle>" msgstr "" #. type: Content of the ucleanpackage entity #: doc/HOWTO.xml:15 doc/overview.xml:11 msgid "uclean" msgstr "" #. type: Content of the dopackage entity #: doc/HOWTO.xml:16 doc/overview.xml:12 msgid "svn-do" msgstr "" #. type: Content of the upgradepackage entity #: doc/HOWTO.xml:17 doc/HOWTO.xml:163 doc/overview.xml:13 msgid "svn-upgrade" msgstr "" #. type: Content of: <refentry><refmeta><refentrytitle> #: doc/HOWTO.xml:18 doc/HOWTO.xml:154 doc/overview.xml:14 doc/svn-inject.xml:33 msgid "svn-inject" msgstr "" #. type: Content of: <book><bookinfo><title> #: doc/HOWTO.xml:19 doc/HOWTO.xml:158 doc/overview.xml:10 doc/overview.xml:26 msgid "svn-buildpackage" msgstr "" #. type: Content of the debian entity #: doc/HOWTO.xml:20 doc/overview.xml:15 msgid "<productname>Debian</productname>" msgstr "" #. type: Content of the gnu entity #: doc/HOWTO.xml:21 doc/overview.xml:16 msgid "<acronym>GNU</acronym>" msgstr "" #. type: Content of the gpl entity #: doc/HOWTO.xml:22 doc/overview.xml:17 msgid "&gnu; <acronym>GPL</acronym>" msgstr "" #. type: Content of: <book><bookinfo><title> #: doc/HOWTO.xml:26 msgid "svn-buildpackage - maintaining Debian packages with Subversion" msgstr "" #. type: Content of: <book><bookinfo> #: doc/HOWTO.xml:27 msgid "" "<copyright> <year>2003-2007</year> <holder>Eduard Bloch</holder> " "</copyright> <copyright> <year>2009</year> <holder>Neil Williams</holder> " "</copyright> <date>Sun 24 May 2009 16:23:42 BST</date>" msgstr "" #. type: Content of: <book><bookinfo><releaseinfo> #: doc/HOWTO.xml:36 msgid "Release: 0.7.1" msgstr "" #. type: Content of: <book><bookinfo><legalnotice><title> #: doc/HOWTO.xml:38 doc/overview.xml:30 msgid "The GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007" msgstr "" #. type: Content of: <book><bookinfo><legalnotice><para> #: doc/HOWTO.xml:39 msgid "This documentation is part of &dhpackage;." msgstr "" #. type: Content of: <book><bookinfo><legalnotice><para> #: doc/HOWTO.xml:40 msgid "" "&dhpackage; is free software; you can redistribute it and/or modify it under " "the terms of the GNU General Public License as published by the Free " "Software Foundation; either version 3 of the License, or (at your option) " "any later version." msgstr "" #. type: Content of: <book><bookinfo><legalnotice><para> #: doc/HOWTO.xml:44 doc/HOWTO.xml:916 doc/overview.xml:36 msgid "" "This program is distributed in the hope that it will be useful, but WITHOUT " "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or " "FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for " "more details." msgstr "" #. type: Content of: <book><bookinfo><legalnotice><para> #: doc/HOWTO.xml:48 doc/overview.xml:40 msgid "" "You should have received a copy of the GNU General Public License along with " "this program. If not, see <ulink " "url=\"http://www.gnu.org/licenses/\">http://www.gnu.org/licenses/</ulink>." msgstr "" #. type: Content of: <book><chapter><title> #: doc/HOWTO.xml:55 msgid "Introduction" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:57 msgid "Purpose" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:58 msgid "" "This short document is only intended to give a short help in converting " "packages to Subversion management. It is primarily intended for developers " "not really familiar with Subversion or CVS management and/or converting from " "maintaining their packages using common tools " "(<filename>dpkg-dev</filename>, <filename>devscripts</filename>) only to " "version control system Subversion." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:67 msgid "Why a version control system?" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:68 msgid "" "But the first question may be: why use a version control system at all? Look " "at how the source is handled by the Debian package. First, we have the pure " "upstream source, which is often maintained by another person. The upstream " "author has his own development line and releases the source in snapshots " "(often called releases or program versions)." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:75 msgid "" "The Debian maintainer adds an own set of modifications, leading to an own " "version of the upstream package. The difference set between this two version " "finally ends in Debian's .diff.gz files, and this patchset is often " "appliable to future upstream versions in order to get the \"Debian " "versions\"." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:81 msgid "" "So the obvious way to deal with source upgrades/changes is using local " "copies, patch, different patchutils and scripts to automate all this, " "e.g. uupdate. However, it often becomes nasty and uncomfortable and there is " "no way to undo changes that you may do by mistakes." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:87 msgid "" "At this point, the Subversion system can be used to simplify that work. It " "does the same things that you normaly would do by-hand but keeps it in an " "own archive (a repository). It stores the development lines of Upstream and " "Debian source, keeping them in different directories (different " "branches). The branches are wired internally (the VCS \"knows\" the history " "of the file and tracks the differences between the Upstream and Debian " "versions). When a new upstream version is installed, the differences " "between the old and new upstream versions and the Debian version are merged " "together." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:98 msgid "" "You can create snapshots of your Debian version (\"tag\" it) and switch " "back to a previous state, or see the changes done in the files. You can " "store when commiting the file to the repository or place custom tags onthe " "files (\"properties\") serving various purposes." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:106 msgid "Features" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:107 msgid "" "<command>svn-buildpackage</command> and other scripts around it has been " "created to do the following things:" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:148 msgid "Contents overview" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:149 msgid "" "There are currently three scripts provided by the " "<command>svn-buildpackage</command> package:" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:170 msgid "Popular repository layouts" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:171 msgid "" "There are different ways to store the packages in the repositories (or in " "multiple repositories at your choice). " "<filename>svn-buildpackage</filename> normally expects a directory structure " "similar to the one well described in the Subversion Book, which looks like:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:178 msgid "Directory hierarchy example." msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:180 #, no-wrap msgid "" "packageA/\n" " trunk/\n" " branches/\n" " branches/upstream\n" " tags/\n" "\n" "projectB/\n" " trunk/\n" " branches/\n" " branches/developerFoo\n" " tags/\n" " " msgstr "" #. type: Content of: <book><chapter><sect1><example> #: doc/HOWTO.xml:179 doc/HOWTO.xml:215 doc/HOWTO.xml:273 doc/HOWTO.xml:359 doc/HOWTO.xml:397 doc/HOWTO.xml:448 doc/HOWTO.xml:498 doc/HOWTO.xml:611 doc/HOWTO.xml:669 doc/HOWTO.xml:692 doc/HOWTO.xml:733 doc/HOWTO.xml:794 doc/HOWTO.xml:806 msgid "<placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:193 msgid "" "packageA above may be a typical upstream-based source package and a projectB " "may be a Debian native package with a separate branch created by developer " "Foo for his own experiments. See <ulink " "url=\"http://svnbook.red-bean.com/html-chunk/ch04s02.html\"> Subversion " "Book/Branches</ulink> for more details about using Subversion branches." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:200 msgid "" "Also note that Tags work quite differently to those in CVS. Subversion does " "not maintain magic tags associated with some files. Instead, it tracks the " "file state and moves, so Tagging something means creating a copy (inside of " "the Repository, harddisk-space efficient) of a certain version of the file " "set. So the Debian branch of the released package source is contained in " "<filename>trunk/</filename> and is tagged by copying (mirroring) the trunk " "tree to <filename>tags/DEBIAN-REVISION</filename>. The same happens for the " "upstream releases. In addition, the most recent upstream version is mirrored " "to <filename>branches/upstream/current</filename>. After few package upgrade " "cycles, the directory tree may look like:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:214 msgid "Example branch directory hierarchy" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:216 #, no-wrap msgid "" "# svn ls -R file:///home/user/svn-repo/dev/translucency\n" "branches/\n" "branches/upstream/\n" "branches/upstream/0.5.9/\n" "branches/upstream/0.5.9/AUTHORS\n" "branches/upstream/0.5.9/COPYING\n" "...\n" "branches/upstream/0.6.0/\n" "branches/upstream/0.6.0/AUTHORS\n" "branches/upstream/0.6.0/COPYING\n" "...\n" "branches/upstream/current/\n" "branches/upstream/current/AUTHORS\n" "branches/upstream/current/COPYING\n" "... same stuff as in 0.6.0 ...\n" "tags/\n" "tags/0.5.9-1/\n" "...\n" "tags/0.5.9-1/debian/\n" "tags/0.5.9-1/debian/README.Debian\n" "...\n" "tags/0.6.0-1/\n" "tags/0.6.0-1/AUTHORS\n" "...\n" "tags/0.6.0-1/debian/\n" "tags/0.6.0-1/debian/README.Debian\n" "tags/0.6.0-1/debian/changelog\n" "...\n" "trunk/\n" "trunk/AUTHORS\n" "trunk/COPYING\n" "... trunk where 0.6.0-2 is beeing prepared ...\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:251 msgid "" "svn-buildpackage also supports the second repository layout suggested in the " "Subversion Book (function/package) but svn-inject prefers the one documented " "above. Both svn-buildpackage and svn-upgrade should be able to auto-detect " "the repository layout and the location of package files." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:257 msgid "" "In theory, you do not have to follow that examples and place the trunk, " "branches and tags directory on the locations you like more. But " "svn-buildpackage and other scripts won't locate the files automaticaly so " "you will need to edit the .svn/deb-layout file in your working directory and " "set paths. See the old <ulink " "url=\"file:///usr/share/doc/svn-buildpackage/CONFIG\">abstract</ulink> about " "how auto-detection works and the <ulink " "url=\"file:///usr/share/doc/svn-buildpackage/examples/config.example\"> " "config example</ulink>." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:268 msgid "" "Finally, the working directory structure on your development system may look " "like:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:272 msgid "Example configuration" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:274 #, no-wrap msgid "" "dev/ # base directory, may be under version control or not\n" "dev/foo # trunk directories of various packages\n" "dev/bar # contents correspond to trunk, see above\n" "dev/tarballs # where \"orig\" tarballs are stored, may be under VC or not\n" "dev/build-area # where the packages are exported temporarily and built\n" msgstr "" #. type: Content of: <book><chapter><title> #: doc/HOWTO.xml:284 msgid "Getting started" msgstr "" #. type: Content of: <book><chapter><para> #: doc/HOWTO.xml:285 msgid "" "Besides the packages that are installed by dependencies when you install " "<filename>svn-buildpackage</filename>, you may need <filename>ssh</filename> " "and the obligatory tool chain: <filename>dpkg-dev</filename>, " "<filename>build-essential</filename> and all the packages they pull into the " "system." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:293 msgid "Quick guide" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:295 msgid "" "Here is a quick guide for those who wish to build an existing package using " "an existing, publically available SVN repository. To create own " "repositories, skip this section and look for more details below." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><para> #: doc/HOWTO.xml:306 msgid "" "NOTE: you need the upstream source tarballs, stored under a usual " "dpkg-source-compatible filename in tarballs/" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:316 msgid "Basic svn usage" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:318 msgid "" "You need only few commands to start using svn with svn-buildpackage " "scripts. If you wish to learn more about it, read parts of the the <ulink " "url=\"http://svnbook.red-bean.com/html-chunk/\"> Subversion " "Book</ulink>. The most used commands are:" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:326 msgid "add" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:328 msgid "rm" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:330 msgid "mv" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:333 msgid "commit" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:336 msgid "resolved" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:339 msgid "diff" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:341 msgid "diff --help" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:343 msgid "cat -r Revision" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:348 msgid "If you are familiar with CVS you will probably know almost all you need." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:353 msgid "Creating Subversion repository" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:355 msgid "The main Subversion repository is easily created with:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:358 msgid "Repository creation example." msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:360 #, no-wrap msgid "$ svnadmin create repo-directory\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:364 msgid "" "For our example, we choose the name <filename>svn-deb-repo</filename> and " "put it in <filename>/home/user</filename>." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:367 msgid "" "If you plan to keep many packages in the one repository including upstream " "tarballs, consider to put it on a hard disk with much free space and good " "performance (especially short disk access times) since the repository will " "grow and the filesystem may become fragmented over time." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:375 msgid "Using by multiple developers" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:377 msgid "" "Multiple developers with local access to the repository may share it using a " "common group. To do so, create a new group and add all developers to it. Run " "\"chgrp -R sharedGroup repdir ; chmod -R g+s repdir\" for the shared group " "and the repository directory. Now, on local access to this repository " "everybody will create files with the appropriate group setting. However, the " "developers will need to set a liberal umask before using svn (like " "\"0022\")." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:386 msgid "" "If somebody resists to do so, there is still a brute-force solution: fix the " "permissions with a post-commit script. However, this is an \"unsound\" " "solution and may lead to <emphasis>ALL KINDS OF PROBLEMS</emphasis>. " "<emphasis>MAKE SURE THAT YOU ARE AWARE OF THE POSSIBLE CONSEQUENCES BEFORE " "YOU OPEN THE PANDORA BOX</emphasis>. See <ulink " "url=\"http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=240630\"> Debian " "BTS</ulink> for details. When you damage your repository, don't blame me and " "remember that there is \"svnadmin recover\"." msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:396 msgid "post-commit hook example" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:398 #, no-wrap msgid "" "#!/bin/sh\n" "\n" "# POST-COMMIT HOOK\n" "# The following corrects the permissions of the repository files\n" "\n" "REPOS=\"$1\"\n" "REV=\"$2\"\n" "\n" "chgrp -R sharedGroup $REPOS\n" "# replace sharedGroup with your group\n" "chmod -R g+r $REPOS\n" "chmod -R g+w $REPOS\n" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:415 msgid "SVN over SSH" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:417 msgid "" "To run Subversion over SSH, you basically need a shell on the target system " "and a subversion repository located there which is created following the " "description above. The repository must be configured for access by the " "system users of the remote system." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:423 msgid "" "Assuming that your user name on the client system is the same as on the " "server side, there is not much to configure. Just change the protocol " "specificaton from <filename>file://</filename> to " "<filename>svn+ssh://remoteusername@server-hostname</filename> in all " "examples showed in this manual." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:430 msgid "" "Note that during svn-buildpackage tools actions a lot of SSH calls can be " "made and so the user is asked for his login data. The regular method to deal " "with that is using an SSH key authentication method together with ssh-agent " "and ssh-add to cache the passphrase in memory. Another approach, which also " "brings a significant speed boost, is using a cached SSH connection. This can " "be done with a new feature of OpenSSH (see <ulink " "url=\"http://gcc.gnu.org/wiki/SSH%20connection%20caching\"> GCC SSH " "connection caching howto</ulink>) or a third-party tool like " "<filename>fsh</filename>." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:439 msgid "" "If you wish to use <command>fsh</command> over <command>ssh</command> you " "could specify a custom transport method in the subversion configuration. To " "do so, edit the file <filename>~/.subversion/config</filename> and add the " "section <filename>[tunnels]</filename> to it, following by your custom " "transport definition. Example:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:447 msgid "Example of a custom ssh tunnel command." msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:449 #, no-wrap msgid "" "# personal subversion config with custom ssh tunnel command\n" "[tunnels]\n" "# SSH account on svn.d.o\n" "# compression is enabled in the ssh config\n" "deb = fsh -l <user>\n" "# SSH account for NQ intranet, set fix username\n" "nq = ssh -C -l zomb\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:459 msgid "" "You can use the new defined tunnels in a similar ways as described above but " "replace <filename>svn+ssh</filename> with " "<filename>svn+tunnelname</filename>, so the final URL looks like:" msgstr "" #. type: Content of: <book><chapter><sect1><programlisting> #: doc/HOWTO.xml:464 #, no-wrap msgid "svn+deb://svn.debian.org/svn/myproject/ourpackage/trunk\n" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:469 msgid "Anonymous access" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:471 msgid "" "You can allow outsiders to have anonymous (read-only) access using the " "svnserve program, as described in the Subversion documentation." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:475 msgid "" "Another method is using HTTP/WebDAV with Apache2. More about a such setup " "can be found in the Subversion Book and the <ulink " "url=\"http://wiki.debian.net/?SubversionApache2SSLHowto\"> " "SubversionApache2SSL Howto</ulink>. <ulink " "url=\"http://svn.debian.org/\">svn.debian.org</ulink> is an example site " "granting anonymous access to some selected projects hosted there." msgstr "" #. type: Content of: <book><chapter><title> #: doc/HOWTO.xml:486 msgid "Importing Debian packages" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:488 msgid "Importing from existing source package files" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:490 msgid "" "The <filename>svn-inject</filename> utility is intended to import already " "packaged source packages into a new subdirectory of the repository, creating " "the repository layout as needed. Normally, it takes two arguments: the .dsc " "file of your package and the base URL of the Subversion repository." msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:497 msgid "svn-inject example" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:499 #, no-wrap msgid "" "svn-inject translucency_*dsc file:///tmp/z\n" "cp /tmp/translucency_0.6.0.orig.tar.gz /tmp/tarballs || true\n" "mkdir -p translucency/branches/upstream\n" "tar -z -x -f /tmp/translucency_0.6.0.orig.tar.gz\n" "mv * current\n" "svn -q import -m\"Installing original source version\" translucency " "file:///tmp/z/translucency\n" "svn -m Tagging upstream source version copy " "file:///tmp/z/translucency/branches/\n" "upstream/current file:///tmp/z/translucency/branches/upstream/0.6.0 -q\n" "svn -m Forking to Trunk copy " "file:///tmp/z/translucency/branches/upstream/current " "file:///tmp/z/translucency/trunk -q\n" "dpkg-source -x /tmp/translucency_0.6.0-1.dsc\n" "dpkg-source: extracting translucency in translucency-0.6.0\n" "svn_load_dirs file:///tmp/z/translucency/trunk . *\n" "...\n" "Running /usr/bin/svn propset svn:executable initscript\n" "Running /usr/bin/svn propset svn:executable debian/rules\n" "Running /usr/bin/svn propset svn:executable mounttest.sh\n" "Running /usr/bin/svn propset svn:executable mount.translucency\n" "Running /usr/bin/svn propget svn:eol-style base.h\n" "Running /usr/bin/svn propget svn:eol-style Makefile\n" "Running /usr/bin/svn propget svn:eol-style translucency.8\n" "Running /usr/bin/svn commit -m Load translucency-0.6.0 into " "translucency/trunk.\n" "\n" "Running /usr/bin/svn update\n" "Cleaning up /tmp/svn_load_dirs_jD7OenzVjI\n" "Storing trunk copy in /tmp/translucency.\n" "svn co file:///tmp/z/translucency/trunk /tmp/translucency -q\n" "svn propset svn:executable 1 debian/rules -q\n" "svn -m\"Fixing debian/rules permissions\" commit debian -q\n" "Done! Removing tempdir.\n" "Your working directory is /tmp/translucency - have fun!\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:532 msgid "" "If you omit the URL, <filename>svn-inject</filename> will try to use the URL " "of the current directory as base URL. I would not rely on this, however." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:538 msgid "On-Build-Time merging" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:540 msgid "" "A special feature of svn-buildpackage is so called " "<emphasis>mergeWithUpstream</emphasis> mode. Many projects do not want to " "keep the whole upstream source under revision control, eg. because of the " "large amount of required disc space and process time. Sometimes it makes " "sense to keep only the <filename>debian/</filename> directory any maybe few " "other files under revision control." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:548 msgid "" "The task of exporting the source from repository and adding it to the " "upstream source before building becomes annoying after a little time. But " "the <filename>svn-buildpackage</filename> tools automate most of this work " "for you by switching to <emphasis>mergeWithUpstream</emphasis> mode if a " "special flag has been detected: the mergeWithUpstream (Subversion) property " "of the <filename>debian</filename> " "directory. <filename>svn-buildpackage</filename> will merge the trunk with " "upstream source on build time and <filename>svn-upgrade</filename> will only " "update the changed files in this case." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:560 msgid "" "To enable this feature during the inital import of the source package, " "simply add the <filename>-o</filename> switch to the " "<filename>svn-inject</filename> call and it will prepare the source for with " "<emphasis>mergeWithUpstream</emphasis> mode. This reduces the set of files " "to those modified for Debian and set the " "<emphasis>mergeWithUpstream</emphasis> property." msgstr "" #. type: Content of: <book><chapter><sect1><para><programlisting> #: doc/HOWTO.xml:575 #, no-wrap msgid "svn propset mergeWithUpstream 1 debian" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:568 msgid "" "But what, if you decide to switch to mergeWithUpstream-mode after the " "package has been injected? To do this, checkout the whole repository, remove " "the files not changed in the Debian package from both upstream source and " "Debian branch (<command>svn rm</command>) and set the " "<emphasis>mergeWithUpstream</emphasis> property on " "<filename>debian</filename> in the <filename>trunk</filename> directory " "with: <placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <book><chapter><sect1><para><programlisting> #: doc/HOWTO.xml:580 #, no-wrap msgid "svn propdel mergeWithUpstream debian/" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:577 msgid "" "If you actually decide to stop using the " "<emphasis>mergeWithUpstream</emphasis> mode, unset the " "<emphasis>mergeWithUpstream</emphasis> property as follows: <placeholder " "type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:582 msgid "" "If you don't want to store the upstream sources of all your packages in the " "repository, you can pass the <filename>--no-branches</filename> switch to " "<command>svn-inject</command>, which will prevent " "<command>svn-inject</command> from creating a <filename>branches</filename> " "subdirectory." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><title> #: doc/HOWTO.xml:589 msgid "dpkg-source format 3.0 support" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:590 msgid "" "svn-buildpackage can build packages using source format 3.0, including using " "<filename>../tarballs/foo_1.2.3-1.orig.tar.bz2</filename> in " "mergeWithUpstream mode. Ensure that " "<filename>debian/source/format</filename> exists and has been added to the " "local subversion working copy." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:597 msgid "" "If <filename>debian/source/format</filename> exists and contains " "<emphasis>3.0 *</emphasis>, svn-buildpackage checks for a .orig.tar.bz2 in " "the tarballs directory and uses that for the subsequent build." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><title> #: doc/HOWTO.xml:602 msgid "checking source formats with dpkg-source" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:603 msgid "" "<command>dpkg-source</command> <option>--print-format</option> needs a " "little help to understand common layouts used with subversion. The command " "needs two directories - the current working directory is used to find the " "original tarball and the specified directory is used to locate " "<filename>./debian/changelog</filename>. Change to the directory containing " "the tarball before running <command>dpkg-source</command> " "<option>--print-format</option>:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><programlisting> #: doc/HOWTO.xml:612 #, no-wrap msgid "" "$ svn mkdir debian/source\n" "$ echo \"3.0 (quilt)\" > debian/source/format\n" "$ svn add debian/source/format\n" "$ pushd ../tarballs/\n" "$ dpkg-source --print-format ../trunk/\n" "3.0 (quilt)\n" "$ popd\n" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:625 msgid "Using svn-buildpackage with native packages" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:626 msgid "" "A native package is designed to work with Debian rather than general " "GNU/Linux distributions, many depend directly on specific Debian behaviour " "or other Debian native tools. <emphasis>svn-buildpackage</emphasis> is one " "such native package." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:631 msgid "" "With a native package, the contents of the <filename>debian/</filename> " "directory are included in the source tarball (which uses a plain .tar.gz " "suffix not the .orig.tar.gz suffix) and no .diff.gz is generated." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:635 msgid "" "The principal marker for a native package is the Debian version string. An " "upstream package uses:" msgstr "" #. type: Content of: <book><chapter><sect1><programlisting> #: doc/HOWTO.xml:639 #, no-wrap msgid " foo (0.1.2-3)\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:641 msgid "A native package uses:" msgstr "" #. type: Content of: <book><chapter><sect1><programlisting> #: doc/HOWTO.xml:643 #, no-wrap msgid " foo (0.1.2)\n" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><title> #: doc/HOWTO.xml:646 msgid "Compiled native packages" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:647 msgid "" "Some native packages are compiled from source code and a lot of these " "packages use autotools like <filename>./configure</filename>, " "<command>autoreconf</command> and <command>make dist</command>. Such " "packages can use autotools support to generate a typical GNU or autotools " "style tarball with support for <emphasis>EXTRA_DIST</emphasis> and similar " "rules in <filename>Makefile.am</filename>. This allows the maintainers to " "not need to keep generated files (<filename>configure</filename>, " "<filename>aclocal.m4</filename>, <filename>ltmain.sh</filename> and " "<filename>libtool</filename>) in the subversion repository. With this " "support, the package can directly control which files are included into the " "source for the native package." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:659 msgid "" "To build such packages with <command>svn-buildpackage</command>, " "<emphasis>mergeWithUpstream</emphasis> can be used even if the Debian " "version string indicates a native package. The upstream tarball is the one " "created by the <command>make dist</command> target and the maintainer can " "choose how to make that tarball available to " "<command>svn-buildpackage</command>:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><title> #: doc/HOWTO.xml:667 msgid "Using a native tarball and mergeWithUpstream" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:668 msgid "Makefile.am" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><programlisting> #: doc/HOWTO.xml:670 #, no-wrap msgid "" "all-local: Makefile\n" "\tln -sf $(PACKAGE)-$(VERSION).tar.gz $(PACKAGE)_$(VERSION).orig.tar.gz\n" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:673 msgid "" "(Yes, this is an artefact of using mergeWithUpstream. The .orig.tar.gz is " "not actually used - the Debian version string overrides the merge property.)" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:677 msgid "SVN properties:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><programlisting> #: doc/HOWTO.xml:679 #, no-wrap msgid "" "$ svn proplist ./debian/\n" "Properties on 'debian':\n" " mergeWithUpstream\n" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><title> #: doc/HOWTO.xml:684 msgid "Output of using mergeWithUpstream inside a native package" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:685 msgid "" "The tarball generated by <command>make dist</command> is located using the " "<emphasis>origDir</emphasis> property, in this example, set to the top level " "package directory where <command>make dist</command> would normally create " "it and where the symlink is also created, as above." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:690 msgid "<command>svn-buildpackage</command> output:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:691 msgid "(using langupdate as the example package)" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><programlisting> #: doc/HOWTO.xml:693 #, no-wrap msgid "" "$ svn-buildpackage -us -uc\n" "\torigDir: ./\n" "Complete layout information:\n" "\tbuildArea=/opt/working/emdebian/host/trunk/langupdate/build-area\n" "\torigDir=./\n" "\ttagsDir=/opt/working/emdebian/host/trunk/langupdate/tags\n" "\ttagsUrl=svn+ssh://codehelp@buildd.emdebian.org/var/emdebian/svn/current/host/trunk/langupdate/tags\n" "\ttrunkDir=/opt/working/emdebian/host/trunk/langupdate/trunk\n" "\ttrunkUrl=svn+ssh://codehelp@buildd.emdebian.org/var/emdebian/svn/current/host/trunk/langupdate/trunk\n" "mergeWithUpstream mode detected, looking for " ".//langupdate_0.1.1.orig.tar.gz\n" "I: mergeWithUpstream property set, looking for upstream source tarball...\n" " tar --no-same-owner --no-same-permissions --extract --gzip --file " "/opt/working/emdebian/host/trunk/langupdate/trunk/langupdate-0.1.1.tar.gz " "--directory <1 more argument>\n" " mv " "/opt/working/emdebian/host/trunk/langupdate/build-area/tmp-0.15173904069616/langupdate-0.1.1 " "/opt/working/emdebian/host/trunk/langupdate/build-area/langupdate-0.1.1\n" "svn --force export /opt/working/emdebian/host/trunk/langupdate/trunk " "/opt/working/emdebian/host/trunk/langupdate/build-area/langupdate-0.1.1\n" "Export complete.\n" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:709 msgid "" "Note how the tarball (created by <command>make dist</command> and located by " "<emphasis>mergeWithUpstream</emphasis> due to the symlink) is unpacked and " "then the exported SVN is applied on top. This allows maintainers to test " "local changes using <emphasis>--svn-ignore</emphasis>." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><title> #: doc/HOWTO.xml:717 msgid "Native packages not using autotools" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><title> #: doc/HOWTO.xml:718 doc/HOWTO.xml:728 msgid "The useNativeDist property." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:719 msgid "" "When <command>make dist</command> is not available, there are still " "situations where generated files may need to be included into the source " "tarball of the native package. <command>svn-buildpackage</command> supports " "the <emphasis>useNativeDist</emphasis> SVN property (applied to the " "<filename>./debian/</filename> directory) which allows for customised " "<command>make native-dist</command> target to be run immediately after the " "svn export." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:729 msgid "" "<command>svn-buildpackage</command> uses this feature to include the POT " "file to aid translators. The custom make rule needs to be defined in the top " "level <filename>Makefile</filename>:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><programlisting> #: doc/HOWTO.xml:734 #, no-wrap msgid "" "# adds the POT file to the source tarball\n" "native-dist: Makefile\n" "\tpo4a-build --pot-only\n" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:739 msgid "" "The <emphasis>native-dist</emphasis> target needs to be idempotent and able " "to run straight from the SVN export. Any changes made by running the target " "will be directly reflected in the source tarball. Ensure that no files are " "removed that would prevent the package being built as a normal Debian " "package, using only the resulting source package. (e.g. cd into the " "build-area, unpacking the .dsc with <command>dpkg-source -x</command> and " "rebuild the package, then remove the test directory.)" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:748 msgid "" "The net result is that the resulting source tarball includes the " "<filename>po/svn-buildpackage.pot</filename> generated by the <emphasis>make " "native-dist</emphasis> target without needing to add the generated POT file " "to SVN (and requiring repeated commits each time the POT file is " "timestamped)." msgstr "" #. type: Content of: <book><chapter><title> #: doc/HOWTO.xml:785 msgid "Common tasks" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:788 msgid "Checkout" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:789 msgid "" "<command>svn-inject</command> will do the initial checkout for you. If you " "need another working copy, run" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:793 msgid "svn-inject initial checkout" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:795 #, no-wrap msgid "svn co protocol://repository-base-url/yourpackage\n" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:801 msgid "Building the package" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:802 msgid "Change to your trunk directory and run:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:805 msgid "svn-buildpackage example" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:807 #, no-wrap msgid "$ svn-buildpackage -us -uc -rfakeroot\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:810 msgid "" "You may recognice the options above -- they are passed directly to the build " "command (<filename>dpkg-buildpackage</filename> by default). Normally, the " "build is done in another directory (exporting the source with " "<computeroutput>cp-la-like</computeroutput> method). If you want the " "resulting packages to be placed in the directory above, use the " "<option>--svn-move</option> option. To run Lintian after the build, use " "<option>--svn-lintian</option> option. More options are described in the " "<link linkend=\"sbman\">manpage</link>." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:822 msgid "Working with source" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:823 msgid "" "Every time when you add or modify something, " "<command>svn-buildpackage</command> won't let you proceed unless suspicious " "files are in the clean state (unless you use the " "<option>--svn-ignore</option> switch). You use the commands described in " ""<link linkend=\"basics\">basic svn usage</link>" to register the " "new files (or move or delete the old ones) and commit the changes to the " "repository." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:834 msgid "Handling new upstream versions" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:836 msgid "Upgrading with new upstream version normally happens in two steps:" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:839 msgid "current" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:841 msgid "branches/upstream/oldVersion" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><filename> #: doc/HOWTO.xml:843 doc/HOWTO.xml:845 msgid "trunk/" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:848 msgid "" "The script <command>svn-upgrade</command> (formerly " "<command>svn-uupdate</command>) does both things for you and also creates a " "new changelog entry. The first step is done internally by using a third " "party script (svn_load_dirs, see Subversion book for documentation), the " "second step is done with the merge command of svn. Just run " "<command>svn-upgrade</command> from you local working directory (which " "corresponds the <filename>trunk/</filename> checkout product)." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:856 msgid "" "After running <filename>svn-upgrade</filename> some files may be in " "conflicting state. This is naturaly happens if you have modified some files " "in the upstream package and now upstream did something similar on the same " "positions so <command>svn merge</command> was confused." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:861 msgid "" "When <command>svn-upgrade</command> complains about files in conflicting " "state, fix them manually. When done, use the <command>svn resolved</command> " "command to mark them as clean and <command>svn commit</command> to update " "the repository." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:869 msgid "Finalizing the Revision" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:870 msgid "" "When you are ready to upload a new revision of your package, everything " "builds fine, the changelog is cleaned up and the package is tested, you can " "do the final build and tag the end version. To do so, add " "<option>--svn-tag</option> switch and after the package is built, it will be " "tagged (by creating a copy of the <filename>trunk/</filename> directory as " "said above)." msgstr "" #. type: Content of: <book><chapter><title> #: doc/HOWTO.xml:881 msgid "Command reference" msgstr "" #. type: Content of: <book><chapter><title> #: doc/HOWTO.xml:890 msgid "Further documentation" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:892 msgid "Various links" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><ulink> #: doc/HOWTO.xml:896 msgid "http://subversion.tigris.org" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><ulink> #: doc/HOWTO.xml:899 msgid "http://svnbook.red-bean.com/" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><ulink> #: doc/HOWTO.xml:902 msgid "http://better-scm.berlios.de/" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:908 msgid "Copyright" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:910 msgid "" "This program is free software; you can redistribute it and/or modify it " "under the terms of the GNU General Public License as published by the Free " "Software Foundation; either version 2 of the License, or (at your option) " "any later version." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:922 msgid "" "A copy of the GNU General Public License is available as <ulink " "url=\"file:///usr/share/common-licenses/GPL\"> " "/usr/share/common-licenses/GPL</ulink> in the Debian GNU/Linux distribution " "or on the World Wide Web at <ulink " "url=\"http://www.gnu.org/copyleft/gpl.html\"> " "http://www.gnu.org/copyleft/gpl.html</ulink>. You can also obtain it by " "writing to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, " "Boston, MA 02111-1307, USA." msgstr "" #. type: Content of the dhusername entity #: doc/overview.xml:8 msgid "Neil Williams" msgstr "" #. type: Content of: <book><bookinfo> #: doc/overview.xml:27 msgid "<date>Sun 24 May 2009 16:23:42 BST</date>" msgstr "" #. type: Content of: <book><bookinfo><releaseinfo> #: doc/overview.xml:28 msgid "Release: 0.6.25" msgstr "" #. type: Content of: <book><bookinfo><legalnotice><para> #: doc/overview.xml:31 msgid "This documentation is part of svn-buildpackage." msgstr "" #. type: Content of: <book><bookinfo><legalnotice><para> #: doc/overview.xml:32 msgid "" "svn-buildpackage is free software; you can redistribute it and/or modify it " "under the terms of the GNU General Public License as published by the Free " "Software Foundation; either version 3 of the License, or (at your option) " "any later version." msgstr "" #. type: Content of: <book><chapter><title> #: doc/overview.xml:47 msgid "SVN-BUILDPACKAGE" msgstr "" #. type: Content of: <refentry><refentryinfo><address> #: doc/svn-buildpackage.xml:4 doc/svn-do.xml:5 doc/svn-inject.xml:4 doc/svn-upgrade.xml:4 #, no-wrap msgid "" " <email>blade@debian.org</email>\n" " " msgstr "" #. type: Content of: <refentry><refentryinfo><address> #: doc/svn-buildpackage.xml:7 doc/svn-do.xml:8 doc/svn-inject.xml:7 doc/svn-upgrade.xml:7 doc/uclean.xml:8 #, no-wrap msgid "" " &dhemail;\n" " " msgstr "" #. type: Content of: <refentry><refentryinfo> #: doc/svn-buildpackage.xml:3 doc/svn-do.xml:4 doc/svn-inject.xml:3 doc/svn-upgrade.xml:3 doc/uclean.xml:4 msgid "" "<placeholder type=\"address\" id=\"0\"/> <placeholder type=\"address\" " "id=\"1\"/> <author> <firstname>Eduard</firstname> <surname>Bloch</surname> " "<contrib>This manual page was written by Eduard Bloch in roff. </contrib> " "</author> <author> <firstname>Goneri</firstname> <surname>Le " "Bouder</surname> <contrib>Converted manpages to SGML.</contrib> </author> " "<author> &dhfirstname; &dhsurname; <contrib>Converted manpages to DocBook " "XML and current Debian maintainer </contrib> </author> <copyright> " "<year>2009</year> <holder>&dhusername;</holder> </copyright> &dhdate;" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: doc/svn-buildpackage.xml:38 msgid "&dhpackage;" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:39 doc/svn-upgrade.xml:230 msgid "build Debian packages from SVN repository" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: doc/svn-buildpackage.xml:43 msgid "" "<command>&dhpackage;</command> <arg>[ OPTIONS... ] [ OPTIONS for " "dpkg-buildpackage ] </arg>" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:49 doc/svn-do.xml:51 doc/svn-upgrade.xml:49 doc/uclean.xml:49 msgid "DESCRIPTION" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:50 msgid "" "Builds a Debian package from a Subversion repository. The source code " "repository must be in the format created by svn-inject, and this script must " "be executed from the working directory (trunk/package)." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:54 msgid "" "By default, the working directory is used as the main source directory " "(assuming the whole upstream source is being stored in the repository). The " "alternative is so called \"merge mode\". With this method, only the debian " "directory (and maybe some other modified files) are stored in the " "repository. At build time, the contents of the svn trunk are copied to the " "extracted tarball contents (and can overwrite parts of it). To choose this " "working model, set the svn property <userinput>mergeWithUpstream</userinput> " "on the Debian directory" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-buildpackage.xml:64 #, no-wrap msgid "" "$ svn propset mergeWithUpstream 1 debian\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:66 msgid "" "<emphasis>mergeWithUpstream</emphasis> requires that the build system can " "prepare a tarball, typically using <command>make dist</command> and " "autotools. All upstream packages will have some form of tarball creation " "support and native packages that use autotools or which have internal " "tarball support can use <emphasis>mergeWithUpstream</emphasis> to handle " "generated files that are needed to build the package but are not present in " "SVN. See the HOWTO guide for examples of how this can be done. Native " "packages that do not use autotools and do not have internal tarball support " "can still add generated files to the source package tarball using the " "<emphasis>useNativeDist</emphasis> make target in the top level " "<filename>Makefile</filename>. This custom target must be idempotent and " "only modify / generate the desired files using only the exported SVN source " "and build dependencies. To allow <command>svn-buildpackage</command> to use " "an <command>make native-dist</command> target in your top level " "<filename>Makefile</filename>, set the <emphasis>useNativeDist</emphasis> " "property on the <filename>./debian/</filename> directory:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-buildpackage.xml:86 #, no-wrap msgid "" "$ svn propset useNativeDist 1 debian\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:89 msgid "The default behaviour of <command>svn-buildpackage</command> is as follows:" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:92 msgid "" "Check the working directory, complain on uncommited files (also see " "<emphasis>--svn-ignore-new</emphasis>)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:95 msgid "" "Copy the orig tarball to the build area if necessary (also see " "<emphasis>--svn-no-links</emphasis>)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:98 msgid "" "Extract the tarball (in merge mode) or export the svn work directory to the " "build directory (also see below and <emphasis>--svn-no-links</emphasis>)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:102 msgid "" "Build with dpkg-buildpackage (also see <emphasis>--svn-builder</emphasis>, " "<emphasis>--svn-lintian</emphasis>, etc.)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:106 msgid "Create a changelog entry for the future version" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:109 doc/svn-inject.xml:51 doc/svn-upgrade.xml:58 msgid "OPTIONS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:110 msgid "" "<command>&dhpackage;</command> accepts the following options on the " "command-line:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:116 msgid "<option>--svn-builder=COMMAND</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:119 msgid "" "Specifies alternative build command instead of " "<command>dpkg-buildpackage</command>, eg. <command>debuild</command>, " "<command>pdebuild</command>, etc. Every parameter that " "<command>svn-buildpackage</command> doesn't know " "(<emphasis>--svn-*</emphasis>) is passed to <option>COMMAND</option>. There " "is no difference between the command line and config file parameters . They " "are used at the same time." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:128 msgid "" "WARNING: shell quotation rules do not completely apply here, better use " "wrappers for complex constructs. Using this option may break " "<emphasis>--svn-lintian</emphasis> and <emphasis>--svn-move</emphasis> " "functionality. Some functions may be disabled when a custom build command is " "used because the output file location is not predictable." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:134 msgid "Default: use <command>dpkg-buildpackage</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:139 msgid "<option>--svn-ignore-new</option> | <option>--svn-ignore</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:143 msgid "" "Don't stop on svn conflicts or new/changed files. To set this behaviour for " "single files set the <userinput>deb:ignoreM</userinput> property to 1 on " "them. Also see documentation of the svn:ignore property in the SVN book." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:149 msgid "Default: Stop on conflicts or new/changed files." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:154 msgid "<option>--svn-dont-clean</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:157 msgid "Don't run debian/rules clean." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:158 msgid "Default: clean first" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:163 msgid "<option>--svn-no-links</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:166 msgid "" "Don't use file links but try to export or do hard copies of the working " "directory. This is useful if your package fails to build because some files, " "empty directories, broken links, ... cannot not be transported with in the " "default link-copy mode." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:172 msgid "Default: use links where possible." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:177 msgid "<option>--svn-dont-purge</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:180 msgid "Don't remove the build directory when the build is done." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:182 msgid "Default: remove after successful build." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:188 msgid "<option>--svn-reuse</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:191 msgid "" "If possible, reuse an existing build directory in subsequent builds. The " "build directory is not purged after the build, it is not renamed when a " "build starts and the files are just copied over into it. Useful in " "<emphasis>mergeWithUpstream</emphasis> mode with large packages." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:198 msgid "Default: build directory is removed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:203 msgid "<option>--svn-rm-prev-dir</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:206 msgid "" "If a previous build directory is found, remove it before building instead of " "renaming it. if <emphasis>--svn-reuse</emphasis> is also given in the same " "line, the reuse behaviour occurs." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:211 msgid "Default: rename old directories with a '<option>obsolete</option>' suffix." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:217 msgid "<option>--svn-export</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:220 msgid "" "Just export the working directory and do neccessary code merge operations, " "then exit." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:223 doc/svn-buildpackage.xml:234 doc/svn-buildpackage.xml:244 doc/svn-buildpackage.xml:255 doc/svn-buildpackage.xml:277 doc/svn-buildpackage.xml:289 doc/svn-buildpackage.xml:313 doc/svn-buildpackage.xml:324 doc/svn-buildpackage.xml:335 doc/svn-buildpackage.xml:370 doc/svn-buildpackage.xml:391 doc/svn-buildpackage.xml:401 doc/svn-buildpackage.xml:410 doc/svn-inject.xml:71 doc/svn-inject.xml:81 doc/svn-inject.xml:106 doc/svn-inject.xml:121 doc/svn-inject.xml:144 doc/svn-inject.xml:180 doc/svn-inject.xml:191 doc/svn-upgrade.xml:72 doc/svn-upgrade.xml:85 doc/svn-upgrade.xml:96 doc/svn-upgrade.xml:107 doc/svn-upgrade.xml:120 msgid "Default: Off." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:228 msgid "<option>--svn-tag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:231 msgid "Final build: Tag, export, build cleanly & make new changelog entry." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:239 msgid "<option>--svn-tag-only</option> | <option>--svn-only-tag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:243 msgid "Don't build the package, do only the tag copy" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:249 msgid "<option>--svn-retag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:252 msgid "" "If an existing target directory has been found while trying to create the " "tag copy, remove the target directory first." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:260 msgid "<option>--svn-noautodch</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:263 msgid "No new Debian changelog entry is added automatically." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:265 msgid "" "Default: A new <emphasis>UNRELEASED</emphasis> changelog entry is set via " "<command>dch</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:272 msgid "<option>--svn-lintian</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:275 msgid "Run lintian on the resulting changes file when done." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:282 msgid "<option>--svn-move</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:285 msgid "" "When done, move the created files (as listed in " "<filename>.changes</filename>) to the parent directory, relative to the one " "where svn-buildpackage was started." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:294 msgid "<option>--svn-move-to=...</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:297 msgid "Specifies the target directory to which to move the generated files." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:300 msgid "Default: Off. (Files are left where the build command puts them.)" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:306 msgid "<option>--svn-pkg=packagename</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:309 msgid "" "Overrides the detected package name. Use with caution since it could be set " "too late during the processing (eg. still have the old value when expanding " "shell variables)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:318 msgid "<option>--svn-arch=ARCH</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:321 msgid "" "Allows specifying the build architecture (e.g. i386 build on an amd64 " "machine)." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:329 msgid "<option>--svn-override=var=value,anothervar=value</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:332 msgid "" "Overrides any config variable that has been autodetected or found in " "<emphasis>.svn/deb-layout</emphasis>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:340 msgid "" "<option>--svn-prebuild</option> | <option>--svn-postbuild</option> | " "<option>--svn-pretag</option> | <option>--svn-posttag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:346 msgid "" "Commands (hooks) to be executed before/after the build/tag command " "invocations, e.g. to download the orig tarballs from the archive. Shell code " "can be emdded here though it is not recommended. Various helping variables " "are available in the environment, see ENVIRONMENT VARIABLES below for " "detailed explanation." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:352 msgid "" "Please note that the prebuild and postbuild hooks replace the normal " "prebuild and postbuild actions of <command>svn-buildpackage</command>. For " "prebuild, this means that the build dependencies will not be checked. For " "postbuild, this means that the resulting files won't be moved, and lintian " "will not be run." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:359 msgid "Defaults: Off." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:364 msgid "<option>--svn-noninteractive</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:367 msgid "With this parameter svn-buildpackage will not interact with the user." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:375 msgid "<option>--svn-savecfg</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:378 msgid "" "By default, svn-buildpackage used to create " "<emphasis>.svn/deb-layout</emphasis> on every invocation. Since version " "0.6.22 this behaviour is deprecated." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:382 msgid "" "With this parameter <command>svn-buildpackage</command> will (partly) " "replicate the old behaviour. In contrast to the deprecated behaviour, the " "<emphasis>.svn/deb-layout</emphasis> is regarded as a local override; the " "old behaviour simply ignored any versioned layout information if it found " "<emphasis>.svn/deb-layout</emphasis>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:389 doc/svn-inject.xml:177 msgid "" "This option was provided since it can be useful when creating a local " "override file." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:396 msgid "<option>--svn-download-orig</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:399 msgid "" "This option makes svn-buildpackage try to download the upstream tarball " "using apt and uscan." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:406 msgid "<option>--svn-verbose</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:409 doc/svn-upgrade.xml:106 msgid "More verbose program output" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:415 msgid "<option>-h</option> | <option>--help</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:419 msgid "Show the help message" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:425 msgid "EXAMPLES" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:427 msgid "" "For more detailed information on how to use svn-buildpackage, see the " "HOWTO. <ulink url=\"http://svn-bp.alioth.debian.org/\"> " "http://svn-bp.alioth.debian.org/</ulink>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:432 msgid "" "To start working with existing native Debian package from a *.dsc file, " "import it into the repository with command:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:436 #, no-wrap msgid "" "svn-inject package_0.1.dsc svn://host/debian/devel/packages\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:439 msgid "" "To start working with existing upstream package in Debian from a *.dsc file, " "import it into the repository with command:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:443 #, no-wrap msgid "" "svn-inject -o package_0.1-2.dsc svn://host/debian/devel/packages\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:446 msgid "" "Before building an upstream package, ensure the original source is " "available, e.g. if uscan is working:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:450 #, no-wrap msgid "" "svn mkdir ../tarballs\n" "svn propset svn:ignore \"*\" ../tarballs\n" "uscan --force-download --destdir ../tarballs\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:455 msgid "" "To test building the package from SVN repository, use command below. Refer " "to dpkg-buildpackage(1) manual page for the -us etc. options." msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:459 #, no-wrap msgid "" "svn-buildpackage --svn-lintian -us -uc -rfakeroot\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:462 msgid "To check that package build in a clean state, test it with pbuilder(1):" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:465 #, no-wrap msgid "" "svn mkdir ../build-area # To store results\n" "svn propset svn:ignore \"*\" ../build-area\n" "svn-buildpackage --svn-ignore-new --svn-builder=pdebuild\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:470 msgid "" "When a new upstream release becomes available, commit all changes and have " "the working tree in clean state. Then use svn-upgrade(1) to import the new " "release:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:475 #, no-wrap msgid "" "svn status # Check that there are no uncommited changes\n" "svn-upgrade --verbose ../package-2.0.tar.gz\n" " " msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:480 msgid "CONFIGURATION FILE" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:481 msgid "" "svn-buildpackage's behaviour can be modified using the file " "~/.svn-buildpackage.conf. Additional parts can be added in each package " "working directory using the file .svn/svn-buildpackage.conf. It is " "essentially a list of the long command line options (without leading minus " "signs), one argument per line (without quotes surrounding multi-word " "arguments). The variables are expanded with the system shell if shell " "variables are found there. Avoid ~ sign because of unreliable expansion: it " "is better to use $HOME instead. Example:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:490 #, no-wrap msgid "" "svn-builder=debuild -EPATH\n" "svn-no-links\n" "svn-override=origDir=$HOME/debian/upstream/$PACKAGE\n" "# svn-ignore-new\n" "#svn-lintian\n" " " msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:498 msgid "DIRECTORY LAYOUT HANDLING" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:499 msgid "" "By default, <emphasis>svn-buildpackage</emphasis> expects a configuration " "file with path/url declaration, <emphasis>.svn/deb-layout</emphasis>. The " "values there can be overridden with the <emphasis>--svn-override</emphasis> " "option, see above. If a config file could not be found, the settings are " "autodetected following the usual assumptions about local directories and " "repository layout. In addition, the contents of a custom file " "<emphasis>debian/svn-deblayout</emphasis> will be imported during the " "initial configuration. Package maintainers can store this file in the " "repository to pass correct defaults to new svn-buildpackage users. The " "format is the same as in the file <emphasis>.svn/deb-layout</emphasis>. As " "an alternative to the <emphasis>debian/svn-deblayout</emphasis> file, " "maintainers can set Subversion properties for the " "<emphasis>debian/</emphasis> directory; any properties of " "<emphasis>debian/</emphasis> which have a name of the form " "<emphasis>svn-bp:PROP</emphasis> will be the source of a PROP setting which " "has the value indicated by the first line of the property value. If a full " "svn URL is not given, the repository root will be prepended to this value." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:521 msgid "ENVIRONMENT VARIABLES" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:522 msgid "" "The following environment variables are exported by " "<command>svn-buildpackage</command> and can be used in hook commands or the " "package build system." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:528 msgid "PACKAGE" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:529 msgid "package" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:531 msgid "The source package name" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:535 msgid "SVN_BUILDPACKAGE" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:537 msgid "Version of svn-buildpackage" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:541 msgid "TAG_VERSION" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:542 msgid "debian_version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:544 msgid "The complete Debian version string, also used for the tag copy." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:550 msgid "non_epoch_version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:552 msgid "Same as debian_version but without any epoch strings" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:556 msgid "upstream_version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:558 msgid "Same as debian_version but without Debian extensions" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:562 msgid "guess_loc" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:564 msgid "" "Guessed upstream source package name in the pool, something like " "<filename>libm/libmeta-html-perl_3.2.1.0.orig.tar.gz</filename>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:571 msgid "DIFFSRC" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:573 msgid "(experimental) shows the location of generated diff file" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:577 msgid "" "All the layout properties are exported to the environment, too. The " "following ones have meaning to svn-buildpackage." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:581 msgid "buildArea" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:583 msgid "the location of build area directory" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:587 msgid "trunkUrl" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:589 msgid "the URL of the trunk directory for the current package." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:593 msgid "tagsUrl" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:595 msgid "the URL of the tags base directory for the current package." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:599 msgid "origDir" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:601 msgid "the local directory where the orig tarball should be located." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:607 msgid "origUrl" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:609 msgid "" "the URL from where the orig tarball for the current package can be pulled " "from." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:615 msgid "The following variables are understood by svn-buildpackage:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:619 msgid "FORCETAG" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:621 msgid "Ignore the signs of an incomplete changelog and tag the repository anyway" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:627 msgid "FORCEEXPORT" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:629 msgid "" "Export upstream source from the repository even if " "<userinput>mergeWithUpstream</userinput> property is set." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:635 msgid "DEBIAN_FRONTEND" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:637 msgid "" "If DEBIAN_FRONTEND is set to 'noninteractive' " "<emphasis>--svn-noninteractive</emphasis> is called silently." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:645 msgid "RECOMMENDATIONS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:646 msgid "Use shell aliases. Here are some examples for Bash:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-buildpackage.xml:648 #, no-wrap msgid "" "alias svn-b=\"svn-buildpackage -us -uc -rfakeroot --svn-ignore\"\n" "alias svn-br=\"svn-b --svn-dont-purge --svn-reuse\"\n" "alias svn-bt=\"svn-buildpackage --svn-tag -rfakeroot\"\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:652 msgid "" "Those commands have respective meanings: build regardless of new or changed " "files; build regardless of new or changed files and reuse the build " "directory; build (for upload) and tag." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:656 msgid "" "SSH is the easiest way to access remote repositories, although it usually " "requires entering a password more frequently with " "<command>svn-buildpackage</command>. Workarounds include using an ssh key " "without a passphrase (although this is insecure and still relatively slow), " "or the SSH connection caching feature present in recent versions of SSH. For " "details, see the svn-buildpackage manual." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:664 msgid "" "Another way to get a remote link is using the Subversion DAV module (with " "SSL and Apache user authentication), see the svn-buildpackage HOWTO manual " "for details." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:670 doc/svn-do.xml:97 doc/svn-inject.xml:200 doc/svn-upgrade.xml:202 doc/uclean.xml:61 msgid "SEE ALSO" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:674 doc/svn-inject.xml:206 msgid "" "<citerefentry> " "<refentrytitle>/usr/share/doc/svn-buildpackage/</refentrytitle> " "</citerefentry>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:679 doc/svn-do.xml:106 doc/svn-inject.xml:212 doc/svn-upgrade.xml:212 doc/uclean.xml:71 msgid "The svn-buildpackage HOWTO manual" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:684 doc/svn-do.xml:112 doc/uclean.xml:77 msgid "" "<citerefentry> <refentrytitle>svn-inject</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:690 doc/svn-do.xml:115 doc/svn-inject.xml:40 doc/uclean.xml:80 msgid "puts a Debian source package into Subversion repository" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:695 doc/svn-do.xml:121 doc/svn-inject.xml:219 doc/uclean.xml:86 msgid "" "<citerefentry> <refentrytitle>svn-upgrade</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:701 doc/svn-do.xml:124 doc/svn-upgrade.xml:40 doc/uclean.xml:89 msgid "upgrade source package from a new upstream revision" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:706 doc/svn-do.xml:130 doc/svn-inject.xml:232 doc/svn-upgrade.xml:218 doc/uclean.xml:95 msgid "" "<citerefentry> <refentrytitle>svn</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:712 doc/svn-do.xml:133 doc/svn-inject.xml:236 doc/svn-upgrade.xml:221 doc/uclean.xml:98 msgid "Subversion command line client tool" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:717 doc/svn-do.xml:139 doc/svn-inject.xml:242 doc/uclean.xml:104 msgid "" "<citerefentry> <refentrytitle>dpkg-buildpackage</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:723 doc/svn-do.xml:142 doc/svn-inject.xml:246 doc/uclean.xml:107 msgid "Debian source package tools" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:728 doc/svn-do.xml:148 doc/uclean.xml:113 msgid "" "<citerefentry> <refentrytitle>lintian</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:734 doc/svn-do.xml:151 doc/uclean.xml:116 msgid "Debian package checker" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: doc/svn-do.xml:34 doc/svn-do.xml:39 msgid "&dopackage;" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: doc/svn-do.xml:41 msgid "export a source and run a command inside the source." msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: doc/svn-do.xml:46 msgid "<command>&dopackage; COMMAND</command>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-do.xml:53 msgid "" "svn-do will use svn-buildpackage to export a source, run a command inside " "the exported source and, if the command succeeds, copy back the debian/ tree" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-do.xml:58 msgid "Examples" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-do.xml:59 msgid "clean the tree (useful if this requires the full source tree)" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-do.xml:62 #, no-wrap msgid "" "$ svn-do debclean\n" "I: Exporting source tree via svn-buildpackage...\n" "[...]\n" "I: Running command: debclean\n" "[...]\n" "I: Copying back the debian/ tree...\n" "'debian/control' -> 'path/package/debian/control'\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-do.xml:70 msgid "use quilt to refresh a patch" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-do.xml:72 #, no-wrap msgid "" "$ QUILT_PATCHES=debian/patches svn-do \\\n" " sh -c \"quilt push 002_static-linking-dont-build-perf.patch; \\\n" " quilt refresh\"\n" "[...]\n" "I: Copying back the debian/ tree...\n" "[...]\n" "'debian/patches/002_static-linking-dont-build-perf.patch' ->\n" "'/path/package/debian/patches/002_static-linking-dont-build-perf.patch'\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-do.xml:81 msgid "" "Start a source editing session and decide later not to copy back the debian/ " "tree" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-do.xml:84 #, no-wrap msgid "" "$ svn-do $SHELL\n" "[...]\n" "I: Running command: /bin/zsh\n" "% exit 1\n" "E: command exited with 1; not copying back the debian/ tree.\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-do.xml:90 msgid "edit a patch in a CDBS' simple-patchsys based package" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-do.xml:92 #, no-wrap msgid "" "$ svn-do cdbs-edit-patch 02_pmount.patch\n" "[...]\n" " " msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-do.xml:103 doc/svn-upgrade.xml:208 doc/uclean.xml:67 msgid "" "<citerefentry> " "<refentrytitle>/usr/share/doc/svn-buildpackage/</refentrytitle></citerefentry>" msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: doc/svn-inject.xml:38 msgid "&injectpackage;" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: doc/svn-inject.xml:45 msgid "" "<command>&injectpackage; [options] <package>.dsc <repository " "URL></command>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-inject.xml:53 msgid "" "<command>&injectpackage;</command> accepts the following options on the " "command-line:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:58 msgid "<option>-h</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:61 msgid "print the help menu" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:67 msgid "<option>-v</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:70 msgid "Make the command verbose" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:77 msgid "<option>-q</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:80 msgid "Hide less important messages" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:87 msgid "<option>-l</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:90 msgid "" "Layout type. 1 (default) means package/{trunk,tags,branches,...} scheme, 2 " "means the {trunk,tags,branches,...}/package scheme." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:94 doc/svn-inject.xml:132 msgid "Default: 1" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:100 msgid "<option>-t directory</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:104 msgid "" "Specify the directory where the .orig.tar.gz files are stored on the local " "machine." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:112 msgid "<option>-d</option> | <option>--do-like=directory</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:117 msgid "" "Looks at the working directory of some other package and uses its base URL, " "tarball storage directory and similar checkout target directory." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:127 msgid "<option>-c number</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:130 msgid "" "Checkout nothing (0), trunk directory (1) or everything (2) when the work is " "done." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:138 msgid "<option>-o</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:141 msgid "" "Only keep modified files under SVN control (including the debian/ " "directory), track only parts of upstream branch" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:150 msgid "<option>-O</option> | <option>--no-branches</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:154 msgid "" "Do not create the <filename>branches</filename> subdirectory at all. This " "works in a similar way to <option>-o</option> but all changes on upstream " "files (e.g. meta changes like updating the config.guess and config.sub " "files) are ignored and the upstream branch is not used." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:161 msgid "Default: use <filename>branches/</filename>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:167 msgid "<option>-s</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:170 msgid "" "By default, svn-inject used to create .svn/deb-layout after an inject " "operation if a checkout followed the inject. Since version 0.6.22 this " "behaviour is deprecated." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:174 msgid "With this parameter svn-inject will replicate the old behaviour." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:186 msgid "<option>-setprops</option> <option>-set-props</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:190 msgid "Set svn-bp:* props on the debian directory automatically." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:225 msgid "upgrade source package from a new upstream revision." msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: doc/svn-upgrade.xml:33 doc/svn-upgrade.xml:38 msgid "&upgradepackage;" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: doc/svn-upgrade.xml:44 msgid "<command>&upgradepackage; newsource [options]</command>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-upgrade.xml:51 msgid "" "<command>&upgradepackage;</command> modifies a Debian package source located " "in a Subversion repository, upgrading it to a new upstream release. The " "repository filesystem tree must be in the format created by " "<command>svn-inject</command>." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-upgrade.xml:60 msgid "" "<command>&upgradepackage;</command> accepts the following options on the " "command-line:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:67 msgid "<option>-V STRING</option> | <option>--version STRING</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:71 msgid "Forces a different upstream version string" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:78 msgid "<option>-c</option> | <option>--clean</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:82 msgid "" "Runs <option>make clean</option> and removes the " "<filename>debian/</filename> directory in the new source." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:91 msgid "<option>-P STRING</option> | <option>--packagename STRING</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:95 msgid "Forces a different package name" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:102 msgid "<option>-v</option> | <option>--verbose</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:113 msgid "<option>-r</option> | <option>--replay-conflicting</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:117 msgid "" "Extra cleanup run: replaces all conflicting files with upstream " "versions. Review of <command>svn status</command> output before doing that " "could make sense." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:126 msgid "<option>-N</option> | <option>--noautodch</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:130 msgid "Upgrade without making a new changelog entry." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:131 msgid "Default: Make the changelog entry." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:137 msgid "<option>-u</option> | <option>--uscan</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:141 msgid "Use uscan to download the new version." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:147 msgid "<option>--noninteractive</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:150 msgid "Turn off interactive mode." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:156 msgid "<option>--ignoreerrors</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:159 msgid "In noninteractive mode, ignore errors." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:165 msgid "<option>--ignored-files-action STRING</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:168 msgid "" "Make files that are ignored due to subversion ignore patterns to be " "'import'ed or 'skip'ed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:175 msgid "<option>-e</option> | <option>--auto-epoch</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:179 msgid "" "Automatically increase version epoch if the new upstream version is not " "greater than the current." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:186 msgid "<option>--debclean</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-upgrade.xml:189 msgid "Run debclean before merging the new upstream source." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><para> #: doc/svn-upgrade.xml:194 msgid "Tarballs must be compressed with gzip or bzip2." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-upgrade.xml:227 msgid "" "<citerefentry> <refentrytitle>svn-buildpackage</refentrytitle> " "<manvolnum>1</manvolnum> </citerefentry>" msgstr "" #. type: Content of: <refentry><refentryinfo><address> #: doc/uclean.xml:5 #, no-wrap msgid "" " <email>blade@debian.org</email>\n" " " msgstr "" #. type: Content of: <refentry><refnamediv><refname> #: doc/uclean.xml:34 doc/uclean.xml:38 msgid "&ucleanpackage;" msgstr "" #. type: Content of: <refentry><refnamediv><refpurpose> #: doc/uclean.xml:40 msgid "remove redundant files from upstream source packages" msgstr "" #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis> #: doc/uclean.xml:44 msgid "<command>&ucleanpackage; FILE [ NEWFILE... ]</command>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/uclean.xml:51 msgid "" "Uclean is an attempt to automate the "cleanup" procedure that can " "be needed for some package upstream tarballs. It will try to unpack it, " "remove cruft like CVS directories, .svn directories and forgotten object " "files. Then it will recreate the tarball, using the highest compression " "ratio. The resulting file is either stored under the same name (the old one " "is renamed) or as a new file if you specify it as the last argument." msgstr ""
Attachment:
pgpnxNXYi1_OX.pgp
Description: PGP signature