Skip to content

W
wine-cw
Commit d6828ebb authored by Scott Ritchie's avatar Scott Ritchie Committed by Alexandre Julliard
Browse files
Options

User Guide Chapter 2 rewrite.

parent b0f02b28
Expand all Hide whitespace changes
Inline Side-by-side
Showing with 9 additions and 242 deletions
documentation/Makefile.in
View file @ d6828ebb
......@@ -12,12 +12,10 @@ EXTRASUBDIRS = samples
WINE_USER_SRCS = \
bugs.sgml \
compiling.sgml \
configuring.sgml \
fonts.sgml \
getting.sgml \
glossary.sgml \
installing.sgml \
introduction.sgml \
printing.sgml \
registry.sgml \
......
documentation/compiling.sgml deleted 100644 → 0
View file @ b0f02b28
<chapter id="compiling">
<title>Compiling the Wine Source</title>
<para>
In case you downloaded Wine source code files, this chapter will
tell you how to compile it into binary files before installing them.
Otherwise, please proceed directly to the <link
linkend="installing">Installation chapter</link> to install the
binary Wine files.
</para>
<sect1 id="compiling-wine">
<title>Compiling Wine</title>
<sect2>
<title>Commands</title>
<para>
To compile and install Wine, run the following commands:
<screen>
./configure
make depend
make
make install
</screen>
Please note that the last command (<command>make install</command>)
must be run as root.
</para>
</sect2>
<sect2>
<title>Requirements</title>
<para>
For an up-to-date list of software requirements for compiling
Wine and instructions how to actually do it, please see the <ulink
url="http://www.winehq.org/source/README">README</ulink> file,
which is also available in the main directory of a Wine source
code tree.
</para>
</sect2>
<sect2>
<title>Space required</title>
<para>
You also need about 400 MB of available disk space for compilation.
The compiled libwine.so binary takes around 5 MB of disk space,
which can be reduced to about 1 MB by stripping ('strip wine').
Stripping is not recommended, however, as you can't submit
proper crash reports with a stripped binary.
</para>
</sect2>
<sect2>
<title>Common problems</title>
<para>
If you get a repeatable sig11 compiling shellord.c, thunk.c
or other files, try compiling just that file without optimization
(removing the -Ox option from the GCC command in the
corresponding Makefile).
</para>
</sect2>
</sect1>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-parent-document:("wine-user.sgml" "set" "book" "part" "chapter" "")
End:
-->
documentation/installing.sgml deleted 100644 → 0
View file @ b0f02b28
<chapter id="installing">
<title>Installing or uninstalling Wine</title>
<para>
A standard Wine distribution form (which you probably downloaded
according to chapter <link linkend="getting-wine">Getting Wine</link>)
includes quite a few different programs, libraries
and configuration files. All of these
must be set up properly for Wine to work well. In order to
achieve this, this chapter will guide you through the necessary steps
to get the Wine files
installed on your system. It will <emphasis>not</emphasis>
deal with how to get Wine's Windows environment
<emphasis>configured</emphasis>; that's what the next chapter
will talk about.
</para>
<para>
When installing Wine, you should make sure that it doesn't happen
to overwrite a previous Wine installation (as this would cause
an overwhelming amount of annoying and fatal conflicts);
uninstalling any previous Wine version (as explained in this chapter)
to avoid this problem is recommended.
</para>
<sect1 id="installing-package">
<title>Installing or uninstalling Wine packages</title>
<para>
Now that you have downloaded the Debian or RPM or whatever Wine
package file, probably via the instructions given in the
previous chapter, you may be wondering "What in the world do I
do with this thing?".
This section will hopefully be able to put an end to your
bewildered questioning, by giving detailed install instructions
for all sorts of well-known package types.
</para>
<sect2>
<title>Debian Linux</title>
<para>
In case you haven't downloaded and automatically installed the
Wine package file via <command>apt-get</command> as described
in the <link linkend="getting-wine">Getting Wine</link>
section, you now need to use <command>dpkg</command> to
install it. Switch to the directory you downloaded the Debian
.deb package file to. Once there, type these commands,
adapting the package file name as required:
</para>
<screen>
<prompt>$ </><userinput>su -</>
Password:
<prompt># </><userinput>cd /home/user</>
<prompt># </><userinput>dpkg -i wine_<replaceable>0.0.20030115-1</>.deb</>
</screen>
<para>
(Type the root password at the "Password:" prompt)
</para>
<para>
You may also want to install the
<systemitem>wine-doc</systemitem> package, and if you are
using Wine from the 2.3 distribution (Woody), the
<systemitem>wine-utils</systemitem> package as well.
</para>
<para>
Uninstalling an installed Wine Debian package can be done by
running:
</para>
<screen>
<prompt># </><userinput>dpkg -l|grep wine</>
</screen>
<para>
The second column of the output (if any) of this command will
indicate the installed packages dealing with "wine".
The corresponding packages can be uninstalled by running:
</para>
<screen>
<prompt># </><userinput>dpkg -r <replaceable>&lt;package_name&gt;</></>
</screen>
<para>
where &lt;package_name&gt; is the name of the Wine-related package
which you want to uninstall.
</para>
</sect2>
<sect2>
<title>Linux Red Hat, Mandrake, SUSE and other distributions using RPM</title>
<para>
Most distributions provide a graphical tool for installing
RPM packages, you can use it by simply clicking (Or double clicking,
depending on your system settings) on the RPM. If you don't have a
graphical RPM manager installed, using a shell, switch to the
directory where you downloaded the RPM package file to.
Once there, type this one command as root, adapting the
package file name as required:
</para>
<screen>
<prompt># </><userinput>rpm -ivh wine-<replaceable>20031212.i386</>.rpm</>
</screen>
<para>
You may also want to install the
<systemitem>wine-devel</systemitem> package.
</para>
<para>
If you've installed wine graphically, you can uninstall it
using your graphical RPM manager (Gnorpm, Kpackage, Yast,
Mandrake Control Center and so on), alternatively, uninstalling
a installed Wine RPM package can be done from a shell, by running:
</para>
<screen>
<prompt># </><userinput>rpm -qa|grep -i wine</>
</screen>
<para>
This command will indicate the installed packages dealing with "wine".
The corresponding packages can be uninstalled by running:
</para>
<screen>
<prompt># </><userinput>rpm -e <replaceable>&lt;package_name&gt;</></>
</screen>
<para>
where &lt;package_name&gt; is the name of the Wine-related package
which you want to uninstall.
</para>
</sect2>
</sect1>
<sect1 id="installing-source">
<title>Installing or uninstalling a Wine source code tree</title>
<para>
If you are in the directory of the Wine version that you just
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>:
</para>
<screen>
<prompt># </><userinput>make install</>
</screen>
<para>
This will copy the Wine binary files to their final destination
in your system. You can then proceed to the <link
linkend="config-wine-main">Configuration chapter</link> to
configure the Wine environment.
</para>
<para>
If instead you want to uninstall the currently installed Wine
source code version, then change to the main directory of this
version and run as <glossterm>root</glossterm>:
</para>
<screen>
<prompt># </><userinput>make uninstall</>
</screen>
</sect1>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-parent-document:("wine-user.sgml" "set" "book" "chapter" "")
End:
-->
documentation/introduction.sgml
View file @ d6828ebb
......@@ -42,9 +42,7 @@
date Wine install. The first step, <link
linkend="getting-wine">Getting Wine</link>, illustrates the
various methods of getting Wine's files onto your computer.
The second step, <link linkend="installing">Installing
Wine</link>, details the various install processes available to
you. The third step, <link linkend="config-wine-main">Configuring
The second step, <link linkend="config-wine-main">Configuring
Wine</link>, shows how to customize a Wine installation depending
on your individual needs. The final step, <link
linkend="running">Running Wine</link>, covers the specific
......
documentation/wine-user.sgml
View file @ d6828ebb
......@@ -2,8 +2,6 @@
<!entity introduction SYSTEM "introduction.sgml">
<!entity getting SYSTEM "getting.sgml">
<!entity compiling SYSTEM "compiling.sgml">
<!entity installing SYSTEM "installing.sgml">
<!entity configuring SYSTEM "configuring.sgml">
<!entity registry SYSTEM "registry.sgml">
<!entity fonts SYSTEM "fonts.sgml">
......@@ -20,6 +18,14 @@
we can't really incude it -->
<!--authorgroup>
<author>
<firstname>Scott</firstname>
<surname>Ritchie</surname>
</author>
<author>
<firstname>Brian</firstname>
<surname>Vincent</surname>
</author>
<author>
<firstname>Huw</firstname>
<surname>Davies</surname>
</author>
......@@ -76,8 +82,6 @@
&introduction;
&getting;
&compiling;
&installing;
&configuring;
&running;
&bugs;
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment