documentation/installing.sgml

   1   <chapter id="installing">
   2     <title>Installing or uninstalling Wine</title>
   3
   4     <para>
   5       A standard Wine distribution form (which you probably downloaded
   6       according to chapter <link linkend="getting-wine">Getting Wine</link>)
   7       includes quite a few different programs, libraries
   8       and configuration files.  All of these
   9       must be set up properly for Wine to work well.  In order to
  10       achieve this, this chapter will guide you through the necessary steps
  11       to get the Wine files
  12       installed on your system. It will <emphasis>not</emphasis>
  13       deal with how to get Wine's Windows environment
  14       <emphasis>configured</emphasis>; that's what the next chapter
  15       will talk about.
  16     </para>
  17
  18     <para>
  19       When installing Wine, you should make sure that it doesn't happen
  20       to overwrite a previous Wine installation (as this would cause
  21       an overwhelming amount of annoying and fatal conflicts);
  22       uninstalling any previous Wine version (as explained in this chapter)
  23       to avoid this problem is recommended.
  24     </para>
  25
  26     <sect1 id="installing-package">
  27       <title>Installing or uninstalling Wine packages</title>
  28
  29       <para>
  30         Now that you have downloaded the Debian or RPM or whatever Wine
  31         package file, probably via the instructions given in the
  32         previous chapter, you may be wondering "What in the world do I
  33         do with this thing?".
  34         This section will hopefully be able to put an end to your
  35         bewildered questioning, by giving detailed install instructions
  36         for all sorts of well-known package types.
  37       </para>
  38
  39       <sect2>
  40         <title>Debian Linux</title>
  41
  42         <para>
  43           In case you haven't downloaded and automatically installed the
  44           Wine package file via <command>apt-get</command> as described
  45           in the <link linkend="getting-wine">Getting Wine</link>
  46           section, you now need to use <command>dpkg</command> to
  47           install it.  Switch to the directory you downloaded the Debian
  48           .deb package file to.  Once there, type these commands,
  49           adapting the package file name as required:
  50         </para>
  51   <screen>
  52   <prompt>$ </><userinput>su -</>
  53   Password:
  54   <prompt># </><userinput>cd /home/user</>
  55   <prompt># </><userinput>dpkg -i wine_<replaceable>0.0.20030115-1</>.deb</>
  56   </screen>
  57         <para>
  58           (Type the root password at the "Password:" prompt)
  59         </para>
  60
  61         <para>
  62           You may also want to install the
  63           <systemitem>wine-doc</systemitem> package, and if you are
  64           using Wine from the 2.3 distribution (Woody), the
  65           <systemitem>wine-utils</systemitem> package as well.
  66         </para>
  67
  68         <para>
  69           Uninstalling an installed Wine Debian package can be done by
  70           running:
  71         </para>
  72   <screen>
  73   <prompt># </><userinput>dpkg -l|grep wine</>
  74   </screen>
  75         <para>
  76           The second column of the output (if any) of this command will
  77           indicate the installed packages dealing with "wine".
  78           The corresponding packages can be uninstalled by running:
  79         </para>
  80   <screen>
  81   <prompt># </><userinput>dpkg -r <replaceable>&lt;package_name&gt;</></>
  82   </screen>
  83         <para>
  84           where &lt;package_name&gt; is the name of the Wine-related package
  85           which you want to uninstall.
  86         </para>
  87       </sect2>
  88       <sect2>
  89         <title>Linux Red Hat, Mandrake, SUSE and other distributions using RPM</title>
  90
  91         <para>
  92           Most distributions provide a graphical tool for installing
  93           RPM packages, you can use it by simply clicking (Or double clicking,
  94           depending on your system settings) on the RPM. If you don't have a
  95           graphical RPM manager installed, using a shell, switch to the
  96           directory where you downloaded the RPM package file to.
  97           Once there, type this one command as root, adapting the
  98           package file name as required:
  99         </para>
 100   <screen>
 101   <prompt># </><userinput>rpm -ivh wine-<replaceable>20031212.i386</>.rpm</>
 102   </screen>
 103         <para>
 104           You may also want to install the
 105           <systemitem>wine-devel</systemitem> package.
 106         </para>
 107         <para>
 108           If you've installed wine graphically, you can uninstall it
 109           using your graphical RPM manager (Gnorpm, Kpackage, Yast,
 110           Mandrake Control Center and so on), alternatively, uninstalling
 111           a installed Wine RPM package can be done from a shell, by running:
 112         </para>
 113   <screen>
 114   <prompt># </><userinput>rpm -qa|grep -i wine</>
 115   </screen>
 116         <para>
 117           This command will indicate the installed packages dealing with "wine".
 118           The corresponding packages can be uninstalled by running:
 119         </para>
 120   <screen>
 121   <prompt># </><userinput>rpm -e <replaceable>&lt;package_name&gt;</></>
 122   </screen>
 123         <para>
 124           where &lt;package_name&gt; is the name of the Wine-related package
 125           which you want to uninstall.
 126         </para>
 127       </sect2>
 128     </sect1>
 129
 130     <sect1 id="installing-source">
 131       <title>Installing or uninstalling a Wine source code tree</title>
 132
 133       <para>
 134         If you are in the directory of the Wine version that you just
 135         compiled (e.g. by having run <command>make depend && make</command>), then you may now install this Wine version by running as <glossterm>root</glossterm>:
 136       </para>
 137   <screen>
 138   <prompt># </><userinput>make install</>
 139   </screen>
 140       <para>
 141         This will copy the Wine binary files to their final destination
 142         in your system. You can then proceed to the <link
 143         linkend="config-wine-main">Configuration chapter</link> to
 144         configure the Wine environment.
 145       </para>
 146
 147       <para>
 148         If instead you want to uninstall the currently installed Wine
 149         source code version, then change to the main directory of this
 150         version and run as <glossterm>root</glossterm>:
 151       </para>
 152   <screen>
 153   <prompt># </><userinput>make uninstall</>
 154   </screen>
 155     </sect1>
 156   </chapter>
 157
 158 <!-- Keep this comment at the end of the file
 159 Local variables:
 160 mode: sgml
 161 sgml-parent-document:("wine-user.sgml" "set" "book" "chapter" "")
 162 End:
 163 -->