diff options
author | Daniel Silverstone <dsilvers@digital-scurf.org> | 2013-04-25 21:56:42 +0100 |
---|---|---|
committer | Daniel Silverstone <dsilvers@digital-scurf.org> | 2013-04-25 21:56:42 +0100 |
commit | 9679776801b0e9cf751acef70f84c55955d314a2 (patch) | |
tree | 28e9ca21f713381b7c3d0333fb5395eb652d8e35 | |
parent | 1cd5555d188dc75622b2cf5240af39904096c259 (diff) | |
parent | 16985bf48b225f4dc470c91155ddd178ebc0d038 (diff) | |
download | gitano-9679776801b0e9cf751acef70f84c55955d314a2.tar.gz |
Merge remote-tracking branch 'origin/liw/gitano-setup-manpage'
-rw-r--r-- | doc/gitano-setup.1 | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/doc/gitano-setup.1 b/doc/gitano-setup.1 new file mode 100644 index 0000000..7577be3 --- /dev/null +++ b/doc/gitano-setup.1 @@ -0,0 +1,47 @@ +.\" =*= License: BSD =*= +.TH GITANO-SETUP 1 +.SH NAME +gitano\-setup \- set up a Gitano instance +.SH SYNOPSIS +.B gitano\-setup +.RB [ -h ] +.RB [ --help ] +.RB [ --usage ] +.RB [ ANSWER-FILE ...] +.SH DESCRIPTION +.B gitano-setup +creates the basic repository setup for a Gitano instance. +Gitano is a git repository management system. +It provides repository creation, user administration, and access control. +.PP +.B gitano-setup +is an interactive tool where if it has any questions for you, it will +visit each answers file in turn until it finds the answer. +This means that for automation purposes you can specify multiple answers +files with the earlier ones overriding the later ones. +.PP +In summary, the behaviour is as follows: +.PP +The repository root is created if it does not exist, and a +.I gitano-admin.git +repository is created within it. +Said repository is populated with the example administration repository +rules and an admin user and group. +.SS "Answer files" +FIXME add the answer file format here. +.SH OPTIONS +.TP +.BR \-h ", " \-\-help ", " \-\-usage +Print out a usage summary for the program. +.SH EXAMPLE +To set up a new Gitano instance: +.PP +.nf +.RS +sudo adduser git +sudo su - git +gitano-setup +.RE +.fi +.PP +There you go. |