#: doc/HOWTO.xml:19 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: Attribute 'lang' of: <book> #: doc/HOWTO.xml:24 doc/overview.xml:24 msgid "en" 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-2010</year> <holder>Neil " "Williams</holder> </copyright> <date>Tue Aug 31 21:01:26 BST 2010</date>" msgstr "" #. type: Content of: <book><bookinfo><releaseinfo> #: doc/HOWTO.xml:36 doc/overview.xml:28 msgid "Release: 0.8.2" 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:962 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 (<command>dpkg-dev</command>, " "<command>devscripts</command>) 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 <filename>.diff.gz</filename> 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. <command>uupdate</command>. 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 on the " "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><itemizedlist><listitem><para> #: doc/HOWTO.xml:111 msgid "" "Keep Debian package under revision control, which means storing different " "versions of files in a Subversion repository." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:114 msgid "Allow easy walking back trough time using <command>svn</command> command." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:116 msgid "Easy retrieval of past versions." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:118 msgid "Keep track of upstream source versions and modified Debian versions." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:121 msgid "" "Easy installation of new upstream versions, merging the Debian changes into " "it when needed (similar to the <command>uupdate</command> program)." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:125 msgid "" "Automated package building in clean environment, notifying about uncommited " "changes." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:128 msgid "" "Create version tags when requested to do the final build and update " "changelog when needed." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:131 msgid "allow co-work of multiple Debian developers on the same project." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:134 msgid "" "Auto-configure the repository layout, making it easy to use by people " "without knowing much about Subversion usage (mostly you need only the " "<command>add</command>, <command>rm</command> and <command>mv</command> " "commands of <command>svn</command>)." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:139 msgid "" "Allow to store only the Debian specific changes in the repository and merge " "them into the upstream source in the build area (which nicely completes " "build systems like <command>dpatch</command> or <command>dbs</command>)." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:144 msgid "If wished, keep the upstream tarballs inside of the repository." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:150 msgid "Contents overview" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:151 msgid "" "There are currently three scripts provided by the " "<command>svn-buildpackage</command> package:" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:156 msgid "" "<command>svn-inject</command>: script used to insert an existing Debian " "package into a Subversion repository, creating the repository layout as " "needed." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:160 msgid "" "<command>svn-buildpackage</command>: exports the contents of the directory " "associated with the starting directory from the Subversion repository to the " "clean environment and build the package there." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:165 msgid "" "<command>svn-upgrade</command>: similar to <command>uupdate</command>, " "upgrades the trunk to a new upstream version, preserving and merging Debian " "specific changes." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:172 msgid "Popular repository layouts" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:173 msgid "" "There are different ways to store the packages in the repositories (or in " "multiple repositories at your choice). <command>svn-buildpackage</command> " "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:180 msgid "Directory hierarchy example." msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:182 #, 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:181 doc/HOWTO.xml:217 doc/HOWTO.xml:275 doc/HOWTO.xml:361 doc/HOWTO.xml:399 doc/HOWTO.xml:452 doc/HOWTO.xml:502 doc/HOWTO.xml:616 doc/HOWTO.xml:692 doc/HOWTO.xml:715 doc/HOWTO.xml:756 doc/HOWTO.xml:818 doc/HOWTO.xml:830 doc/HOWTO.xml:847 doc/HOWTO.xml:856 msgid "<placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:195 msgid "" "<filename>packageA</filename> above may be a typical upstream-based source " "package and a <filename>projectB</filename> 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:202 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:216 msgid "Example branch directory hierarchy" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:218 #, 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:253 msgid "" "<command>svn-buildpackage</command> also supports the second repository " "layout suggested in the Subversion Book (function/package) but " "<command>svn-inject</command> prefers the one documented above. Both " "<command>svn-buildpackage</command> and <command>svn-upgrade</command> " "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:259 msgid "" "In theory, you do not have to follow that examples and place the " "<filename>trunk</filename>, <filename>branches</filename> and " "<filename>tags</filename> directory on the locations you like more. But " "<command>svn-buildpackage</command> and other scripts won't locate the files " "automaticaly so you will need to edit the " "<filename>.svn/deb-layout</filename> 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:270 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:274 msgid "Example configuration" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:276 #, 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:286 msgid "Getting started" msgstr "" #. type: Content of: <book><chapter><para> #: doc/HOWTO.xml:287 msgid "" "Besides the packages that are installed by dependencies when you install " "<command>svn-buildpackage</command>, you may need <command>ssh</command> and " "the obligatory tool chain: <command>dpkg-dev</command>, " "<command>build-essential</command> and all the packages they pull into the " "system." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:295 msgid "Quick guide" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:297 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><listitem><para> #: doc/HOWTO.xml:302 msgid "svn co <svn://server/path/to/trunk> package" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:304 msgid "mkdir tarballs" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:306 msgid "cp dir-where-you-keep-the-source/package_version.orig.tar.gz tarballs/" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><para> #: doc/HOWTO.xml:308 msgid "" "NOTE: you need the upstream source tarballs, stored under a usual " "<command>dpkg-source</command>-compatible filename in " "<filename>tarballs/</filename>" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:311 msgid "cd <replaceable>package</replaceable>" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:313 msgid "svn-buildpackage -us -uc -rfakeroot" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:318 msgid "Basic svn usage" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:320 msgid "" "You need only few commands to start using <command>svn</command> with " "<command>svn-buildpackage</command> scripts. If you wish to learn more about " "it, read parts of 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><para> #: doc/HOWTO.xml:328 msgid "<command>add</command> -- put new files unto the revision control." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:330 msgid "<command>rm</command> -- remove the files from the repository." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:332 msgid "" "<command>mv</command> -- move files around, leting revision control system " "know about it." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:335 msgid "<command>commit</command> -- commit your changes to the repository." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:338 msgid "" "<command>resolved</command> -- tell <command>svn</command> that you have " "resolved a conflict." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:341 msgid "" "<command>diff</command> -- creates a \"<command>diff -u</command>\" between " "two versions, specified by file revision number or by date. See the " "<command>diff --help</command> output." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:345 msgid "" "<command>cat -r <replaceable>revision</replaceable></command> -- useful to " "browse in some previous revision of the file." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:350 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:355 msgid "Creating Subversion repository" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:357 msgid "The main Subversion repository is easily created with:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:360 msgid "Repository creation example." msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:362 #, no-wrap msgid "$ svnadmin create <replaceable>repo-directory</replaceable>\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:366 msgid "" "For our example, we choose the name <filename>svn-deb-repo</filename> and " "put it in <filename>/home/<replaceable>user</replaceable></filename>." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:369 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:377 msgid "Using by multiple developers" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:379 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 " "<command>svn</command> (like \"0022\")." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:388 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 \"<command>svnadmin recover</command>\"." msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:398 msgid "post-commit hook example" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:400 #, 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:417 msgid "SVN over SSH" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:419 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:425 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 " "specification from <filename>file://</filename> to " "<filename>svn+ssh://<replaceable>remoteusername</replaceable>@<replaceable>server-hostname</replaceable></filename> " "in all examples showed in this manual." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:432 msgid "" "Note that during <command>svn-buildpackage</command> 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 <command>ssh-agent</command> and <command>ssh-add</command> 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 " "<command>fsh</command>." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:443 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:451 msgid "Example of a custom ssh tunnel command." msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:453 #, 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:463 msgid "" "You can use the new defined tunnels in a similar ways as described above but " "replace <filename>svn+ssh</filename> with " "<filename>svn+<replaceable>tunnelname</replaceable></filename>, so the final " "URL looks like:" msgstr "" #. type: Content of: <book><chapter><sect1><programlisting> #: doc/HOWTO.xml:468 #, no-wrap msgid "svn+deb://svn.debian.org/svn/<replaceable>myproject</replaceable>/<replaceable>ourpackage</replaceable>/trunk\n" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:473 msgid "Anonymous access" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:475 msgid "" "You can allow outsiders to have anonymous (read-only) access using the " "<command>svnserve</command> program, as described in the Subversion " "documentation." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:479 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.org/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:490 msgid "Importing Debian packages" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:492 msgid "Importing from existing source package files" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:494 msgid "" "The <command>svn-inject</command> 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 " "<filename>.dsc</filename> file of your package and the base URL of the " "Subversion repository." msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:501 msgid "svn-inject example" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:503 #, 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:536 msgid "" "If you omit the URL, <command>svn-inject</command> 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:542 msgid "On-Build-Time merging" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:544 msgid "" "A special feature of <command>svn-buildpackage</command> 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:552 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 <command>svn-buildpackage</command> 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. <command>svn-buildpackage</command> " "will merge the trunk with upstream source on build time and " "<command>svn-upgrade</command> will only update the changed files in this " "case." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:564 msgid "" "To enable this feature during the initial import of the source package, " "simply add the <option>-o</option> switch to the " "<command>svn-inject</command> 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:579 #, no-wrap msgid "svn propset mergeWithUpstream 1 debian" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:572 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:584 #, no-wrap msgid "svn propdel mergeWithUpstream debian/" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:581 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:586 msgid "" "If you don't want to store the upstream sources of all your packages in the " "repository, you can pass the <option>--no-branches</option> 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:593 msgid "<command>dpkg-source</command> format 3.0 support" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:594 msgid "" "<command>svn-buildpackage</command> can build packages using source format " "3.0, including using " "<filename>../tarballs/foo_1.2.3-1.orig.tar.bz2</filename> in " "<emphasis>mergeWithUpstream</emphasis> 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:601 msgid "" "If <filename>debian/source/format</filename> exists and contains " "<emphasis>3.0 *</emphasis>, <command>svn-buildpackage</command> checks for a " "<filename>.orig.tar.bz2</filename> in the <filename>tarballs</filename> " "directory and uses that for the subsequent build." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><title> #: doc/HOWTO.xml:607 msgid "checking source formats with <command>dpkg-source</command>" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:608 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:617 #, 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><sect2><title> #: doc/HOWTO.xml:628 msgid "Preparing patches in <command>dpkg-source</command> 3.0 packages" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:629 msgid "" "When using <option>3.0 (quilt)</option> and " "<option>mergeWithUpstream</option>, use <command>svn-do</command> to unpack " "the upstream source and then simply edit or patch the files necessary for " "the first patch. Then get <command>dpkg-source</command> to prepare the " "patches for you:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><title> #: doc/HOWTO.xml:635 msgid "" "Letting <command>dpkg-source</command> prepare patches for <option>3.0 " "(quilt)</option>" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example> #: doc/HOWTO.xml:636 msgid "$ dpkg-buildpackage -uc -us -S" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:638 msgid "" "Now use a serviceable name for the patch and change that name in the " "<filename>series</filename> file, exit the <command>svn-do</command> " "subshell for the results to be copied back into " "<filename>trunk</filename>. Repeat for subsequent patches." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:647 msgid "Using <command>svn-buildpackage</command> with native packages" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:648 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:653 msgid "" "With a native package, the contents of the <filename>debian/</filename> " "directory are included in the source tarball (which uses a plain " "<filename>.tar.gz</filename> suffix not the " "<filename>.orig.tar.gz</filename> suffix) and no " "<filename>.diff.gz</filename> is generated." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:658 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:662 #, no-wrap msgid " foo (0.1.2-3)\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:664 msgid "A native package uses:" msgstr "" #. type: Content of: <book><chapter><sect1><programlisting> #: doc/HOWTO.xml:666 #, no-wrap msgid " foo (0.1.2)\n" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><title> #: doc/HOWTO.xml:669 msgid "Compiled native packages" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:670 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:682 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:690 msgid "Using a native tarball and mergeWithUpstream" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:691 msgid "Makefile.am" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><programlisting> #: doc/HOWTO.xml:693 #, 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:696 msgid "" "(Yes, this is an artefact of using mergeWithUpstream. The " "<filename>.orig.tar.gz</filename> is not actually used - the Debian version " "string overrides the merge property.)" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:700 msgid "SVN properties:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><programlisting> #: doc/HOWTO.xml:702 #, 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:707 msgid "Output of using mergeWithUpstream inside a native package" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:708 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:713 msgid "<command>svn-buildpackage</command> output:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:714 msgid "(using langupdate as the example package)" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><programlisting> #: doc/HOWTO.xml:716 #, 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:732 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 <option>--svn-ignore</option>." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><title> #: doc/HOWTO.xml:740 msgid "Native packages not using autotools" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><title> #: doc/HOWTO.xml:741 doc/HOWTO.xml:751 msgid "The useNativeDist property." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:742 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:752 msgid "" "<command>svn-buildpackage</command> uses this feature to include the POT " "file to aid translators. The custom <command>make</command> 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:757 #, 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:762 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. <command>cd</command> into the " "<filename>build-area</filename>, unpacking the <filename>.dsc</filename> " "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:772 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:809 msgid "Common tasks" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:812 msgid "Checkout" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:813 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:817 msgid "<command>svn-inject</command> initial checkout" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:819 #, no-wrap msgid "" "svn co " "<replaceable>protocol</replaceable>://<replaceable>repository-base-url</replaceable>/<replaceable>yourpackage</replaceable>\n" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:825 msgid "Building the package" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:826 msgid "Change to your <filename>trunk</filename> directory and run:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:829 msgid "<command>svn-buildpackage</command>" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:831 #, no-wrap msgid "$ svn-buildpackage -us -uc -rfakeroot\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:834 msgid "" "You may recognise the options above -- they are passed directly to the build " "command (<command>dpkg-buildpackage</command> 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><para> #: doc/HOWTO.xml:843 msgid "To build in a chroot using <command>pdebuild</command>, use:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:846 msgid "pdebuild example" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:848 #, no-wrap msgid "svn-buildpackage --svn-builder pdebuild\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:851 msgid "" "For frequently used commands, use an alias in your " "<filename>~/.bashrc</filename> file:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:855 msgid "Useful aliases" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:857 #, no-wrap msgid "" "alias svn-bp='svn-buildpackage -rfakeroot -D --svn-noautodch --svn-builder " "debuild'\n" "alias svn-bpi='svn-buildpackage -rfakeroot -D --svn-noautodch --svn-builder " "debuild --svn-ignore-new'\n" "alias svn-bpir='svn-buildpackage -us -uc -rfakeroot -D --svn-noautodch " "--svn-builder debuild --svn-ignore-new --svn-rm-prev-dir'\n" "alias svn-bpr='svn-buildpackage -us -uc -rfakeroot -D --svn-noautodch " "--svn-builder debuild --svn-rm-prev-dir'\n" "alias svn-pbp='svn-buildpackage --svn-noautodch --svn-builder pdebuild'\n" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:867 msgid "Working with source" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:868 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:879 msgid "Handling new upstream versions" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:881 msgid "Upgrading with new upstream version normally happens in two steps:" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:884 msgid "" "the <filename>current</filename> tree in the upstream branch is upgraded " "with the source from the new upstream package (the old version is kept in " "repository in " "<filename>branches/upstream/<replaceable>oldVersion</replaceable></filename>)." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:888 msgid "" "the version in <filename>trunk/</filename> becomes upgraded by merging the " "changes between the upstream versions into the <filename>trunk/</filename> " "directory." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:893 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 (<command>svn_load_dirs</command>, see Subversion book for " "documentation), the second step is done with the <command>merge</command> " "command of <command>svn</command>. 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:902 msgid "" "After running <command>svn-upgrade</command> some files may be in " "conflicting state. This is naturally 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:907 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:915 msgid "Finalizing the Revision" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:916 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:927 msgid "Command reference" msgstr "" #. type: Content of: <book><chapter><title> #: doc/HOWTO.xml:936 msgid "Further documentation" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:938 msgid "Various links" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:941 msgid "" "Subversion Homepage: <ulink " "url=\"http://subversion.tigris.org/\">http://subversion.tigris.org</ulink>" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:944 msgid "" "The Subversion Book: <ulink " "url=\"http://svnbook.red-bean.com/\">http://svnbook.red-bean.com/</ulink>" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:947 msgid "" "Subversion vs. CVS and others: <ulink " "url=\"http://better-scm.berlios.de/\">http://better-scm.berlios.de/</ulink>" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:954 msgid "Copyright" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:956 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:968 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>Tue Aug 31 21:01:26 BST 2010</date>" 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>[ " "<replaceable>OPTIONS</replaceable>... ] [ <replaceable>OPTIONS</replaceable> " "for <command>dpkg-buildpackage</command> ] </arg>" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:51 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:52 msgid "" "Builds a Debian package from a Subversion repository. The source code " "repository must be in the format created by <command>svn-inject</command>, " "and this script must be executed from the working directory " "(<filename>trunk/<replaceable>package</replaceable></filename>)." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:57 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 " "<filename>debian</filename> 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 <command>svn</command> property " "<emphasis>mergeWithUpstream</emphasis> on the <filename>debian</filename> " "directory" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-buildpackage.xml:67 #, no-wrap msgid "" "$ svn propset mergeWithUpstream 1 debian\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:69 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:89 #, no-wrap msgid "" "$ svn propset useNativeDist 1 debian\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:92 msgid "The default behaviour of <command>svn-buildpackage</command> is as follows:" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:95 msgid "" "Check the working directory, complain on uncommited files (also see " "<option>--svn-ignore-new</option>)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:98 msgid "" "Copy the orig tarball to the build area if necessary (also see " "<option>--svn-no-links</option>)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:101 msgid "" "Extract the tarball (in merge mode) or export the svn work directory to the " "build directory (also see below and <option>--svn-no-links</option>)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:105 msgid "" "Build with <command>dpkg-buildpackage</command> (also see " "<option>--svn-builder</option>, <option>--svn-lintian</option>, etc.)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:109 msgid "Create a changelog entry for the future version" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:112 doc/svn-inject.xml:52 doc/svn-upgrade.xml:58 msgid "OPTIONS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:113 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:119 msgid "<option>--svn-builder=COMMAND</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:122 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:131 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:137 msgid "Default: use <command>dpkg-buildpackage</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:142 msgid "<option>--svn-ignore-new</option> | <option>--svn-ignore</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:146 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:152 msgid "Default: Stop on conflicts or new/changed files." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:157 msgid "<option>--svn-dont-clean</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:160 msgid "Don't run debian/rules clean." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:161 msgid "Default: clean first" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:166 msgid "<option>--svn-no-links</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:169 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:175 msgid "Default: use links where possible." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:180 msgid "<option>--svn-dont-purge</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:183 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:185 msgid "Default: remove after successful build." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:191 msgid "<option>--svn-reuse</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:194 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:201 msgid "Default: build directory is removed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:206 msgid "<option>--svn-rm-prev-dir</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:209 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:214 msgid "Default: rename old directories with a '<option>obsolete</option>' suffix." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:220 msgid "<option>--svn-export</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:223 msgid "" "Just export the working directory and do necessary code merge operations, " "then exit." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:226 doc/svn-buildpackage.xml:237 doc/svn-buildpackage.xml:247 doc/svn-buildpackage.xml:258 doc/svn-buildpackage.xml:280 doc/svn-buildpackage.xml:292 doc/svn-buildpackage.xml:316 doc/svn-buildpackage.xml:327 doc/svn-buildpackage.xml:338 doc/svn-buildpackage.xml:373 doc/svn-buildpackage.xml:394 doc/svn-buildpackage.xml:404 doc/svn-buildpackage.xml:413 doc/svn-inject.xml:72 doc/svn-inject.xml:82 doc/svn-inject.xml:107 doc/svn-inject.xml:122 doc/svn-inject.xml:145 doc/svn-inject.xml:184 doc/svn-inject.xml:195 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:231 msgid "<option>--svn-tag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:234 msgid "Final build: Tag, export, build cleanly & make new changelog entry." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:242 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:246 msgid "Don't build the package, do only the tag copy." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:252 msgid "<option>--svn-retag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:255 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:263 msgid "<option>--svn-noautodch</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:266 msgid "No new Debian changelog entry is added automatically." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:268 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:275 msgid "<option>--svn-lintian</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:278 msgid "Run lintian on the resulting changes file when done." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:285 msgid "<option>--svn-move</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:288 msgid "" "When done, move the created files (as listed in " "<filename>.changes</filename>) to the parent directory, relative to the one " "where <command>svn-buildpackage</command> was started." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:297 msgid "<option>--svn-move-to=...</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:300 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:303 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:309 msgid "<option>--svn-pkg=packagename</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:312 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:321 msgid "<option>--svn-arch=ARCH</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:324 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:332 msgid "<option>--svn-override=var=value,anothervar=value</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:335 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:343 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:349 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:355 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:362 msgid "Defaults: Off." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:367 msgid "<option>--svn-noninteractive</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:370 msgid "" "With this parameter <command>svn-buildpackage</command> will not interact " "with the user." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:378 msgid "<option>--svn-savecfg</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:381 msgid "" "By default, <command>svn-buildpackage</command> used to create " "<filename>.svn/deb-layout</filename> 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:385 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:392 doc/svn-inject.xml:181 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:399 msgid "<option>--svn-download-orig</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:402 msgid "" "This option makes <command>svn-buildpackage</command> try to download the " "upstream tarball using <command>apt</command> and <command>uscan</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:409 msgid "<option>--svn-verbose</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:412 msgid "More verbose program output." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:418 msgid "<option>-h</option> | <option>--help</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:422 msgid "Show the help message." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:428 msgid "EXAMPLES" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:430 msgid "" "For more detailed information on how to use " "<command>svn-buildpackage</command>, 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:435 msgid "" "To start working with existing native Debian package from a " "<filename>*.dsc</filename> file, import it into the repository with command:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:439 #, 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:442 msgid "" "To start working with existing upstream package in Debian from a " "<filename>*.dsc</filename> file, import it into the repository with command:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:446 #, 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:449 msgid "" "Before building an upstream package, ensure the original source is " "available, e.g. if <command>uscan</command> is working:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:453 #, 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:458 msgid "" "To test building the package from Subversion repository, use command " "below. Refer to <citerefentry> " "<refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry> manual page for the <option>-us</option> etc. options:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:464 #, no-wrap msgid "" "svn-buildpackage --svn-lintian -us -uc -rfakeroot\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:467 msgid "" "To check that package build in a clean state, test it with <citerefentry> " "<refentrytitle>pbuilder</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry>:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:471 #, 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:476 msgid "" "When a new upstream release becomes available, commit all changes and have " "the working tree in clean state. Then use <citerefentry> " "<refentrytitle>svn-upgrade</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry> to import the new release:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:482 #, 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:487 msgid "CONFIGURATION FILE" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:488 msgid "" "<command>svn-buildpackage</command>'s behaviour can be modified using the " "file <filename>~/.svn-buildpackage.conf</filename>. Additional parts can be " "added in each package working directory using the file " "<filename>.svn/svn-buildpackage.conf</filename>. 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:498 #, 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:506 msgid "DIRECTORY LAYOUT HANDLING" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:507 msgid "" "By default, <command>svn-buildpackage</command> expects a configuration file " "with path/url declaration, <filename>.svn/deb-layout</filename>. The values " "there can be overridden with the <option>--svn-override</option> 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 " "<filename>debian/svn-deblayout</filename> will be imported during the " "initial configuration. Package maintainers can store this file in the " "repository to pass correct defaults to new " "<command>svn-buildpackage</command> users. The format is the same as in the " "file <filename>.svn/deb-layout</filename>. As an alternative to the " "<filename>debian/svn-deblayout</filename> file, maintainers can set " "Subversion properties for the <filename>debian/</filename> directory; any " "properties of <filename>debian/</filename> which have a name of the form " "<emphasis>svn-bp:<replaceable>PROP</replaceable></emphasis> will be the " "source of a <replaceable>PROP</replaceable> 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:529 msgid "ENVIRONMENT VARIABLES" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:530 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:536 msgid "PACKAGE" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:537 msgid "package" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:539 msgid "The source package name." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:543 msgid "SVN_BUILDPACKAGE" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:545 msgid "Version of <command>svn-buildpackage</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:549 msgid "TAG_VERSION" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:550 msgid "debian_version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:552 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:558 msgid "non_epoch_version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:560 msgid "Same as <option>debian_version</option> but without any epoch strings." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:564 msgid "upstream_version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:566 msgid "Same as debian_version but without Debian extensions" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:570 msgid "guess_loc" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:572 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:579 msgid "DIFFSRC" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:581 msgid "(experimental) shows the location of generated diff file" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:585 msgid "" "All the layout properties are exported to the environment, too. The " "following ones have meaning to <command>svn-buildpackage</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:589 msgid "buildArea" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:591 msgid "the location of build area directory" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:595 msgid "trunkUrl" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:597 msgid "the URL of the trunk directory for the current package." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:601 msgid "tagsUrl" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:603 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:607 msgid "origDir" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:609 msgid "the local directory where the orig tarball should be located." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:615 msgid "origUrl" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:617 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:623 msgid "" "The following variables are understood by " "<command>svn-buildpackage</command>:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:627 msgid "FORCETAG" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:629 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:635 msgid "FORCEEXPORT" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:637 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:643 msgid "DEBIAN_FRONTEND" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:645 msgid "" "If <option>DEBIAN_FRONTEND</option> is set to 'noninteractive' " "<option>--svn-noninteractive</option> is called silently." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:653 msgid "RECOMMENDATIONS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:654 msgid "Use shell aliases. Here are some examples for Bash:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-buildpackage.xml:656 #, 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:660 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:664 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 <command>svn-buildpackage</command> manual." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:672 msgid "" "Another way to get a remote link is using the Subversion DAV module (with " "SSL and Apache user authentication), see the " "<command>svn-buildpackage</command> HOWTO manual for details." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:678 doc/svn-do.xml:98 doc/svn-inject.xml:204 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:682 doc/svn-inject.xml:210 msgid "" "<citerefentry> " "<refentrytitle>/usr/share/doc/svn-buildpackage/</refentrytitle> " "</citerefentry>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:687 doc/svn-do.xml:107 doc/svn-inject.xml:216 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:692 doc/svn-do.xml:113 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:698 doc/svn-do.xml:116 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:703 doc/svn-do.xml:122 doc/svn-inject.xml:223 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:709 doc/svn-do.xml:125 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:714 doc/svn-do.xml:131 doc/svn-inject.xml:236 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:720 doc/svn-do.xml:134 doc/svn-inject.xml:240 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:725 doc/svn-do.xml:140 doc/svn-inject.xml:246 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:731 doc/svn-do.xml:143 doc/svn-inject.xml:250 doc/uclean.xml:107 msgid "Debian source package tools" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:736 doc/svn-do.xml:149 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:742 doc/svn-do.xml:152 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 "" "<command>svn-do</command> will use <command>svn-buildpackage</command> 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:59 msgid "Examples" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-do.xml:60 msgid "clean the tree (useful if this requires the full source tree)" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-do.xml:63 #, 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:71 msgid "use <command>quilt</command> to refresh a patch" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-do.xml:73 #, 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:82 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:85 #, 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:91 msgid "edit a patch in a CDBS' simple-patchsys based package" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-do.xml:93 #, 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:104 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; [<replaceable>options</replaceable>] " "<replaceable>package</replaceable>.dsc " "<replaceable>repository_URL</replaceable></command>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-inject.xml:54 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:59 msgid "<option>-h</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:62 msgid "print the help menu" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:68 msgid "<option>-v</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:71 msgid "Make the command output verbose" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:78 msgid "<option>-q</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:81 msgid "Hide less important messages" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:88 msgid "<option>-l</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:91 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:95 doc/svn-inject.xml:133 msgid "Default: 1" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:101 msgid "<option>-t directory</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:105 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:113 msgid "<option>-d</option> | <option>--do-like=directory</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:118 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:128 msgid "<option>-c number</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:131 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:139 msgid "<option>-o</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:142 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:151 msgid "<option>-O</option> | <option>--no-branches</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:155 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 <filename>config.guess</filename> " "and <filename>config.sub</filename> files) are ignored and the upstream " "branch is not used." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:164 msgid "Default: use <filename>branches/</filename>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:170 msgid "<option>-s</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:173 msgid "" "By default, <command>svn-inject</command> used to create " "<filename>.svn/deb-layout</filename> 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:178 msgid "" "With this parameter <command>svn-inject</command> will replicate the old " "behaviour." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:190 msgid "<option>-setprops</option> <option>-set-props</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:194 msgid "Set svn-bp:* props on the debian directory automatically." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:229 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><listitem><para> #: doc/svn-upgrade.xml:106 msgid "More verbose program output" 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 <command>uscan</command> 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 <command>debclean</command> 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 <command>gzip</command> or " "<command>bzip2</command>." 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 ""

# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2012-07-05 20:23+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=CHARSET\n" "Content-Transfer-Encoding: 8bit\n" #. type: Content of the dhfirstname entity #: doc/HOWTO.xml:8 doc/overview.xml:3 msgid "Neil" msgstr "" #. type: Content of the dhsurname entity #: doc/HOWTO.xml:9 doc/overview.xml:4 msgid "Williams" msgstr "" #. type: Content of the dhdate entity #: doc/HOWTO.xml:10 doc/overview.xml:5 msgid "May 2009" msgstr "" #. type: Content of the dhsection entity #: doc/HOWTO.xml:11 doc/overview.xml:6 msgid "1" msgstr "" #. type: Content of the dhemail entity #: doc/HOWTO.xml:12 doc/overview.xml:7 msgid "codehelp@debian.org" 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 "svn-buildpackage" 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/overview.xml:13 msgid "svn-upgrade" msgstr "" #. type: Content of: #: doc/HOWTO.xml:18 doc/overview.xml:14 doc/svn-inject.xml:33 msgid "svn-inject" msgstr "" #. type: Content of: #: doc/HOWTO.xml:19 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: Attribute 'lang' of: <book> #: doc/HOWTO.xml:24 doc/overview.xml:24 msgid "en" 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-2010</year> <holder>Neil " "Williams</holder> </copyright> <date>Tue Aug 31 21:01:26 BST 2010</date>" msgstr "" #. type: Content of: <book><bookinfo><releaseinfo> #: doc/HOWTO.xml:36 doc/overview.xml:28 msgid "Release: 0.8.2" 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:962 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 (<command>dpkg-dev</command>, " "<command>devscripts</command>) 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 <filename>.diff.gz</filename> 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. <command>uupdate</command>. 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 on the " "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><itemizedlist><listitem><para> #: doc/HOWTO.xml:111 msgid "" "Keep Debian package under revision control, which means storing different " "versions of files in a Subversion repository." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:114 msgid "Allow easy walking back trough time using <command>svn</command> command." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:116 msgid "Easy retrieval of past versions." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:118 msgid "Keep track of upstream source versions and modified Debian versions." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:121 msgid "" "Easy installation of new upstream versions, merging the Debian changes into " "it when needed (similar to the <command>uupdate</command> program)." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:125 msgid "" "Automated package building in clean environment, notifying about uncommited " "changes." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:128 msgid "" "Create version tags when requested to do the final build and update " "changelog when needed." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:131 msgid "allow co-work of multiple Debian developers on the same project." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:134 msgid "" "Auto-configure the repository layout, making it easy to use by people " "without knowing much about Subversion usage (mostly you need only the " "<command>add</command>, <command>rm</command> and <command>mv</command> " "commands of <command>svn</command>)." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:139 msgid "" "Allow to store only the Debian specific changes in the repository and merge " "them into the upstream source in the build area (which nicely completes " "build systems like <command>dpatch</command> or <command>dbs</command>)." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:144 msgid "If wished, keep the upstream tarballs inside of the repository." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:150 msgid "Contents overview" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:151 msgid "" "There are currently three scripts provided by the " "<command>svn-buildpackage</command> package:" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:156 msgid "" "<command>svn-inject</command>: script used to insert an existing Debian " "package into a Subversion repository, creating the repository layout as " "needed." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:160 msgid "" "<command>svn-buildpackage</command>: exports the contents of the directory " "associated with the starting directory from the Subversion repository to the " "clean environment and build the package there." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:165 msgid "" "<command>svn-upgrade</command>: similar to <command>uupdate</command>, " "upgrades the trunk to a new upstream version, preserving and merging Debian " "specific changes." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:172 msgid "Popular repository layouts" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:173 msgid "" "There are different ways to store the packages in the repositories (or in " "multiple repositories at your choice). <command>svn-buildpackage</command> " "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:180 msgid "Directory hierarchy example." msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:182 #, 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:181 doc/HOWTO.xml:217 doc/HOWTO.xml:275 doc/HOWTO.xml:361 doc/HOWTO.xml:399 doc/HOWTO.xml:452 doc/HOWTO.xml:502 doc/HOWTO.xml:616 doc/HOWTO.xml:692 doc/HOWTO.xml:715 doc/HOWTO.xml:756 doc/HOWTO.xml:818 doc/HOWTO.xml:830 doc/HOWTO.xml:847 doc/HOWTO.xml:856 msgid "<placeholder type=\"programlisting\" id=\"0\"/>" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:195 msgid "" "<filename>packageA</filename> above may be a typical upstream-based source " "package and a <filename>projectB</filename> 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:202 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:216 msgid "Example branch directory hierarchy" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:218 #, 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:253 msgid "" "<command>svn-buildpackage</command> also supports the second repository " "layout suggested in the Subversion Book (function/package) but " "<command>svn-inject</command> prefers the one documented above. Both " "<command>svn-buildpackage</command> and <command>svn-upgrade</command> " "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:259 msgid "" "In theory, you do not have to follow that examples and place the " "<filename>trunk</filename>, <filename>branches</filename> and " "<filename>tags</filename> directory on the locations you like more. But " "<command>svn-buildpackage</command> and other scripts won't locate the files " "automaticaly so you will need to edit the " "<filename>.svn/deb-layout</filename> 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:270 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:274 msgid "Example configuration" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:276 #, 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:286 msgid "Getting started" msgstr "" #. type: Content of: <book><chapter><para> #: doc/HOWTO.xml:287 msgid "" "Besides the packages that are installed by dependencies when you install " "<command>svn-buildpackage</command>, you may need <command>ssh</command> and " "the obligatory tool chain: <command>dpkg-dev</command>, " "<command>build-essential</command> and all the packages they pull into the " "system." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:295 msgid "Quick guide" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:297 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><listitem><para> #: doc/HOWTO.xml:302 msgid "svn co <svn://server/path/to/trunk> package" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:304 msgid "mkdir tarballs" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:306 msgid "cp dir-where-you-keep-the-source/package_version.orig.tar.gz tarballs/" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><para> #: doc/HOWTO.xml:308 msgid "" "NOTE: you need the upstream source tarballs, stored under a usual " "<command>dpkg-source</command>-compatible filename in " "<filename>tarballs/</filename>" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:311 msgid "cd <replaceable>package</replaceable>" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:313 msgid "svn-buildpackage -us -uc -rfakeroot" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:318 msgid "Basic svn usage" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:320 msgid "" "You need only few commands to start using <command>svn</command> with " "<command>svn-buildpackage</command> scripts. If you wish to learn more about " "it, read parts of 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><para> #: doc/HOWTO.xml:328 msgid "<command>add</command> -- put new files unto the revision control." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:330 msgid "<command>rm</command> -- remove the files from the repository." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:332 msgid "" "<command>mv</command> -- move files around, leting revision control system " "know about it." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:335 msgid "<command>commit</command> -- commit your changes to the repository." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:338 msgid "" "<command>resolved</command> -- tell <command>svn</command> that you have " "resolved a conflict." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:341 msgid "" "<command>diff</command> -- creates a \"<command>diff -u</command>\" between " "two versions, specified by file revision number or by date. See the " "<command>diff --help</command> output." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:345 msgid "" "<command>cat -r <replaceable>revision</replaceable></command> -- useful to " "browse in some previous revision of the file." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:350 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:355 msgid "Creating Subversion repository" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:357 msgid "The main Subversion repository is easily created with:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:360 msgid "Repository creation example." msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:362 #, no-wrap msgid "$ svnadmin create <replaceable>repo-directory</replaceable>\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:366 msgid "" "For our example, we choose the name <filename>svn-deb-repo</filename> and " "put it in <filename>/home/<replaceable>user</replaceable></filename>." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:369 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:377 msgid "Using by multiple developers" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:379 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 " "<command>svn</command> (like \"0022\")." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:388 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 \"<command>svnadmin recover</command>\"." msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:398 msgid "post-commit hook example" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:400 #, 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:417 msgid "SVN over SSH" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:419 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:425 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 " "specification from <filename>file://</filename> to " "<filename>svn+ssh://<replaceable>remoteusername</replaceable>@<replaceable>server-hostname</replaceable></filename> " "in all examples showed in this manual." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:432 msgid "" "Note that during <command>svn-buildpackage</command> 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 <command>ssh-agent</command> and <command>ssh-add</command> 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 " "<command>fsh</command>." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:443 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:451 msgid "Example of a custom ssh tunnel command." msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:453 #, 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:463 msgid "" "You can use the new defined tunnels in a similar ways as described above but " "replace <filename>svn+ssh</filename> with " "<filename>svn+<replaceable>tunnelname</replaceable></filename>, so the final " "URL looks like:" msgstr "" #. type: Content of: <book><chapter><sect1><programlisting> #: doc/HOWTO.xml:468 #, no-wrap msgid "svn+deb://svn.debian.org/svn/<replaceable>myproject</replaceable>/<replaceable>ourpackage</replaceable>/trunk\n" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:473 msgid "Anonymous access" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:475 msgid "" "You can allow outsiders to have anonymous (read-only) access using the " "<command>svnserve</command> program, as described in the Subversion " "documentation." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:479 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.org/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:490 msgid "Importing Debian packages" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:492 msgid "Importing from existing source package files" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:494 msgid "" "The <command>svn-inject</command> 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 " "<filename>.dsc</filename> file of your package and the base URL of the " "Subversion repository." msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:501 msgid "svn-inject example" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:503 #, 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:536 msgid "" "If you omit the URL, <command>svn-inject</command> 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:542 msgid "On-Build-Time merging" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:544 msgid "" "A special feature of <command>svn-buildpackage</command> 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:552 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 <command>svn-buildpackage</command> 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. <command>svn-buildpackage</command> " "will merge the trunk with upstream source on build time and " "<command>svn-upgrade</command> will only update the changed files in this " "case." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:564 msgid "" "To enable this feature during the initial import of the source package, " "simply add the <option>-o</option> switch to the " "<command>svn-inject</command> 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:579 #, no-wrap msgid "svn propset mergeWithUpstream 1 debian" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:572 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:584 #, no-wrap msgid "svn propdel mergeWithUpstream debian/" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:581 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:586 msgid "" "If you don't want to store the upstream sources of all your packages in the " "repository, you can pass the <option>--no-branches</option> 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:593 msgid "<command>dpkg-source</command> format 3.0 support" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:594 msgid "" "<command>svn-buildpackage</command> can build packages using source format " "3.0, including using " "<filename>../tarballs/foo_1.2.3-1.orig.tar.bz2</filename> in " "<emphasis>mergeWithUpstream</emphasis> 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:601 msgid "" "If <filename>debian/source/format</filename> exists and contains " "<emphasis>3.0 *</emphasis>, <command>svn-buildpackage</command> checks for a " "<filename>.orig.tar.bz2</filename> in the <filename>tarballs</filename> " "directory and uses that for the subsequent build." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><title> #: doc/HOWTO.xml:607 msgid "checking source formats with <command>dpkg-source</command>" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:608 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:617 #, 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><sect2><title> #: doc/HOWTO.xml:628 msgid "Preparing patches in <command>dpkg-source</command> 3.0 packages" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:629 msgid "" "When using <option>3.0 (quilt)</option> and " "<option>mergeWithUpstream</option>, use <command>svn-do</command> to unpack " "the upstream source and then simply edit or patch the files necessary for " "the first patch. Then get <command>dpkg-source</command> to prepare the " "patches for you:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><title> #: doc/HOWTO.xml:635 msgid "" "Letting <command>dpkg-source</command> prepare patches for <option>3.0 " "(quilt)</option>" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example> #: doc/HOWTO.xml:636 msgid "$ dpkg-buildpackage -uc -us -S" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:638 msgid "" "Now use a serviceable name for the patch and change that name in the " "<filename>series</filename> file, exit the <command>svn-do</command> " "subshell for the results to be copied back into " "<filename>trunk</filename>. Repeat for subsequent patches." msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:647 msgid "Using <command>svn-buildpackage</command> with native packages" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:648 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:653 msgid "" "With a native package, the contents of the <filename>debian/</filename> " "directory are included in the source tarball (which uses a plain " "<filename>.tar.gz</filename> suffix not the " "<filename>.orig.tar.gz</filename> suffix) and no " "<filename>.diff.gz</filename> is generated." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:658 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:662 #, no-wrap msgid " foo (0.1.2-3)\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:664 msgid "A native package uses:" msgstr "" #. type: Content of: <book><chapter><sect1><programlisting> #: doc/HOWTO.xml:666 #, no-wrap msgid " foo (0.1.2)\n" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><title> #: doc/HOWTO.xml:669 msgid "Compiled native packages" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:670 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:682 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:690 msgid "Using a native tarball and mergeWithUpstream" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:691 msgid "Makefile.am" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><programlisting> #: doc/HOWTO.xml:693 #, 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:696 msgid "" "(Yes, this is an artefact of using mergeWithUpstream. The " "<filename>.orig.tar.gz</filename> is not actually used - the Debian version " "string overrides the merge property.)" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:700 msgid "SVN properties:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><programlisting> #: doc/HOWTO.xml:702 #, 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:707 msgid "Output of using mergeWithUpstream inside a native package" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:708 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:713 msgid "<command>svn-buildpackage</command> output:" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><para> #: doc/HOWTO.xml:714 msgid "(using langupdate as the example package)" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><programlisting> #: doc/HOWTO.xml:716 #, 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:732 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 <option>--svn-ignore</option>." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><title> #: doc/HOWTO.xml:740 msgid "Native packages not using autotools" msgstr "" #. type: Content of: <book><chapter><sect1><sect2><example><title> #: doc/HOWTO.xml:741 doc/HOWTO.xml:751 msgid "The useNativeDist property." msgstr "" #. type: Content of: <book><chapter><sect1><sect2><para> #: doc/HOWTO.xml:742 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:752 msgid "" "<command>svn-buildpackage</command> uses this feature to include the POT " "file to aid translators. The custom <command>make</command> 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:757 #, 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:762 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. <command>cd</command> into the " "<filename>build-area</filename>, unpacking the <filename>.dsc</filename> " "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:772 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:809 msgid "Common tasks" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:812 msgid "Checkout" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:813 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:817 msgid "<command>svn-inject</command> initial checkout" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:819 #, no-wrap msgid "" "svn co " "<replaceable>protocol</replaceable>://<replaceable>repository-base-url</replaceable>/<replaceable>yourpackage</replaceable>\n" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:825 msgid "Building the package" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:826 msgid "Change to your <filename>trunk</filename> directory and run:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:829 msgid "<command>svn-buildpackage</command>" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:831 #, no-wrap msgid "$ svn-buildpackage -us -uc -rfakeroot\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:834 msgid "" "You may recognise the options above -- they are passed directly to the build " "command (<command>dpkg-buildpackage</command> 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><para> #: doc/HOWTO.xml:843 msgid "To build in a chroot using <command>pdebuild</command>, use:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:846 msgid "pdebuild example" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:848 #, no-wrap msgid "svn-buildpackage --svn-builder pdebuild\n" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:851 msgid "" "For frequently used commands, use an alias in your " "<filename>~/.bashrc</filename> file:" msgstr "" #. type: Content of: <book><chapter><sect1><example><title> #: doc/HOWTO.xml:855 msgid "Useful aliases" msgstr "" #. type: Content of: <book><chapter><sect1><example><programlisting> #: doc/HOWTO.xml:857 #, no-wrap msgid "" "alias svn-bp='svn-buildpackage -rfakeroot -D --svn-noautodch --svn-builder " "debuild'\n" "alias svn-bpi='svn-buildpackage -rfakeroot -D --svn-noautodch --svn-builder " "debuild --svn-ignore-new'\n" "alias svn-bpir='svn-buildpackage -us -uc -rfakeroot -D --svn-noautodch " "--svn-builder debuild --svn-ignore-new --svn-rm-prev-dir'\n" "alias svn-bpr='svn-buildpackage -us -uc -rfakeroot -D --svn-noautodch " "--svn-builder debuild --svn-rm-prev-dir'\n" "alias svn-pbp='svn-buildpackage --svn-noautodch --svn-builder pdebuild'\n" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:867 msgid "Working with source" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:868 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:879 msgid "Handling new upstream versions" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:881 msgid "Upgrading with new upstream version normally happens in two steps:" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:884 msgid "" "the <filename>current</filename> tree in the upstream branch is upgraded " "with the source from the new upstream package (the old version is kept in " "repository in " "<filename>branches/upstream/<replaceable>oldVersion</replaceable></filename>)." msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:888 msgid "" "the version in <filename>trunk/</filename> becomes upgraded by merging the " "changes between the upstream versions into the <filename>trunk/</filename> " "directory." msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:893 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 (<command>svn_load_dirs</command>, see Subversion book for " "documentation), the second step is done with the <command>merge</command> " "command of <command>svn</command>. 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:902 msgid "" "After running <command>svn-upgrade</command> some files may be in " "conflicting state. This is naturally 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:907 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:915 msgid "Finalizing the Revision" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:916 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:927 msgid "Command reference" msgstr "" #. type: Content of: <book><chapter><title> #: doc/HOWTO.xml:936 msgid "Further documentation" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:938 msgid "Various links" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:941 msgid "" "Subversion Homepage: <ulink " "url=\"http://subversion.tigris.org/\">http://subversion.tigris.org</ulink>" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:944 msgid "" "The Subversion Book: <ulink " "url=\"http://svnbook.red-bean.com/\">http://svnbook.red-bean.com/</ulink>" msgstr "" #. type: Content of: <book><chapter><sect1><itemizedlist><listitem><para> #: doc/HOWTO.xml:947 msgid "" "Subversion vs. CVS and others: <ulink " "url=\"http://better-scm.berlios.de/\">http://better-scm.berlios.de/</ulink>" msgstr "" #. type: Content of: <book><chapter><sect1><title> #: doc/HOWTO.xml:954 msgid "Copyright" msgstr "" #. type: Content of: <book><chapter><sect1><para> #: doc/HOWTO.xml:956 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:968 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>Tue Aug 31 21:01:26 BST 2010</date>" 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>[ " "<replaceable>OPTIONS</replaceable>... ] [ <replaceable>OPTIONS</replaceable> " "for <command>dpkg-buildpackage</command> ] </arg>" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:51 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:52 msgid "" "Builds a Debian package from a Subversion repository. The source code " "repository must be in the format created by <command>svn-inject</command>, " "and this script must be executed from the working directory " "(<filename>trunk/<replaceable>package</replaceable></filename>)." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:57 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 " "<filename>debian</filename> 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 <command>svn</command> property " "<emphasis>mergeWithUpstream</emphasis> on the <filename>debian</filename> " "directory" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-buildpackage.xml:67 #, no-wrap msgid "" "$ svn propset mergeWithUpstream 1 debian\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:69 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:89 #, no-wrap msgid "" "$ svn propset useNativeDist 1 debian\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:92 msgid "The default behaviour of <command>svn-buildpackage</command> is as follows:" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:95 msgid "" "Check the working directory, complain on uncommited files (also see " "<option>--svn-ignore-new</option>)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:98 msgid "" "Copy the orig tarball to the build area if necessary (also see " "<option>--svn-no-links</option>)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:101 msgid "" "Extract the tarball (in merge mode) or export the svn work directory to the " "build directory (also see below and <option>--svn-no-links</option>)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:105 msgid "" "Build with <command>dpkg-buildpackage</command> (also see " "<option>--svn-builder</option>, <option>--svn-lintian</option>, etc.)" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:109 msgid "Create a changelog entry for the future version" msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:112 doc/svn-inject.xml:52 doc/svn-upgrade.xml:58 msgid "OPTIONS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:113 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:119 msgid "<option>--svn-builder=COMMAND</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:122 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:131 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:137 msgid "Default: use <command>dpkg-buildpackage</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:142 msgid "<option>--svn-ignore-new</option> | <option>--svn-ignore</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:146 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:152 msgid "Default: Stop on conflicts or new/changed files." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:157 msgid "<option>--svn-dont-clean</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:160 msgid "Don't run debian/rules clean." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:161 msgid "Default: clean first" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:166 msgid "<option>--svn-no-links</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:169 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:175 msgid "Default: use links where possible." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:180 msgid "<option>--svn-dont-purge</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:183 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:185 msgid "Default: remove after successful build." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:191 msgid "<option>--svn-reuse</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:194 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:201 msgid "Default: build directory is removed." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:206 msgid "<option>--svn-rm-prev-dir</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:209 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:214 msgid "Default: rename old directories with a '<option>obsolete</option>' suffix." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:220 msgid "<option>--svn-export</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:223 msgid "" "Just export the working directory and do necessary code merge operations, " "then exit." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:226 doc/svn-buildpackage.xml:237 doc/svn-buildpackage.xml:247 doc/svn-buildpackage.xml:258 doc/svn-buildpackage.xml:280 doc/svn-buildpackage.xml:292 doc/svn-buildpackage.xml:316 doc/svn-buildpackage.xml:327 doc/svn-buildpackage.xml:338 doc/svn-buildpackage.xml:373 doc/svn-buildpackage.xml:394 doc/svn-buildpackage.xml:404 doc/svn-buildpackage.xml:413 doc/svn-inject.xml:72 doc/svn-inject.xml:82 doc/svn-inject.xml:107 doc/svn-inject.xml:122 doc/svn-inject.xml:145 doc/svn-inject.xml:184 doc/svn-inject.xml:195 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:231 msgid "<option>--svn-tag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:234 msgid "Final build: Tag, export, build cleanly & make new changelog entry." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:242 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:246 msgid "Don't build the package, do only the tag copy." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:252 msgid "<option>--svn-retag</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:255 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:263 msgid "<option>--svn-noautodch</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:266 msgid "No new Debian changelog entry is added automatically." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:268 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:275 msgid "<option>--svn-lintian</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:278 msgid "Run lintian on the resulting changes file when done." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:285 msgid "<option>--svn-move</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:288 msgid "" "When done, move the created files (as listed in " "<filename>.changes</filename>) to the parent directory, relative to the one " "where <command>svn-buildpackage</command> was started." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:297 msgid "<option>--svn-move-to=...</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:300 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:303 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:309 msgid "<option>--svn-pkg=packagename</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:312 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:321 msgid "<option>--svn-arch=ARCH</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:324 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:332 msgid "<option>--svn-override=var=value,anothervar=value</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:335 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:343 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:349 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:355 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:362 msgid "Defaults: Off." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:367 msgid "<option>--svn-noninteractive</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:370 msgid "" "With this parameter <command>svn-buildpackage</command> will not interact " "with the user." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:378 msgid "<option>--svn-savecfg</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:381 msgid "" "By default, <command>svn-buildpackage</command> used to create " "<filename>.svn/deb-layout</filename> 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:385 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:392 doc/svn-inject.xml:181 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:399 msgid "<option>--svn-download-orig</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:402 msgid "" "This option makes <command>svn-buildpackage</command> try to download the " "upstream tarball using <command>apt</command> and <command>uscan</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:409 msgid "<option>--svn-verbose</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:412 msgid "More verbose program output." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:418 msgid "<option>-h</option> | <option>--help</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:422 msgid "Show the help message." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:428 msgid "EXAMPLES" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:430 msgid "" "For more detailed information on how to use " "<command>svn-buildpackage</command>, 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:435 msgid "" "To start working with existing native Debian package from a " "<filename>*.dsc</filename> file, import it into the repository with command:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:439 #, 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:442 msgid "" "To start working with existing upstream package in Debian from a " "<filename>*.dsc</filename> file, import it into the repository with command:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:446 #, 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:449 msgid "" "Before building an upstream package, ensure the original source is " "available, e.g. if <command>uscan</command> is working:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:453 #, 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:458 msgid "" "To test building the package from Subversion repository, use command " "below. Refer to <citerefentry> " "<refentrytitle>dpkg-buildpackage</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry> manual page for the <option>-us</option> etc. options:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:464 #, no-wrap msgid "" "svn-buildpackage --svn-lintian -us -uc -rfakeroot\n" " " msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:467 msgid "" "To check that package build in a clean state, test it with <citerefentry> " "<refentrytitle>pbuilder</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry>:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:471 #, 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:476 msgid "" "When a new upstream release becomes available, commit all changes and have " "the working tree in clean state. Then use <citerefentry> " "<refentrytitle>svn-upgrade</refentrytitle> <manvolnum>1</manvolnum> " "</citerefentry> to import the new release:" msgstr "" #. type: Content of: <refentry><refsect1><screen> #: doc/svn-buildpackage.xml:482 #, 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:487 msgid "CONFIGURATION FILE" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:488 msgid "" "<command>svn-buildpackage</command>'s behaviour can be modified using the " "file <filename>~/.svn-buildpackage.conf</filename>. Additional parts can be " "added in each package working directory using the file " "<filename>.svn/svn-buildpackage.conf</filename>. 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:498 #, 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:506 msgid "DIRECTORY LAYOUT HANDLING" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:507 msgid "" "By default, <command>svn-buildpackage</command> expects a configuration file " "with path/url declaration, <filename>.svn/deb-layout</filename>. The values " "there can be overridden with the <option>--svn-override</option> 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 " "<filename>debian/svn-deblayout</filename> will be imported during the " "initial configuration. Package maintainers can store this file in the " "repository to pass correct defaults to new " "<command>svn-buildpackage</command> users. The format is the same as in the " "file <filename>.svn/deb-layout</filename>. As an alternative to the " "<filename>debian/svn-deblayout</filename> file, maintainers can set " "Subversion properties for the <filename>debian/</filename> directory; any " "properties of <filename>debian/</filename> which have a name of the form " "<emphasis>svn-bp:<replaceable>PROP</replaceable></emphasis> will be the " "source of a <replaceable>PROP</replaceable> 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:529 msgid "ENVIRONMENT VARIABLES" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:530 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:536 msgid "PACKAGE" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:537 msgid "package" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:539 msgid "The source package name." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:543 msgid "SVN_BUILDPACKAGE" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:545 msgid "Version of <command>svn-buildpackage</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:549 msgid "TAG_VERSION" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:550 msgid "debian_version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:552 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:558 msgid "non_epoch_version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:560 msgid "Same as <option>debian_version</option> but without any epoch strings." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:564 msgid "upstream_version" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:566 msgid "Same as debian_version but without Debian extensions" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:570 msgid "guess_loc" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:572 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:579 msgid "DIFFSRC" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:581 msgid "(experimental) shows the location of generated diff file" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:585 msgid "" "All the layout properties are exported to the environment, too. The " "following ones have meaning to <command>svn-buildpackage</command>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:589 msgid "buildArea" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:591 msgid "the location of build area directory" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:595 msgid "trunkUrl" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:597 msgid "the URL of the trunk directory for the current package." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:601 msgid "tagsUrl" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:603 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:607 msgid "origDir" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:609 msgid "the local directory where the orig tarball should be located." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:615 msgid "origUrl" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:617 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:623 msgid "" "The following variables are understood by " "<command>svn-buildpackage</command>:" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:627 msgid "FORCETAG" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:629 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:635 msgid "FORCEEXPORT" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:637 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:643 msgid "DEBIAN_FRONTEND" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:645 msgid "" "If <option>DEBIAN_FRONTEND</option> is set to 'noninteractive' " "<option>--svn-noninteractive</option> is called silently." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:653 msgid "RECOMMENDATIONS" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:654 msgid "Use shell aliases. Here are some examples for Bash:" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-buildpackage.xml:656 #, 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:660 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:664 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 <command>svn-buildpackage</command> manual." msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-buildpackage.xml:672 msgid "" "Another way to get a remote link is using the Subversion DAV module (with " "SSL and Apache user authentication), see the " "<command>svn-buildpackage</command> HOWTO manual for details." msgstr "" #. type: Content of: <refentry><refsect1><title> #: doc/svn-buildpackage.xml:678 doc/svn-do.xml:98 doc/svn-inject.xml:204 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:682 doc/svn-inject.xml:210 msgid "" "<citerefentry> " "<refentrytitle>/usr/share/doc/svn-buildpackage/</refentrytitle> " "</citerefentry>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-buildpackage.xml:687 doc/svn-do.xml:107 doc/svn-inject.xml:216 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:692 doc/svn-do.xml:113 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:698 doc/svn-do.xml:116 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:703 doc/svn-do.xml:122 doc/svn-inject.xml:223 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:709 doc/svn-do.xml:125 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:714 doc/svn-do.xml:131 doc/svn-inject.xml:236 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:720 doc/svn-do.xml:134 doc/svn-inject.xml:240 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:725 doc/svn-do.xml:140 doc/svn-inject.xml:246 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:731 doc/svn-do.xml:143 doc/svn-inject.xml:250 doc/uclean.xml:107 msgid "Debian source package tools" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-buildpackage.xml:736 doc/svn-do.xml:149 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:742 doc/svn-do.xml:152 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 "" "<command>svn-do</command> will use <command>svn-buildpackage</command> 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:59 msgid "Examples" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-do.xml:60 msgid "clean the tree (useful if this requires the full source tree)" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-do.xml:63 #, 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:71 msgid "use <command>quilt</command> to refresh a patch" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-do.xml:73 #, 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:82 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:85 #, 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:91 msgid "edit a patch in a CDBS' simple-patchsys based package" msgstr "" #. type: Content of: <refentry><refsect1><programlisting> #: doc/svn-do.xml:93 #, 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:104 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; [<replaceable>options</replaceable>] " "<replaceable>package</replaceable>.dsc " "<replaceable>repository_URL</replaceable></command>" msgstr "" #. type: Content of: <refentry><refsect1><para> #: doc/svn-inject.xml:54 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:59 msgid "<option>-h</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:62 msgid "print the help menu" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:68 msgid "<option>-v</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:71 msgid "Make the command output verbose" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:78 msgid "<option>-q</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:81 msgid "Hide less important messages" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:88 msgid "<option>-l</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:91 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:95 doc/svn-inject.xml:133 msgid "Default: 1" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:101 msgid "<option>-t directory</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:105 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:113 msgid "<option>-d</option> | <option>--do-like=directory</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:118 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:128 msgid "<option>-c number</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:131 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:139 msgid "<option>-o</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:142 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:151 msgid "<option>-O</option> | <option>--no-branches</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:155 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 <filename>config.guess</filename> " "and <filename>config.sub</filename> files) are ignored and the upstream " "branch is not used." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:164 msgid "Default: use <filename>branches/</filename>." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:170 msgid "<option>-s</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:173 msgid "" "By default, <command>svn-inject</command> used to create " "<filename>.svn/deb-layout</filename> 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:178 msgid "" "With this parameter <command>svn-inject</command> will replicate the old " "behaviour." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term> #: doc/svn-inject.xml:190 msgid "<option>-setprops</option> <option>-set-props</option>" msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:194 msgid "Set svn-bp:* props on the debian directory automatically." msgstr "" #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para> #: doc/svn-inject.xml:229 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><listitem><para> #: doc/svn-upgrade.xml:106 msgid "More verbose program output" 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 <command>uscan</command> 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 <command>debclean</command> 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 <command>gzip</command> or " "<command>bzip2</command>." 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 ""