make-klone-project(1) [debian man page]
MAKE-KLONE-PROJECT(1) General Commands Manual MAKE-KLONE-PROJECT(1) NAME
make-klone-project - manage a KLone based custom Debian package SYNOPSIS
make-klone-project [options] COMMAND DESCRIPTION
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. The aim is to let the author to focus on editing the site specific files under webapp/ and allow creating a Debian package containing the web server and an init.d script to manage it with dpkg-buildpackage. USAGE
make-klone-project takes one non-option argument. create Create a new project directory, package-0.1 and seeds it with KLone's source and a debian/ directory. clean Remove all non-user created files and directories ie. everything but debian/copyright, debian/changelog, debian/wsp.* and webapp/. See also the -l option below. refresh Cleans the project directory as with make-klone-project clean and reseeds the KLone source and the debian/ directory. 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 OPTIONS
-b NAME Name the created web server binary as NAME. If not specified the package name is used. -l Look for the project root directory in clean and refresh commands by changing the working directory to the parent directory until they find a file named debian/wsp.opt.maintainer in the current directory. Returns with error if none is found. Without this op- tion, only the current directory is checked for this file. The upside of using this option is that make-klone-project will be agnostic about the working directory, as long as it is somewhere inside the project tree, just like dpkg-buildpackage. The downside is that you run a greater risk of having the clean command cause unwanted data loss, if you happen to have an unfortunately named file in a wrong place. -m NAME Sets the maintainer name as NAME. -p NAME Set the package name as NAME. Only effective with the create command. If not specified, uses customkloneapp. FILES
debian/wsp.description A custom description for the package. Should be formatted like the corresponding field in the debian/control file. debian/wsp.opt.* The options set in prior calls to make-klone-project. webapp/ The user specified site tree, to be imported as the site by KLone. NOTES
Your web server will be run as a root, so you will need to use either allow_root or uid and gid options in your etc/kloned.conf. SEE ALSO
dpkg-buildpackage(1), klone(1), kloned.conf(5), kloned(8). AUTHOR
make-klone-project was written by Kari Pahula <kaol@debian.org>. 16 Sep 2007 MAKE-KLONE-PROJECT(1)
Check Out this Related Man Page
DH-MAKE-PEAR(1) dh-make-pear User Manual DH-MAKE-PEAR(1) NAME
dh-make-pear - Create debian source packages from pear modules SYNOPSIS
dh-make-pear [--help ] [--version ] [--rename ] [--arch any | all] [--state STATE] [--depends DEPENDS] [--maintainer MAINTAINER] [--prefix PREFIX] [--templatedir TEMPLATEDIR] [PACKAGE] DESCRIPTION
This manual page documents briefly the dh-make-pear command. dh-make-pear creates the files required to build a debian source package from a PHP extension as it is distributed through PEAR. The last parameter passed to dh-make-pear can be either the .tgz archive containing the php extension or the name of the extension. In the second case dh-make-pear will first download the archive from http://pear.php.net. If dh-make-pear downloads the archive itself, it will always take the most recent version. dh-make-pear will by default create a directory named php-<pear-package-name> which will contain the debian files and the unpacked files from the extension. It will also create a symlink php-<pear-package-name>_<version>.orig.tar.gz pointing towards the original source. After creating the files you can go into then new directory and build the debian package with dpkg-buildpackage -rfakeroot. dh-make-pear tries to extract as much information about the package from the file package.xml which is part of the pear extension. Debian source packages created by dh-make-pear can later easily be updated with uscan. OPTIONS
These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below. For a complete description, see the Info files. -h --help Show summary of options. -v --version Show version of program. --rename Do not link orig.tar.gz but move the source into .orig.tar.gz. --arch Set architecture of created debian source package to 'any' or 'all'. Defaults to 'all'. --state Set preferred state for downloaded package. Defaults to 'stable'. --depends Adds more packages to Depends: beside php-pear. --prefix Sets prefix of debian source package name. Each name ends in '<pear-package-name>'. Defaults to 'php-'. --maintainer Explicitly sets the maintainer. In most cases it will be propperly guessed by reading some of the environment variables. --templatedir Use a different directory with templates for the debian files. Defaults to /usr/share/dh-make-php/pear.template. ENVIRONMENT
DEBFULLNAME - get the real name of the maintainer LOGNAME or USER - get the username DEBEMAIL or EMAIL - get the email address of the user SEE ALSO
dh-make-pecl (1). AUTHOR
UWE STEINMANN <steinm@debian.org> Wrote this manpage for the Debian system. COPYRIGHT
Copyright (C) 2004-2010 Uwe Steinmann This manual page was written for the Debian system (and may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation. On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. dh-make-pear 09/01/2010 DH-MAKE-PEAR(1)