r30304 - in /website/howto: .htaccess missingupstream.pod

gregoa at users.alioth.debian.org gregoa at users.alioth.debian.org
Fri Jan 30 16:03:19 UTC 2009


Author: gregoa
Date: Fri Jan 30 16:03:16 2009
New Revision: 30304

URL: http://svn.debian.org/wsvn/?sc=1&rev=30304
Log:
first draft of new 'How to fix missing upstream directories in subversion'

Added:
    website/howto/missingupstream.pod   (with props)
Modified:
    website/howto/.htaccess

Modified: website/howto/.htaccess
URL: http://svn.debian.org/wsvn/website/howto/.htaccess?rev=30304&op=diff
==============================================================================
--- website/howto/.htaccess (original)
+++ website/howto/.htaccess Fri Jan 30 16:03:16 2009
@@ -8,3 +8,4 @@
 AddDescription "Debian Perl Group adoption how-to" adopt.html
 AddDescription "Quilt for Debian maintainers"  quilt.html
 AddDescription "How to get a CPAN module into Debian" RFP.html
+AddDescription "Add missing upstream tarballs to the repository" missingupstream.html

Added: website/howto/missingupstream.pod
URL: http://svn.debian.org/wsvn/website/howto/missingupstream.pod?rev=30304&op=file
==============================================================================
--- website/howto/missingupstream.pod (added)
+++ website/howto/missingupstream.pod Fri Jan 30 16:03:16 2009
@@ -1,0 +1,82 @@
+=head1 NAME
+
+missingupstream - How to fix missing upstream directories in subversion
+
+=head1 INTRODUCTION
+
+Sometime it happens that C<svn-upgrade> dies because
+C<svn+ssh://svn.debian.org/svn/pkg-perl/branches/upstream/PACKAGE/UPSTREAMVERSION>
+or
+C<svn+ssh://svn.debian.org/svn/pkg-perl/branches/upstream/PACKAGE> as a
+whole is missing -- however that can happen with C<svn-inject> ...
+
+This mini HOWTO shows an easy way to load the required files into the
+correct place.
+
+=head1 PREPARATION
+
+A nice tool for loading a tarball into svn is F<svn_load_dirs>. It doesn't
+exist in Debian anymore (maybe because it doesn't have a copyright/license
+statement in the code, and that's why I'm just pointing to the URL instead
+of putting it into our repository) but it's still available on the web: Both
+the script and a README can be found at
+L<http://svn.collab.net/repos/svn/trunk/contrib/client-side/svn_load_dirs/>.
+
+So just grab
+L<http://svn.collab.net/repos/svn/trunk/contrib/client-side/svn_load_dirs/svn_load_dirs.pl.in>,
+save it as F<svn_load_dirs> somewhere in your C<$PATH> and replace
+C<@SVN_BINDIR> in line 26 with C</usr/bin>.
+
+=head1 USAGE
+
+Obviously you need the tarball you want to get into svn. Since the
+repository should mirror what's in the archive getting the source package is
+usually the way to go:
+
+   apt-get source -d PACKAGE[=DEBIANVERSION]
+
+Unpack the tarball:
+
+   tar xzf PACKAGE_UPSTREAMVERSION.orig.tar.gz
+
+And then use C<svn_load_dirs>:
+
+   svn_load_dirs svn+ssh://svn.debian.org/svn/pkg-perl/ \
+   branches/upstream/PACKAGE/current \
+   -t branches/upstream/PACKAGE/UPSTREAMVERSION \
+   UNPACKED-TARBALL-DIR
+
+This creates (if necessary) C<branches/upstream/PACKAGE> and
+C<branches/upstream/PACKAGE/current>, loads the contents of
+C<UNPACKED-TARBALL-DIR> into C<branches/upstream/PACKAGE/current> and tags
+C<branches/upstream/PACKAGE/current> as
+C<branches/upstream/PACKAGE/UPSTREAMVERSION>.
+
+Now C<svn-upgrade> should work as expected.
+
+(Maybe someone wants to write a nice wrapper script around these 3
+commands?)
+
+=head1 VERSION
+
+$Id$
+
+=head1 AUTHORS
+
+=over
+
+=item * gregor herrmann <gregoa at debian.org>
+
+=back
+
+=head1 COPYRIGHT/LICENSE
+
+Copyright 2009 gregor herrmann <gregoa at debian.org>.  All rights reserved.
+
+This document is free software; you may redistribute it and/or modify it
+under the same terms as Perl itself
+
+Perl is distributed under your choice of the GNU General Public License or the
+Artistic License.  On Debian GNU/Linux systems, the complete text of the GNU
+General Public License can be found in F</usr/share/common-licenses/GPL> and
+the Artistic License in F</usr/share/common-licenses/Artistic>.

Propchange: website/howto/missingupstream.pod
------------------------------------------------------------------------------
    svn:keywords = Id




More information about the Pkg-perl-cvs-commits mailing list