Package: gitolite
Followup-For: Bug #653981

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Hallo,

I wrote a manpage for gl-setup. (Attached)
Maybe you want to include it?

- -- 
Tobi

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

Kernel: Linux 3.13-1-amd64 (SMP w/4 CPU cores)
Locale: LANG=de_DE.utf8, LC_CTYPE=de_DE.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1

iQIcBAEBCAAGBQJTSO00AAoJEJFk+h0XvV02Fz0P/jAsjAkbS9/6ANwd/aoRNB0s
2SvTTv7RTKOZtcpPyyInVLj416kI2kdz0wokxl/3qdjvKtQotrZgu6FgxrCMi+sY
uHc6d2hQx2dW13jb2dThPd5J5MgpodNfkhEqdMEvgg3BghCwVAFbQkkY8ZN76Q7R
nW2qCIcqcAHlesqh+usUzn+xFB+KqxFZyk/5iwaebvZK13Ta3CPKhm2kOTalSsC0
Iih3C0bQxe9Ne0D7HBw6nXR0BjzDoYCuPpJwH9KtsLzaH9Z5D3zHN6n/pFPEDOu/
p0Tf8B0aPhoRyJyznRNXFXpJQ9KOUt0fON5YPgqBWgjJkMIt+cJK67DDM1ZuI3L8
1jTd0lroa1GLoSHE7y1dmGKmI2iHpabpv0WlB05YdrHEdYfmF3WN5rI3VogFIRXE
2VSKUtYTdn/IXgqmUCWSQosaNUUNk0vJYHblkrg3MWJ8uPB1Hj2haiu9lfbvxw+a
kK67mmD73QhO+mgDHfmD0x2rPFcEKzgzp1wq3crz1yXkz+X9u5YOxQo1kUnT3vlt
v0vH81g26wnWnoObwLncoJSx461HY7Ghmv33ci8DYIPHOuXLQgmRy44k6qFyKjg5
TRSAeHaWClxt8zZrnv55iWYxhsczXp/S+6ywaYrkR8fjzt9ZRv1fazw8p82ETQzO
MWw/GU9MkzVXGRnxm3H3
=sEH0
-----END PGP SIGNATURE-----
.TH gl-setup 1 "April 11, 2014" "" "gitolite"

.SH NAME
gl-setup \- Initial setup of gitolite or reset public key

.SH SYNOPSIS
.B gl-setup 
[-q] 
public_key.pub
.br

.B gl-setup 
[-q] 
admin
.br

.B gl-setup 
[-q] 
.br


.SH DESCRIPTION
With
.B gl-setup
gitolite can be setup for the first time, or if access to the gitolite 
repository is lost,
 the admin public key can replaced
.PP
In ssh mode, 
.B gl-setup 
expects a public key filename the first time it is run, and will complain if you 
don't supply it. On subsequent runs it is optional; you only need to supply it 
if you want to quickly and easily change the admin's (or indeed anyone's!) 
pubkey without going through all the steps that 
.B gl-admin-push(1) 
requires.
.PP
In http mode   
.B gl-setup 
expects an admin name the first time it is run. On subsequent runs, arguments 
are ignored. For the http mode read
.B git-http-backend(1) 
.
You need also to set 
.BR $GITOLITE_HTTP_HOME 
appropiatly before using 
.B gl-setup 
in http mode.

.PP
When running 
.B gl-setup 
without any options can be used to re\-initialize a gitolite installation. Read  
/usr/share/doc/gitolite/install.mkd.gz 
for details.

.SH OPTIONS

.B   
.IP -q 
quiet mode; suppress the editor that pops up to allow you to change the rc file 
the first time. Meaningless/ignored on subseqent runs.  This option must be 
specified before the pubkey or admin name. 

.B 
.IP public_key.pub
specifies the public key to be used for the admin, or for key-recovery which key 
should replace it. 

.B
.IP admin
user for the http mode

.SH ENVIRONMENT
.B
.IP GITOLITE_HTTP_HOME
is the home directory for http mode. Must be set to use this command in http 
mode.

.SH "SEE ALSO"
.BR /usr/share/doc/gitolite/http-backend.mkd.gz
.BR /usr/share/doc/gitolite/install.mkd.gz

Reply via email to