tools/wineprefixcreate.man.in

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