'\" t
.\"     Title: limba-build
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 02 September,2015
.\"    Manual: Limba Project
.\"    Source: Limba Project
.\"  Language: English
.\"
.TH "LIMBA\-BUILD" "1" "02 September,2015" "Limba Project" "Limba Project"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
limba-build \- command\-line tool for automated builds
.SH "SYNOPSIS"
.HP \w'\fBlimba\-build\fR\ 'u
\fBlimba\-build\fR {\fBCOMMAND\fR} [\fBOPTIONS \&.\&.\&.\fR]
.SH "DESCRIPTION"
.PP
This manual page documents briefly the
\fBlimba\-build\fR
command\&.
.PP
\fBlimba\-build\fR
is a tool to automate building Limba packages from source in an isolated chroot environment\&.
.PP
The tool is also able to create simple Limba package repositories and perform other tasks related to building Limba packages\&.
.SH "OPTIONS"
.PP
\fBrun \fR\fB\fIDIRECTORY\fR\fR
.RS 4
Run the build process\&. limba\-build will look for a
lipkg/build\&.yml,
build\&.yml
or
\&.travis\&.yml
file containing build instructions in that order\&.
.sp
To build in a chroot environment, the
\fI\-\-chroot=\fR
parameter needs to point to a directory containing an operating system as created by e\&.g\&.
\fBdebootstrap (8)\fR
on Debian\-based systems\&. If no chroot should be used,
\fI\-\-chroot=none\fR
must be set instead\&.
.RE
.PP
\fBrun\-shell \fR\fB\fIDIRECTORY\fR\fR
.RS 4
Does exactly as the
\fBrun\fR
command, but instead of running the commands necessary to build the software, it opens a interactive shell in the build environment\&.
.sp
This feature is very useful for debugging the build environment itself\&. The pre\-build and post\-build commands are run before and after opening the interactive shell, just as in a regular build\&.
.RE
.PP
\fBrepo\-init \fR\fB\fIDIRECTORY\fR\fR
.RS 4
Initialize empty Limba package repository in a local directory\&.
.RE
.PP
\fBrepo\-add \fR\fB\fIFILENAME\fR\fR\fB \fR\fB\fIDIRECTORY\fR\fR
.RS 4
Add a Limba package to a local repository\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Display version number of limba\-build
.RE
.PP
\fB\-\-verbose\fR
.RS 4
Turn on verbose mode (this can be used for debugging)\&.
.RE
.SH "SEE ALSO"
.PP
limba (1), lipkgen (1), chroot (8)\&.
.PP
Additional documentation can be found on http://people\&.freedesktop\&.org/~mak/limba\&.
.SH "AUTHOR"
.PP
This manual page was written by Matthias Klumpp
<matthias@tenstral\&.net>\&.
.SH "COPYRIGHT"
.br
Copyright \(co 2014-2015 Matthias Klumpp
.br