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>Red Hat (RPM) Linux</title>
  90
  91         <para>
  92           Switch to the directory you downloaded the RPM package file to.
  93           Once there, type this one command as root, adapting the
  94           package file name as required:
  95         </para>
  96   <screen>
  97   <prompt># </><userinput>rpm -ivh wine-<replaceable>20020605-2.i386</>.rpm</>
  98   </screen>
  99         <para>
 100           You may also want to install the
 101           <systemitem>wine-devel</systemitem> package.
 102         </para>
 103         <para>
 104           Uninstalling an installed Wine RPM package can be done by
 105           running:
 106         </para>
 107   <screen>
 108   <prompt># </><userinput>rpm -qa|grep -i wine</>
 109   </screen>
 110         <para>
 111           This command will indicate the installed packages dealing with "wine".
 112           The corresponding packages can be uninstalled by running:
 113         </para>
 114   <screen>
 115   <prompt># </><userinput>rpm -e <replaceable>&lt;package_name&gt;</></>
 116   </screen>
 117         <para>
 118           where &lt;package_name&gt; is the name of the Wine-related package
 119           which you want to uninstall.
 120         </para>
 121       </sect2>
 122     </sect1>
 123
 124     <sect1 id="installing-source">
 125       <title>Installing or uninstalling a Wine source code tree</title>
 126
 127       <para>
 128         If you are in the directory of the Wine version that you just
 129         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>:
 130       </para>
 131   <screen>
 132   <prompt># </><userinput>make install</>
 133   </screen>
 134       <para>
 135         This will copy the Wine binary files to their final destination
 136         in your system. You can then proceed to the <link
 137         linkend="config-wine-main">Configuration chapter</link> to
 138         configure the Wine environment.
 139       </para>
 140
 141       <para>
 142         If instead you want to uninstall the currently installed Wine
 143         source code version, then change to the main directory of this
 144         version and run as <glossterm>root</glossterm>:
 145       </para>
 146   <screen>
 147   <prompt># </><userinput>make uninstall</>
 148   </screen>
 149     </sect1>
 150   </chapter>
 151
 152 <!-- Keep this comment at the end of the file
 153 Local variables:
 154 mode: sgml
 155 sgml-parent-document:("wine-user.sgml" "set" "book" "chapter" "")
 156 End:
 157 -->