| .\" -*- 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 |
| .B wine(1) |
| 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 |
| .B \-h, \--help |
| Display a usage message. |
| .TP |
| .B \-q, \--quiet |
| Don't display any status messages. |
| .TP |
| .B \-w, \--wait |
| 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 |
| .B http://bugs.winehq.org. |
| .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/ |
| .B http://www.winehq.org/. |
| .UE |
| .br |
| It is distributed under the terms of the GNU Lesser General Public |
| License. |
| .SH "SEE ALSO" |
| .BR wine (1), |
| .BR wineserver (1). |
