'\" t
.\"     Title: \fBkdesrc-build-setup\fR
.\"    Author: Michael Pyne <mpyne@kde.org>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 2012-05-05
.\"    Manual: KDE User's Manual
.\"    Source: 0.02
.\"  Language: English
.\"
.TH "\FBKDESRC\-BUILD\-SE" "1" "2012\-05\-05" "0\&.02" "KDE User's Manual"
.\" -----------------------------------------------------------------
.\" * 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"
kdesrc-build-setup \- Creates a ~/\&.kdesrc\-buildrc configuration file for \fBkdesrc\-build\fR(1)\&.
.SH "SYNOPSIS"
.HP \w'\fBkdesrc\-build\-setup\fR\ 'u
\fBkdesrc\-build\-setup\fR
.SH "DESCRIPTION"
.PP
The
\fBkdesrc\-build\-setup\fR
command is used to generate a simple configuration file for
\fBkdesrc\-build\fR(1)\&.
.PP
It requires the
\fBdialog\fR(1) script be available, and Perl (just like
\fBkdesrc\-build\fR)\&.
.PP
No command line options are accepted\&. The operation of the program is instead driven through dialog\-style prompts to gather the data required to generate the configuration file\&. The configuration file can be saved to a location other than
~/\&.kdesrc\-buildrc\&.
.SH "OPTIONS"
.PP
No command line options are supported for this command\&.
.SH "EXIT STATUS"
.PP
\fB0\fR
.RS 4
Success
.RE
.PP
\fBAnything else\fR
.RS 4
Either there was an I/O failure of some type (invalid permissions, disk full, etc\&.), or the user canceled the program by pressing
ESC
during a dialog\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBHOME\fR
.RS 4
Used for tilde\-expansion of file names, and is the default base for the source, build, and installation directories\&.
.RE
.PP
\fBdialog\fR(1)
.RS 4
The
\fBdialog\fR(1) program is required for the operation of this script and may obey environment variables of its own\&.
.RE
.SH "FILES"
.PP
~/\&.kdesrc\-buildrc
\- Default global configuration file, generated by default by this script\&. If the file already exists, the existing file is moved to
~/\&.kdesrc\-buildrc~
as a backup before generating the configuration\&.
.PP
The file generated by this script can be saved to a different name instead\&.
.SH "BUGS"
.PP
See
\m[blue]\fBhttp://bugs\&.kde\&.org/\fR\m[]\&. Be sure to search against the
\fBkdesrc\-build\fR
product\&.
.SH "SEE ALSO"
.PP
\fBkdesrc\-build\fR(1)
.PP
kdesrc\-buildrc\-sample
file (if included with your
kdesrc\-build
distribution)\&.
.SH "RESOURCES"
.PP
Main web site:
\m[blue]\fBhttp://kdesrc\-build\&.kde\&.org/\fR\m[]
.PP
Documentation:
\m[blue]\fBhttp://kdesrc\-build\&.kde\&.org/documentation/\fR\m[]
.SH "COPYING"
.PP
Copyright (C) 2011 Michael Pyne\&.
.PP
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version\&.
.PP
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\&. See the GNU General Public License for more details\&.
.PP
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc\&., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA
.SH "AUTHOR"
.PP
\fBMichael Pyne\fR <\&mpyne@kde\&.org\&>
.RS 4
Author.
.RE