wineprefixcreate.man.in 2.36 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14
.\" -*- nroff -*-
.TH WINEPREFIXCREATE 1 "August 2006" "@PACKAGE_STRING@" "Windows on Unix"
.SH NAME
wineprefixcreate \- create or update the Wine configuration
.SH SYNOPSIS
.BI wineprefixcreate\  [options]
.SH DESCRIPTION
.B wineprefixcreate
creates or updates a Wine configuration directory.  When running Wine,
the base name of the configuration directory is specified in the
WINEPREFIX variable, hence the name of this tool.
.PP
.B wineprefixcreate
is launched automatically by
15
.BR wine (1)
16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
if you don't have an existing configuration. However, it can sometimes
be useful to run it explicitly to create a different directory, or
update an existing one.
.SH OPTIONS
.TP
.BI \--prefix\  directory
Create the specified directory (or update it if it exists already). If
this option is not specified,
.B wineprefixcreate
defaults to the
.I WINEPREFIX
environment variable, or to
.I $HOME/.wine
if not set.
.TP
31
.BR \-h ", " \--help
32 33
Display a usage message.
.TP
34
.BR \-q ", " \--quiet
35 36
Don't display any status messages.
.TP
37
.BR \-w ", " \--wait
38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67
Wait for
.B wineserver
to save everything before returning. This is necessary for instance if
you are planning to rename the directory once created; otherwise a
running server could still try to access the directory under its old
name.
.SH ENVIRONMENT VARIABLES
.TP
.I WINEPREFIX
If set, the content of this variable is taken as the name of the directory where
.B wineprefixcreate
stores its data (the default is \fI$HOME/.wine\fR). All
.B wine
processes using the same prefix share certain things like registry,
shared memory and kernel objects.  By setting
.I WINEPREFIX
to different values for different Wine processes, it is possible to
run a number of truly independent Wine sessions.
.SH FILES
.TP
.B ~/.wine
Default location for the
.B wine
configuration data.
.SH AUTHORS
Many people have contributed to the development of Wine. Please check
the file Changelog in the Wine distribution for the complete details.
.SH BUGS
If you find a bug, please submit a bug report at
.UR http://bugs.winehq.org
68
.BR http://bugs.winehq.org .
69 70 71 72 73 74
.UE
.SH AVAILABILITY
.B wineprefixcreate
is part of the Wine distribution, which is available through WineHQ,
the Wine development headquarters, at
.UR http://www.winehq.org/
75
.BR http://www.winehq.org/ .
76 77 78 79 80 81 82
.UE
.br
It is distributed under the terms of the GNU Lesser General Public
License.
.SH "SEE ALSO"
.BR wine (1),
.BR wineserver (1).