Added support for CP_UNIXCP.
[wine] / 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>
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>
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 -->