Your message dated Fri, 13 Jan 2012 10:42:07 +0100
with message-id <[email protected]>
and subject line Re: Bug#654182: gitolite:
/usr/share/doc/gitolite/README.Debian has not setup instructions
has caused the Debian Bug report #654182,
regarding gitolite: /usr/share/doc/gitolite/README.Debian has not setup
instructions
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
654182: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=654182
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: gitolite
Version: 2.2-1
Severity: normal
The included /usr/share/doc/gitolite/README.Debian reads:
gitolite for Debian
-------------------
gitolite is meant to not require root access. This still is true for the
packaging of gitolite for Debian. The package asks for dedicated user
and directory for the repositories on first install, and an admin key
which has full access and can add additional repositories and users.
A potential dpkg-reconfigure of the package could set up additional
dedicated users and repositories with different admins.
It is missing the steps to configure gitolite for Debian.
SUGGESTION
1) Please move sentence "A potential dpkg-reconfigure..." out of
current paragraph to e.g. section "TODO" so that it is not confused
with how the gitolite is set up.
2) Add section "SETUP" with numbered steps how to setup gitolite for
use in Debian. Just running gl-setup didn't do it (see bug reports).
Something like this would be a start:
Explain how to generate SSH key / or use existing key
Explain how to copy that key under name <login name>.pub
Explain hot to create user "gitolite"
Explain how to change to user "gitolite"
Explain how to call gl-setup
Explain what critical values to chnage in setup file. If not
set, the program will display:
***** WARNING *****
the following users (pubkey files in parens) do not appear in the
config file: gitolite(gitolite.pub)
***** WARNING *****
the following users have no pubkeys: user
<... end the rest. How to test that everything is ok; clone admin repo
etc. >
-- System Information:
Debian Release: wheezy/sid
APT prefers unstable
APT policy: (990, 'unstable'), (500, 'testing')
Architecture: i386 (i686)
Kernel: Linux 2.6.38-2-686 (SMP w/1 CPU core)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages gitolite depends on:
ii adduser 3.113
ii debconf [debconf-2.0] 1.5.41
ii git [git-core] 1:1.7.7.3-1
ii git-core 1:1.7.7.3-1
ii openssh-server 1:5.9p1-2
ii perl 5.14.2-6
gitolite recommends no packages.
Versions of packages gitolite suggests:
ii git-daemon-run 1:1.7.7.3-1
ii gitweb 1:1.7.7.3-1
-- debconf information excluded
-- debsums errors found:
debsums: changed file /usr/share/gitolite/gl-setup (from gitolite package)
--- End Message ---
--- Begin Message ---
* Jari Aalto <[email protected]> [2012-01-02 09:50:49 CET]:
> Package: gitolite
> Version: 2.2-1
> Severity: normal
>
> The included /usr/share/doc/gitolite/README.Debian reads:
>
> gitolite for Debian
> -------------------
>
> gitolite is meant to not require root access. This still is true for the
> packaging of gitolite for Debian. The package asks for dedicated user
> and directory for the repositories on first install, and an admin key
> which has full access and can add additional repositories and users.
> A potential dpkg-reconfigure of the package could set up additional
> dedicated users and repositories with different admins.
>
> It is missing the steps to configure gitolite for Debian.
That is what debconf is about and guides you through.
> SUGGESTION
>
> 1) Please move sentence "A potential dpkg-reconfigure..." out of
> current paragraph to e.g. section "TODO" so that it is not confused
> with how the gitolite is set up.
Uh? README.Debian is about how the package is specific to Debian, so
dpkg-reconfigure does belong exactly there.
> 2) Add section "SETUP" with numbered steps how to setup gitolite for
> use in Debian. Just running gl-setup didn't do it (see bug reports).
"Just running gl-setup" is meant for the current user to be set up as
gate keeper, and is documented in the upstream documentation. gitolite
asks on installation for the required information, and dpkg-reconfigure
can be used to create a potential second dedicated user as gatekeeper.
> Something like this would be a start:
>
> Explain how to generate SSH key / or use existing key
Uhm, that belongs in ssh's documentation and may vary on the ssh client
used, it's not gitolite's job to document third party applications it
doesn't has any influence on.
> Explain how to copy that key under name <login name>.pub
That's basic shell usage.
> Explain hot to create user "gitolite"
That's done by debconf.
> Explain how to change to user "gitolite"
There is no need for that.
> Explain how to call gl-setup
This is yet another bugreport of yours, the one about the missing
manpage. Appart from that, it's also done by debconf for you.
> Explain what critical values to chnage in setup file.
That's nothing Debian specific and thus has no place in README.Debian
but belongs in upstream documentation, and I am very confident that
upstream documentation contains information about the setup file.
Enjoy,
Rhonda
--
Fühlst du dich mutlos, fass endlich Mut, los |
Fühlst du dich hilflos, geh raus und hilf, los | Wir sind Helden
Fühlst du dich machtlos, geh raus und mach, los | 23.55: Alles auf Anfang
Fühlst du dich haltlos, such Halt und lass los |
--- End Message ---
