.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH MAKE-KLONE-PROJECT 1 "16 Sep 2007"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
make-klone-project \- manage a KLone based custom Debian package
.SH SYNOPSIS
.B make-klone-project
.RI [ options ]\  COMMAND
.SH DESCRIPTION
.B make-klone-project
is a tool to create and manage custom webserver packages that use
KLone, a framework that integrates a web site with possibly dynamic
content and a web server into a single binary.
.PP
The aim is to let the author to focus on editing the site specific
files under
.B webapp/
and allow creating a Debian package containing the web server and an
init.d script to manage it with
.nh
.BR dpkg-buildpackage .
.hy
.SH USAGE
.B make-klone-project
takes one non-option argument.
.TP
.B create
Create a new project directory,
.IR package \-0.1
and seeds it with KLone's source and a debian/ directory.
.TP
.B clean
Remove all non-user created files and directories ie. everything but
.nh
.IR debian/copyright ,
.IR debian/changelog ,
.I debian/wsp.*
and
.IR webapp/ .
.hy
See also the
.B \-l
option below.
.TP
.B refresh
Cleans the project directory as with
.nh
.B make-klone-project clean
.hy
and reseeds the KLone source and the debian/ directory.
.SH EXAMPLES
 make-klone-project create -p myapp -m "Kari Pahula <kaol@debian.org>"
 cd myapp-0.1
 (edit any files that require editing, mostly in webapp/)
 make-klone-project refresh
 dpkg-buildpackage -rfakeroot
 sudo dpkg -i ../myapp_0.1_i386.deb
.SH OPTIONS
.TP
\fB\-b \fINAME\fR
Name the created web server binary as
.IR NAME .
If not specified the package name is used.
.TP
.B -l
Look for the project root directory in
.nh
.B clean
and
.B refresh
.hy
commands by changing the working directory to the parent directory
until they find a file named
.nh
.I debian/wsp.opt.maintainer
.hy
in the current directory.  Returns with error if none is found.
Without this option, only the current directory is checked for this
file.

The upside of using this option is that
.nh
.B make-klone-project
.hy
will be agnostic about the working directory, as long as it is
somewhere inside the project tree, just like
.nh
.BR dpkg-buildpackage .
.hy
The downside is that you run a greater risk of having the
.B clean
command cause unwanted data loss, if you happen to have an
unfortunately named file in a wrong place.
.TP
\fB-m \fINAME\fR
Sets the maintainer name as
.IR NAME .
.TP
\fB-p \fINAME\fR
Set the package name as
.IR NAME .
Only effective with the
.B create
command.  If not specified, uses
.BR customkloneapp .
.SH FILES
.TP
.I debian/wsp.description
A custom description for the package.  Should be formatted like the
corresponding field in the
.I debian/control
file.
.TP
.I debian/wsp.opt.*
The options set in prior calls to
.BR make-klone-project .
.TP
.I webapp/
The user specified site tree, to be imported as the site by KLone.
.SH NOTES
Your web server will be run as a root, so you will need to use either
.B allow_root
or
.B uid
and
.B gid
options in your
.IR etc/kloned.conf .
.SH SEE ALSO
.BR dpkg-buildpackage (1),
.BR klone (1),
.BR kloned.conf (5),
.BR kloned (8).
.SH AUTHOR
.B make-klone-project
was written by Kari Pahula <kaol@debian.org>.