Package: git-dpm
Version: 0.1.2-1
Severity: wishlist

Although it may be obvious for you, it is not so easy for a new comer to
understand git-dpm operation.  Especially, which branch you are at for
each operation.  (Beside its commands are too long to type ...)

In example.html under "Creating a new project", I got confused as the
following.

| Create an upstream (or upstream−whatever) branch containing the contents of
| your orig.tar file:
| 
|   tar −xvf example_0.orig.tar.gz
|   cd example−0
|   git init
|   git add .
|   git commit −m "import example_0.orig.tar.gz"
|   git checkout −b upstream−unstable

This switches branch to "upstream−unstable".  In the above, I thought,
you should instead simply execute the following: 

   git branch upstream−unstable

or you need following just after the existing example to get back to
"master" branch somewhere after:

    git checkout master

| You might want to use pristine tar to store your tar:
| pristine−tar commit ../example_0.orig.tar.gz upstream−unstable
 
This pristine-tar operation can be done while on any branch, I assume.
But, the following happens while you are on "master" branch as I
understand.

| Then let git−dpm know what tarball your upstream branch belongs to:
|   git−dpm init ../example_0.orig.tar.gz
| 
| Do the rest of the packaging:
|   vim debian/control debian/rules
|   dch −−create −−package example −v 0−1
|   git add debian/control debian/rules debian/changelog
|   git commit −m "initial packaging"

I am not sure I am confused or this documentation is confusing.

I think documentation should just use "master" "upstream" across most
examples.  These upstream-* or patched-* should be introduced as expert
tricks.  This s/upstream-unstable/upstream/g is my another request
around here.

If I am confused, please do not hesitate to close this bug report.
Thanks.

-- System Information:
Debian Release: squeeze/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-5-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.utf8, LC_CTYPE=en_US.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

-- no debconf information



-- 
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]

Reply via email to