documentation/getting.sgml

   1   <chapter id="getting-wine">
   2     <title>Getting Wine</title>
   3
   4     <sect1>
   5       <title>The Many Forms of Wine</title>
   6       <para>
   7         The standard Wine distribution includes quite a few different
   8         executables, libraries, and configuration files.  All of these
   9         must be set up properly for Wine to work well.  This chapter
  10         will guide you through the necessary steps to get Wine
  11         installed on your system.
  12       </para>
  13       <para>
  14         If you are running a distribution of Linux that uses packages
  15         to keep track of installed software, you should be in luck: A
  16         prepackaged version of Wine should already exist for your system.
  17         The following sections will tell you how to find the latest
  18         Wine packages and get them installed.  You should be careful,
  19         though, about mixing packages between different distributions,
  20         and even from different versions of the same distribution.
  21         Often a package will only work on the distribution it's
  22         compiled for.  We'll cover
  23         <link linkend="getting-dist-debian">Debian</link>,
  24         <link linkend="getting-dist-redhat">Red Hat</link>, and
  25         <link linkend="getting-dist-other">other</link> distributions.
  26       </para>
  27       <para>
  28         If you're not lucky enough to have a package available for
  29         your operating system, or if you'd prefer a newer version of
  30         Wine than already exists as a package, you will have to
  31         download the Wine source code and compile it yourself on your
  32         own machine.  Don't worry, it's not too hard to do this,
  33         especially with the many helpful tools that come with Wine.
  34         You don't need any programming experience to compile and
  35         install Wine, although it might be nice to have some minor
  36         UNIX administrative skills.  Working from the source is
  37         covered in the Wine Developer's Guide.
  38       </para>
  39     </sect1>
  40
  41     <sect1 id="getting-dist-debian">
  42       <title>Getting Wine for a Debian System</title>
  43
  44       <para>
  45         In most cases on a Debian system, you can install Wine with a
  46         single command, as root:
  47       </para>
  48 <screen>
  49 <prompt># </><userinput>apt-get install wine</>
  50 </screen>
  51       <para>
  52         <command>apt-get</command> will connect to a Debian archive
  53         across the Internet (thus, you must be online), then download
  54         the Wine package and install it on your system.  End of story.
  55       </para>
  56
  57       <para>
  58         Of course, Debian's pre-packaged version of Wine may not be the
  59         most recent release.  If you are running the stable version of
  60         Debian, you may be able to get a slightly newer version of Wine
  61         by grabbing the package from the unstable distribution, although
  62         this may be a little risky, depending on how far the unstable
  63         distribution has diverged from the stable one.  You can find a
  64         list of Wine binary packages for the various Debian releases
  65         using the package search engine at <ulink url="http://www.debian.org">
  66           www.debian.org</ulink>.
  67       </para>
  68
  69       <para>
  70         To install a package that's not part of your distribution, you
  71         must use <command>dpkg</command> instead of
  72         <command>apt-get</command>.  Since <command>dpkg</command>
  73         doesn't download the file for you, you must do it yourself.
  74         Follow the link on the package search engine to the desired
  75         package, then click on the <guibutton>Go To Download
  76           Page</guibutton> button and follow the instructions.  Save the
  77         file to your hard drive, then run <command>dpkg</command> on it.
  78         For example, if you saved the file to your home directory, you
  79         might perform the following actions to install it:
  80       </para>
  81 <screen>
  82 <prompt>$ </><userinput>su -</>
  83 Password:
  84 <prompt># </><userinput>cd /home/user</>
  85 <prompt># </><userinput>dpkg -i wine_<replaceable>0.0.20021031-1</>.deb</>
  86 </screen>
  87       <para>
  88         You may also want to install the
  89         <systemitem>wine-doc</systemitem> package, and if you are
  90         using Wine from the 2.3 distribution (Woody), the
  91         <systemitem>wine-utils</systemitem> package as well.
  92       </para>
  93     </sect1>
  94
  95     <sect1 id="getting-dist-redhat">
  96       <title>Getting Wine for a Red Hat System</title>
  97
  98       <para>
  99         Red Hat/RPM users can use <ulink url="http://rpmfind.net/linux/RPM/">
 100           rpmfind.net</ulink> to track down available Wine RPM binaries.
 101         <ulink url="http://rpmfind.net/linux/RPM/WByName.html"> This
 102           page</ulink> contains a list of all rpmfind packages that start with
 103         the letter "W", including a few Wine packages.
 104       </para>
 105
 106       <para>
 107         Of course now that you have the RPM package, you may be wondering
 108         "What in the world do I do with this thing?".
 109       </para>
 110
 111       <para>
 112         The easiest way to install an RPM is to make sure that you have not
 113         previously installed wine (perhaps, when you installed linux)
 114         and then switch to the directory you downloaded the rpm file to.
 115         Once there, type this one command as root:
 116       </para>
 117 <screen>
 118 <prompt># </><userinput>rpm -ivh wine-<replaceable>20020605-2.i386</>.rpm</>
 119 </screen>
 120       <para>
 121         You may also want to install the
 122         <systemitem>wine-devel</systemitem> package.
 123       </para>
 124     </sect1>
 125
 126     <sect1 id="getting-dist-other">
 127       <title>Getting Wine for Other Distributions</title>
 128
 129       <para>
 130         The first place you should look if your system isn't Debian or
 131         Red Hat is the <ulink
 132         url="http://www.winehq.com/download/">WineHQ Download
 133         Page</ulink>.  This page lists many assorted archives of
 134         binary (precompiled) Wine files.
 135       </para>
 136
 137       <para>
 138         <ulink url="http://ftpsearch.lycos.com/?form=medium">
 139           Lycos FTPSearch</ulink> is another useful resource for
 140         tracking down miscellaneous distribution packages.
 141       </para>
 142
 143       <para>
 144         NOTE: If you are running a Mandrake system, please see the page
 145         on how to get wine for a
 146         <link linkend="getting-dist-redhat">Redhat</link> system,
 147         as Mandrake is based on Redhat.
 148       </para>
 149
 150       <!-- *** Add other distributions, e.g., SUSE, Slackware *** -->
 151
 152     </sect1>
 153
 154   </chapter>
 155
 156 <!-- Keep this comment at the end of the file
 157 Local variables:
 158 mode: sgml
 159 sgml-parent-document:("wine-doc.sgml" "set" "book" "chapter" "")
 160 End:
 161 -->