r77784 - /website/git.pod

[dmn at users.alioth.debian.org]

Author: dmn
Date: Sat Jul 23 20:33:22 2011
New Revision: 77784

URL: http://svn.debian.org/wsvn/?sc=1&rev=77784
Log:
a (not particularly good) attempt to streamline the text

Modified:
    website/git.pod

Modified: website/git.pod
URL: http://svn.debian.org/wsvn/website/git.pod?rev=77784&op=diff
==============================================================================
--- website/git.pod (original)
+++ website/git.pod Sat Jul 23 20:33:22 2011
@@ -26,7 +26,15 @@
 
 =head1 Packaging walkthrough
 
-=head2 starting the package
+=head2 starting the package, all-in-one
+
+Since version 0.73 B<dh-make-perl> has the C<--vcs git> option, which will make
+it populate a Git repository with upstream and pristine-tar branches, and will
+setip an C<origin> remote pointing to alioth, etc.
+
+    $ dh-make-perl [option…] --cpan Foo --vcs git
+
+=head2 starting the package, adding Git stuff manually
 
 B<git-import-dsc> is used to introduce the source of a package into the Git
 repository. It operates on the C<.dsc> file and the associated source files. It
@@ -67,7 +75,7 @@
     checkout = git clone ssh://git.debian.org/git/pkg-perl/meta.git git
 
 Note 1: The path has to be under the place of the F<.mrconfig> file, otherwise
-it won't work; i.e. [/tmp/foobar] in F<~/.mrconfig>.
+it won't work; i.e. [/tmp/foobar] in F<~/.mrconfig> is a bad idea.
 
 Note 2: The last part of the path has to be the same as the target of the clone
 command (in this example: 'git').
@@ -102,6 +110,18 @@
 
 =head2 pushing to git.debian.org
 
+=head3 the easy way
+
+THe first time:
+    $ ../../setup-repository
+
+This will ssh to alioth, run B<setup-repository> there with the right
+arguments, then push the local repository over there.
+
+From then on, gust use B<git push --all && git push --tags> as usual.
+
+=head3 the long story
+
 Before pushing to git.debian.org for the first time, an empty repository needs
 to be created there. To do this, use the B<setup-repository> script available
 in the C</git/pkg-perl> directory. Run it similarly to: