ReceiveTempSMS
/
Sweden-Number
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Begin to uniformize sample commands in documentation.

This commit is contained in:
Vincent Béron 2003-07-21 22:23:38 +00:00 committed by Alexandre Julliard
parent 7006ab1450
commit 473d7ac0dd
5 changed files with 190 additions and 259 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

245
documentation/configuring.sgml
View File

@ -114,9 +114,9 @@
If you're using Debian, simply install the winesetuptk If you're using Debian, simply install the winesetuptk
package (as root): package (as root):
</para> </para>
<screen> <screen>
<prompt># </prompt><userinput>apt-get install winesetuptk</userinput> <prompt># </prompt><userinput>apt-get install winesetuptk</userinput>
</screen> </screen>
<para> <para>
If you're using another distribution, search for the package on If you're using another distribution, search for the package on
the net. the net.
@ -138,9 +138,9 @@
tree, change to the main directory of it and then run (as tree, change to the main directory of it and then run (as
user): user):
</para> </para>
<screen> <screen>
<prompt>$ </prompt><userinput>./tools/wineinstall</userinput> <prompt>$ </prompt><userinput>./tools/wineinstall</userinput>
</screen> </screen>
<para> <para>
Doing so will compile Wine, install Wine and configure the Doing so will compile Wine, install Wine and configure the
Wine environment (either by providing access to a Windows Wine environment (either by providing access to a Windows
@ -176,10 +176,10 @@
To run it, run in a <glossterm>terminal</glossterm> in the Wine source tree directory: To run it, run in a <glossterm>terminal</glossterm> in the Wine source tree directory:
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>cd tools</> <prompt>$ </><userinput>cd tools</>
<prompt>$ </><userinput>perl ./winecheck</> <prompt>$ </><userinput>perl ./winecheck</>
</screen> </screen>
<para> <para>
The winecheck output will be a percentage score indicating Wine The winecheck output will be a percentage score indicating Wine
configuration correctness. configuration correctness.
@ -288,10 +288,10 @@
need to copy over our sample configuration file to the need to copy over our sample configuration file to the
standard Wine configuration file location, do in a standard Wine configuration file location, do in a
<glossterm>terminal</glossterm>: <glossterm>terminal</glossterm>:
<screen> <screen>
<prompt>$ </><userinput>mkdir ~/.wine/</> <prompt>$ </><userinput>mkdir ~/.wine/</>
<prompt>$ </><userinput>cp <replaceable>dir_to_wine_source_code</replaceable>/documentation/samples/config ~/.wine/config</> <prompt>$ </><userinput>cp <replaceable>dir_to_wine_source_code</replaceable>/documentation/samples/config ~/.wine/config</>
</screen> </screen>
Otherwise, simply use the already existing configuration file Otherwise, simply use the already existing configuration file
at <filename>~/.wine/config</filename>. at <filename>~/.wine/config</filename>.
</para> </para>
@ -519,8 +519,6 @@
</para> </para>
<para> <para>
<programlisting>"DefaultLoadOrder" =" native, builtin"</programlisting> <programlisting>"DefaultLoadOrder" =" native, builtin"</programlisting>
</para>
<para>
This setting is a comma-delimited list of the order in This setting is a comma-delimited list of the order in
which to attempt loading DLLs. If the first option fails, which to attempt loading DLLs. If the first option fails,
it will try the second, and so on. The order specified it will try the second, and so on. The order specified
@ -546,75 +544,59 @@
<title>The [DllOverrides] Section</title> <title>The [DllOverrides] Section</title>
<para> <para>
The format for this section is the same for each line: The format for this section is the same for each line:
<programlisting> <programlisting>&lt;DLL>{,&lt;DLL>,&lt;DLL>...} = &lt;FORM>{,&lt;FORM>,&lt;FORM>...}</programlisting>
&lt;DLL>{,&lt;DLL>,&lt;DLL>...} = &lt;FORM>{,&lt;FORM>,&lt;FORM>...}
</programlisting>
</para>
<para>
For example, to load built-in KERNEL pair (case doesn't For example, to load built-in KERNEL pair (case doesn't
matter here): matter here):
<programlisting> <programlisting>"kernel,kernel32" = "builtin"</programlisting>
"kernel,kernel32" = "builtin"
</programlisting>
</para>
<para>
To load the native COMMDLG pair, but if that doesn't work To load the native COMMDLG pair, but if that doesn't work
try built-in: try built-in:
<programlisting> <programlisting>"commdlg,comdlg32" = "native, builtin"</programlisting>
"commdlg,comdlg32" = "native, builtin"
</programlisting>
</para>
<para>
To load the native COMCTL32: To load the native COMCTL32:
<programlisting> <programlisting>"comctl32" = "native"</programlisting>
"comctl32" = "native"
</programlisting>
</para>
<para>
Here is a good generic setup (As it is defined in config Here is a good generic setup (As it is defined in config
that was included with your wine package): that was included with your wine package):
<programlisting> <programlisting>
[DllOverrides] [DllOverrides]
"rpcrt4" = "builtin, native" "rpcrt4" = "builtin, native"
"oleaut32" = "builtin, native" "oleaut32" = "builtin, native"
"ole32" = "builtin, native" "ole32" = "builtin, native"
"commdlg" = "builtin, native" "commdlg" = "builtin, native"
"comdlg32" = "builtin, native" "comdlg32" = "builtin, native"
"ver" = "builtin, native" "ver" = "builtin, native"
"version" = "builtin, native" "version" = "builtin, native"
"shell" = "builtin, native" "shell" = "builtin, native"
"shell32" = "builtin, native" "shell32" = "builtin, native"
"shfolder" = "builtin, native" "shfolder" = "builtin, native"
"shlwapi" = "builtin, native" "shlwapi" = "builtin, native"
"shdocvw" = "builtin, native" "shdocvw" = "builtin, native"
"lzexpand" = "builtin, native" "lzexpand" = "builtin, native"
"lz32" = "builtin, native" "lz32" = "builtin, native"
"comctl32" = "builtin, native" "comctl32" = "builtin, native"
"commctrl" = "builtin, native" "commctrl" = "builtin, native"
"advapi32" = "builtin, native" "advapi32" = "builtin, native"
"crtdll" = "builtin, native" "crtdll" = "builtin, native"
"mpr" = "builtin, native" "mpr" = "builtin, native"
"winspool.drv" = "builtin, native" "winspool.drv" = "builtin, native"
"ddraw" = "builtin, native" "ddraw" = "builtin, native"
"dinput" = "builtin, native" "dinput" = "builtin, native"
"dsound" = "builtin, native" "dsound" = "builtin, native"
"opengl32" = "builtin, native" "opengl32" = "builtin, native"
"msvcrt" = "native, builtin" "msvcrt" = "native, builtin"
"msvideo" = "builtin, native" "msvideo" = "builtin, native"
"msvfw32" = "builtin, native" "msvfw32" = "builtin, native"
"mcicda.drv" = "builtin, native" "mcicda.drv" = "builtin, native"
"mciseq.drv" = "builtin, native" "mciseq.drv" = "builtin, native"
"mciwave.drv" = "builtin, native" "mciwave.drv" = "builtin, native"
"mciavi.drv" = "native, builtin" "mciavi.drv" = "native, builtin"
"mcianim.drv" = "native, builtin" "mcianim.drv" = "native, builtin"
"msacm.drv" = "builtin, native" "msacm.drv" = "builtin, native"
"msacm" = "builtin, native" "msacm" = "builtin, native"
"msacm32" = "builtin, native" "msacm32" = "builtin, native"
"midimap.drv" = "builtin, native" "midimap.drv" = "builtin, native"
; you can specify programs too ; you can specify programs too
"notepad.exe" = "native, builtin" "notepad.exe" = "native, builtin"
; default for all other DLLs ; default for all other DLLs
"*" = "native, builtin" "*" = "native, builtin"
</programlisting> </programlisting>
</para> </para>
<note> <note>
@ -632,8 +614,6 @@
</para> </para>
<para> <para>
<programlisting>"Resolution" = "96"</programlisting> <programlisting>"Resolution" = "96"</programlisting>
</para>
<para>
Since the way X handles fonts is different from the way Since the way X handles fonts is different from the way
Windows does, wine uses a special mechanism to deal with Windows does, wine uses a special mechanism to deal with
them. It must scale them using the number defined in the them. It must scale them using the number defined in the
@ -656,11 +636,7 @@
The <literal>Alias</literal> setting allows you to map an X font to a font The <literal>Alias</literal> setting allows you to map an X font to a font
used in wine. This is good for apps that need a special font you don't have, used in wine. This is good for apps that need a special font you don't have,
but a good replacement exists. The syntax is like so: but a good replacement exists. The syntax is like so:
<programlisting> <programlisting>"AliasX" = "[Fake windows name],[Real X name]"&lt;,optional "masking" section></programlisting>
"AliasX" = "[Fake windows name],[Real X name]"&lt;,optional "masking" section>
</programlisting>
</para>
<para>
Pretty straightforward. Replace "AliasX" with "Alias0", Pretty straightforward. Replace "AliasX" with "Alias0",
then "Alias1" and so on. The fake windows name is the name then "Alias1" and so on. The fake windows name is the name
that the font will be under a windows app in wine. The that the font will be under a windows app in wine. The
@ -673,19 +649,10 @@
<para> <para>
Here is an example of an alias without masking. The font will show up in windows Here is an example of an alias without masking. The font will show up in windows
apps as "Google". apps as "Google".
<programlisting>"Alias0" = "Foo,--google-"</programlisting>
<programlisting>
"Alias0" = "Foo,--google-"
</programlisting>
</para>
<para>
Here is an example with masking enabled. The font will show up as "Foo" in Here is an example with masking enabled. The font will show up as "Foo" in
windows apps. windows apps.
<programlisting> <programlisting>"Alias1" = "Foo,--google-,subst"</programlisting>
"Alias1" = "Foo,--google-,subst"
</programlisting>
</para>
<para>
For more information check out the <link linkend="config-fonts-main">Fonts</link> For more information check out the <link linkend="config-fonts-main">Fonts</link>
chapter. chapter.
</para> </para>
@ -702,8 +669,6 @@
The [serialports] section tells wine what serial ports it The [serialports] section tells wine what serial ports it
is allowed to use. is allowed to use.
<programlisting>"ComX" = "/dev/ttySY"</programlisting> <programlisting>"ComX" = "/dev/ttySY"</programlisting>
</para>
<para>
Replace <literal>X</literal> with the number of the COM Replace <literal>X</literal> with the number of the COM
port in Windows (1-8) and <literal>Y</literal> with the port in Windows (1-8) and <literal>Y</literal> with the
number of it in <literal>X</literal> (Usually the number number of it in <literal>X</literal> (Usually the number
@ -713,8 +678,6 @@
not always necessary to define any COM ports (An optional not always necessary to define any COM ports (An optional
setting). Here is an example: setting). Here is an example:
<programlisting>"Com1" = "/dev/ttyS0"</programlisting> <programlisting>"Com1" = "/dev/ttyS0"</programlisting>
</para>
<para>
Use as many of these as you like in the section to define Use as many of these as you like in the section to define
all of the COM ports you need. all of the COM ports you need.
</para> </para>
@ -722,8 +685,6 @@
The [parallelports] section sets up any parallel ports The [parallelports] section sets up any parallel ports
that will be allowed access under wine. that will be allowed access under wine.
<programlisting>"LptX" = "/dev/lpY"</programlisting> <programlisting>"LptX" = "/dev/lpY"</programlisting>
</para>
<para>
Sounds familiar? Syntax is just like the COM port setting. Sounds familiar? Syntax is just like the COM port setting.
Replace <literal>X</literal> with a value from 1-4 as it Replace <literal>X</literal> with a value from 1-4 as it
is in Windows and <literal>Y</literal> with a value from is in Windows and <literal>Y</literal> with a value from
@ -733,8 +694,6 @@
the other section, LptX can equal any device (Maybe the other section, LptX can equal any device (Maybe
<medialabel>/dev/printer</medialabel>). Here is an <medialabel>/dev/printer</medialabel>). Here is an
example: <programlisting>"Lpt1" = "/dev/lp0"</programlisting> example: <programlisting>"Lpt1" = "/dev/lp0"</programlisting>
</para>
<para>
The [spooler] section will inform wine where to spool The [spooler] section will inform wine where to spool
print jobs. Use this if you want to try printing. Wine print jobs. Use this if you want to try printing. Wine
docs claim that spooling is "rather primitive" at this docs claim that spooling is "rather primitive" at this
@ -743,13 +702,9 @@
for example) to a file or a command. Here is an example, for example) to a file or a command. Here is an example,
mapping LPT1 to the file <filename>out.ps</filename>: mapping LPT1 to the file <filename>out.ps</filename>:
<programlisting>"LPT1:" = "out.ps"</programlisting> <programlisting>"LPT1:" = "out.ps"</programlisting>
</para>
<para>
The following command maps printing jobs to LPT1 to the The following command maps printing jobs to LPT1 to the
command <command>lpr</command>. Notice the |: command <command>lpr</command>. Notice the |:
<programlisting>"LPT1:" = "|lpr"</programlisting> <programlisting>"LPT1:" = "|lpr"</programlisting>
</para>
<para>
The [ports] section is usually useful only for people who The [ports] section is usually useful only for people who
need direct port access for programs requiring dongles or need direct port access for programs requiring dongles or
scanners. <emphasis>If you don't need it, don't use scanners. <emphasis>If you don't need it, don't use
@ -1004,9 +959,7 @@
configuration on Linux, then <emphasis>make sure</emphasis> to add configuration on Linux, then <emphasis>make sure</emphasis> to add
the <quote>unhide</quote> mount option to the CD-ROM file system the <quote>unhide</quote> mount option to the CD-ROM file system
entry in <filename>/etc/fstab</filename>, e.g.: entry in <filename>/etc/fstab</filename>, e.g.:
<programlisting> <programlisting>/dev/cdrom /cdrom iso9660 ro,noauto,users,unhide 0 0</programlisting>
/dev/cdrom /cdrom iso9660 ro,noauto,users,unhide 0 0
</programlisting>
Several Windows program setup CD-ROMs or other CD-ROMs chose Several Windows program setup CD-ROMs or other CD-ROMs chose
to do such braindamaged things as marking very important setup to do such braindamaged things as marking very important setup
helper files on the CD-ROM as <quote>hidden</quote>. helper files on the CD-ROM as <quote>hidden</quote>.
@ -1296,11 +1249,7 @@ And here is a setup for Drive A, a generic floppy drive:
access</emphasis>!! access</emphasis>!!
</para> </para>
<para> <para>
<programlisting> <programlisting>"Path" = "c:\\windows;c:\\windows\\system;c:\\blanco"</programlisting>
"Path" = "c:\\windows;c:\\windows\\system;c:\\blanco"
</programlisting>
</para>
<para>
Behaves like the <envar>PATH</envar> setting on UNIX Behaves like the <envar>PATH</envar> setting on UNIX
boxes. When wine is run like <userinput>wine boxes. When wine is run like <userinput>wine
sol.exe</userinput>, if <filename>sol.exe</filename> sol.exe</userinput>, if <filename>sol.exe</filename>
@ -1313,9 +1262,7 @@ And here is a setup for Drive A, a generic floppy drive:
<filename>"c:\\windows;c:\\windows\\system"</filename>). <filename>"c:\\windows;c:\\windows\\system"</filename>).
</para> </para>
<para id="dirsymlinks"> <para id="dirsymlinks">
<programlisting> <programlisting>"ShowDirSymlinks" = "1"</programlisting>
"ShowDirSymlinks" = "1"
</programlisting>
Wine doesn't pass directory symlinks to Windows programs by Wine doesn't pass directory symlinks to Windows programs by
default, as doing so may crash some programs that do default, as doing so may crash some programs that do
recursive lookups of whole subdirectory trees recursive lookups of whole subdirectory trees
@ -1626,9 +1573,9 @@ And here is a setup for Drive A, a generic floppy drive:
from a <filename>~/.wine/config</filename> file does this: from a <filename>~/.wine/config</filename> file does this:
</para> </para>
<programlisting> <programlisting>
[Drive C] [Drive C]
"Path" = "/c" "Path" = "/c"
"Type" = "hd" "Type" = "hd"
</programlisting> </programlisting>
<para> <para>
Although VFAT filesystems are preferable to FAT filesystems Although VFAT filesystems are preferable to FAT filesystems
@ -1646,13 +1593,13 @@ And here is a setup for Drive A, a generic floppy drive:
either case, by default, the permissions will probably be either case, by default, the permissions will probably be
configured so that they look like: configured so that they look like:
</para> </para>
<screen> <screen>
<prompt>~></prompt><userinput>cd /c</userinput> <prompt>~></prompt><userinput>cd /c</userinput>
<prompt>/c></prompt><userinput>ls -l</userinput> <prompt>/c></prompt><userinput>ls -l</userinput>
<computeroutput>-rwxr-xr-x 1 root root 91 Oct 10 17:58 autoexec.bat <computeroutput>-rwxr-xr-x 1 root root 91 Oct 10 17:58 autoexec.bat
-rwxr-xr-x 1 root root 245 Oct 10 17:58 config.sys -rwxr-xr-x 1 root root 245 Oct 10 17:58 config.sys
drwxr-xr-x 41 root root 16384 Dec 30 1998 windows</computeroutput> drwxr-xr-x 41 root root 16384 Dec 30 1998 windows</computeroutput>
</screen> </screen>
<para> <para>
where all the files are owned by "root", are in the "root" where all the files are owned by "root", are in the "root"
group and are only writable by "root" group and are only writable by "root"
@ -1714,20 +1661,20 @@ And here is a setup for Drive A, a generic floppy drive:
results in the files on the FAT filesystem having permissions similar results in the files on the FAT filesystem having permissions similar
to files created by root. For example: to files created by root. For example:
</para> </para>
<screen> <screen>
<prompt>~></prompt><userinput>whoami</userinput> <prompt>~></prompt><userinput>whoami</userinput>
<computeroutput>root</computeroutput> <computeroutput>root</computeroutput>
<prompt>~></prompt><userinput>touch root_file</userinput> <prompt>~></prompt><userinput>touch root_file</userinput>
<prompt>~></prompt><userinput>ls -l root_file</userinput> <prompt>~></prompt><userinput>ls -l root_file</userinput>
<computeroutput></computeroutput>-rw-r--r-- 1 root root 0 Dec 10 00:20 root_file <computeroutput></computeroutput>-rw-r--r-- 1 root root 0 Dec 10 00:20 root_file
</screen> </screen>
<para> <para>
which matches the owner, group and permissions of files seen which matches the owner, group and permissions of files seen
on the FAT filesystem except for the missing 'x's. The on the FAT filesystem except for the missing 'x's. The
permissions on the FAT filesystem can be changed by changing permissions on the FAT filesystem can be changed by changing
root's umask (unset permissions bits). For example: root's umask (unset permissions bits). For example:
</para> </para>
<screen> <screen>
<prompt>~></prompt><userinput>umount /c</userinput> <prompt>~></prompt><userinput>umount /c</userinput>
<prompt>~></prompt><userinput>umask</userinput> <prompt>~></prompt><userinput>umask</userinput>
<computeroutput>022</computeroutput> <computeroutput>022</computeroutput>
@ -1738,7 +1685,7 @@ And here is a setup for Drive A, a generic floppy drive:
<computeroutput>-rwx---r-- 1 root root 91 Oct 10 17:58 autoexec.bat <computeroutput>-rwx---r-- 1 root root 91 Oct 10 17:58 autoexec.bat
-rwx---r-- 1 root root 245 Oct 10 17:58 config.sys -rwx---r-- 1 root root 245 Oct 10 17:58 config.sys
drwx---r-- 41 root root 16384 Dec 30 1998 windows</computeroutput> drwx---r-- 41 root root 16384 Dec 30 1998 windows</computeroutput>
</screen> </screen>
<para> <para>
Mounting the FAT filesystem with a umask of Mounting the FAT filesystem with a umask of
<literal>000</literal> gives all users complete control over <literal>000</literal> gives all users complete control over
@ -1749,7 +1696,7 @@ And here is a setup for Drive A, a generic floppy drive:
and <literal>umask</literal>. They can each be specified and <literal>umask</literal>. They can each be specified
when the filesystem is manually mounted. For example: when the filesystem is manually mounted. For example:
</para> </para>
<screen> <screen>
<prompt>~></prompt><userinput>umount /c</userinput> <prompt>~></prompt><userinput>umount /c</userinput>
<prompt>~></prompt><userinput>mount -o uid=500 -o gid=500 -o umask=002 /c</userinput> <prompt>~></prompt><userinput>mount -o uid=500 -o gid=500 -o umask=002 /c</userinput>
<prompt>~></prompt><userinput>cd /c</userinput> <prompt>~></prompt><userinput>cd /c</userinput>
@ -1757,17 +1704,17 @@ And here is a setup for Drive A, a generic floppy drive:
<computeroutput>-rwxrwxr-x 1 sle sle 91 Oct 10 17:58 autoexec.bat <computeroutput>-rwxrwxr-x 1 sle sle 91 Oct 10 17:58 autoexec.bat
-rwxrwxr-x 1 sle sle 245 Oct 10 17:58 config.sys -rwxrwxr-x 1 sle sle 245 Oct 10 17:58 config.sys
drwxrwxr-x 41 sle sle 16384 Dec 30 1998 windows</computeroutput> drwxrwxr-x 41 sle sle 16384 Dec 30 1998 windows</computeroutput>
</screen> </screen>
<para> <para>
which gives "sle" complete control over which gives "sle" complete control over
<filename>/c</filename>. The options listed above can be <filename>/c</filename>. The options listed above can be
made permanent by adding them to the made permanent by adding them to the
<filename>/etc/fstab</filename> file: <filename>/etc/fstab</filename> file:
</para> </para>
<screen> <screen>
<prompt>~></prompt><userinput>grep /c /etc/fstab</userinput> <prompt>~></prompt><userinput>grep /c /etc/fstab</userinput>
<computeroutput>/dev/hda1 /c vfat uid=500,gid=500,umask=002,exec,dev,suid,rw 1 1</computeroutput> <computeroutput>/dev/hda1 /c vfat uid=500,gid=500,umask=002,exec,dev,suid,rw 1 1</computeroutput>
</screen> </screen>
<para> <para>
Note that the umask of <literal>002</literal> is common in Note that the umask of <literal>002</literal> is common in
the user private group file permission scheme. On FAT file the user private group file permission scheme. On FAT file
@ -1795,7 +1742,7 @@ And here is a setup for Drive A, a generic floppy drive:
lack of root access. On this system a shadow directory lack of root access. On this system a shadow directory
might be set up in the following manner: might be set up in the following manner:
</para> </para>
<screen> <screen>
<prompt>~></prompt><userinput>cd /</userinput> <prompt>~></prompt><userinput>cd /</userinput>
<prompt>/></prompt><userinput>mkdir c_shadow</userinput> <prompt>/></prompt><userinput>mkdir c_shadow</userinput>
<prompt>/></prompt><userinput>cd c_shadow</userinput> <prompt>/></prompt><userinput>cd c_shadow</userinput>
@ -1803,8 +1750,8 @@ And here is a setup for Drive A, a generic floppy drive:
<prompt>/c_shadow></prompt><userinput>rm windows AnApp</userinput> <prompt>/c_shadow></prompt><userinput>rm windows AnApp</userinput>
<prompt>/c_shadow></prompt><userinput>cp -R /c_/{windows,AnApp} .</userinput> <prompt>/c_shadow></prompt><userinput>cp -R /c_/{windows,AnApp} .</userinput>
<prompt>/c_shadow></prompt><userinput>chmod -R 777 windows AnApp</userinput> <prompt>/c_shadow></prompt><userinput>chmod -R 777 windows AnApp</userinput>
<prompt>/c_shadow></prompt><userinput>perl -p -i -e 's|/c$|/c_shadow|g' ~/.wine/config</userinput> <prompt>/c_shadow></prompt><userinput>perl -p -i -e 's|/c$|/c_shadow|g' ~/.wine/config</userinput>
</screen> </screen>
<para> <para>
The above gives everyone complete read and write access to The above gives everyone complete read and write access to
the <filename>windows</filename> and the <filename>windows</filename> and
@ -1922,31 +1869,31 @@ And here is a setup for Drive A, a generic floppy drive:
read from the device on both CD-ROM and floppy; serial read from the device on both CD-ROM and floppy; serial
numbers on floppy only: numbers on floppy only:
</para> </para>
<screen> <programlisting>
[Drive A] [Drive A]
"Path" = "/mnt/floppy" "Path" = "/mnt/floppy"
"Type" = "floppy" "Type" = "floppy"
"Device" = "/dev/fd0" "Device" = "/dev/fd0"
"Filesystem" = "msdos" "Filesystem" = "msdos"
[Drive R] [Drive R]
"Path" = "/mnt/cdrom" "Path" = "/mnt/cdrom"
"Type" = "cdrom" "Type" = "cdrom"
"Device" = "/dev/hda1" "Device" = "/dev/hda1"
"Filesystem" = "win95" "Filesystem" = "win95"
</screen> </programlisting>
<para> <para>
Here's an example of overriding the CD-ROM label: Here's an example of overriding the CD-ROM label:
</para> </para>
<screen> <programlisting>
[Drive J] [Drive J]
"Path" = "/mnt/cdrom" "Path" = "/mnt/cdrom"
"Type" = "cdrom" "Type" = "cdrom"
"Label" = "X234GCDSE" "Label" = "X234GCDSE"
; note that the device isn't really needed here as we have a fixed label ; note that the device isn't really needed here as we have a fixed label
"Device" = "/dev/cdrom" "Device" = "/dev/cdrom"
"Filesystem" = "msdos" "Filesystem" = "msdos"
</screen> </programlisting>
</sect3> </sect3>
<sect3> <sect3>

122
documentation/getting.sgml
View File

@ -265,11 +265,10 @@
<title>Red Hat Linux</title> <title>Red Hat Linux</title>
<para> <para>
Red Hat users can use <ulink url="http://rpmfind.net/linux/RPM/"> Red Hat users can use the
rpmfind.net</ulink> to track down available Wine RPM binaries. <ulink url="http://sourceforge.net/project/showfiles.php?group_id=6241">
<ulink url="http://rpmfind.net/linux/RPM/WByName.html">This sourceforge.net Wine page</ulink> to get the RPM most suitable for
page</ulink> contains a list of all rpmfind packages that start with their system.
the letter "W", including a few Wine packages.
</para> </para>
</sect2> </sect2>
@ -301,12 +300,12 @@
If you want to install Wine from the FreeBSD CD-ROM, run in a If you want to install Wine from the FreeBSD CD-ROM, run in a
<glossterm>terminal</glossterm>: <glossterm>terminal</glossterm>:
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>su -</> <prompt>$ </><userinput>su -</>
<prompt># </><userinput>mount /cdrom</> <prompt># </><userinput>mount /cdrom</>
<prompt># </><userinput>cd /cdrom/packages/All</> <prompt># </><userinput>cd /cdrom/packages/All</>
<prompt># </><userinput>pkg_add wine_.X.X.X.tgz</> <prompt># </><userinput>pkg_add wine_.X.X.X.tgz</>
</screen> </screen>
<para> <para>
</para> </para>
<para> <para>
@ -407,22 +406,8 @@
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<ulink url="ftp://ftp.infomagic.com/pub/mirrors/linux/sunsite/ALPHA/wine/development/"> <ulink url="http://prdownloads.sourceforge.net/wine/">
ftp://ftp.infomagic.com/pub/mirrors/linux/sunsite/ALPHA/wine/development/ http://prdownloads.sourceforge.net/wine/
</ulink>
</para>
</listitem>
<listitem>
<para>
<ulink url="ftp://ftp.fu-berlin.de/unix/linux/mirrors/sunsite.unc.edu/ALPHA/wine/development/">
ftp://ftp.fu-berlin.de/unix/linux/mirrors/sunsite.unc.edu/ALPHA/wine/development/
</ulink>
</para>
</listitem>
<listitem>
<para>
<ulink url="ftp://orcus.progsoc.uts.edu.au/pub/Wine/development/">
ftp://orcus.progsoc.uts.edu.au/pub/Wine/development/
</ulink> </ulink>
</para> </para>
</listitem> </listitem>
@ -443,9 +428,9 @@
switch to the directory containing the file you just switch to the directory containing the file you just
downloaded. Then extract the source in a downloaded. Then extract the source in a
<glossterm>terminal</glossterm> with (e.g.): <glossterm>terminal</glossterm> with (e.g.):
<screen> <screen>
<prompt>$ </><userinput>tar xvzf wine-<replaceable>20030115</>.tar.gz</> <prompt>$ </><userinput>tar xvzf wine-<replaceable>20030115</>.tar.gz</>
</screen> </screen>
</para> </para>
<para> <para>
Just in case you happen to get a Wine archive that uses Just in case you happen to get a Wine archive that uses
@ -484,9 +469,9 @@
To check whether this is the case, please run in a To check whether this is the case, please run in a
<glossterm>terminal</glossterm>: <glossterm>terminal</glossterm>:
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>cvs</> <prompt>$ </><userinput>cvs</>
</screen> </screen>
<para> <para>
If this was successful, then you should have gotten a nice CVS If this was successful, then you should have gotten a nice CVS
"Usage" help output. Otherwise (e.g. an error "cvs: command "Usage" help output. Otherwise (e.g. an error "cvs: command
@ -503,9 +488,9 @@
<para> <para>
First, you should do a First, you should do a
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>touch ~/.cvspass</> <prompt>$ </><userinput>touch ~/.cvspass</>
</screen> </screen>
<para> <para>
to create or update the file <filename>.cvspass</filename> in to create or update the file <filename>.cvspass</filename> in
your home directory, since CVS needs this file (for password your home directory, since CVS needs this file (for password
@ -527,9 +512,9 @@ checkout -P
</programlisting> </programlisting>
Create the file with an <glossterm>editor</glossterm> Create the file with an <glossterm>editor</glossterm>
of your choice, either by running of your choice, either by running
<screen> <screen>
<prompt>$ </><userinput>&lt;editor&gt; ~/.cvsrc</> <prompt>$ </><userinput>&lt;editor&gt; ~/.cvsrc</>
</screen> </screen>
, where &lt;editor&gt; is the editor you want to use (e.g. , where &lt;editor&gt; is the editor you want to use (e.g.
<command>joe</command>, <command>ae</command>, <command>joe</command>, <command>ae</command>,
<command>vi</command>), <command>vi</command>),
@ -548,9 +533,9 @@ checkout -P
server and checkout (download) the Wine source code. server and checkout (download) the Wine source code.
First, let's do the server login: First, let's do the server login:
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>cvs -d :pserver:cvs@cvs.winehq.com:/home/wine login</> <prompt>$ </><userinput>cvs -d :pserver:cvs@cvs.winehq.com:/home/wine login</>
</screen> </screen>
<para> <para>
If <command>cvs</command> successfully connects to the CVS server, If <command>cvs</command> successfully connects to the CVS server,
then you will get a "CVS password:" prompt. then you will get a "CVS password:" prompt.
@ -568,9 +553,9 @@ checkout -P
might be your user's home directory. might be your user's home directory.
To download the Wine tree into the subdirectory <filename>wine/</filename>, run: To download the Wine tree into the subdirectory <filename>wine/</filename>, run:
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>cvs -d :pserver:cvs@cvs.winehq.com:/home/wine checkout wine</> <prompt>$ </><userinput>cvs -d :pserver:cvs@cvs.winehq.com:/home/wine checkout wine</>
</screen> </screen>
<para> <para>
Downloading the CVS tree might take a while (some minutes Downloading the CVS tree might take a while (some minutes
to few hours), depending on your connection speed. to few hours), depending on your connection speed.
@ -579,24 +564,24 @@ checkout -P
<filename>wine/</filename> directory is in, by running <filename>wine/</filename> directory is in, by running
<command>pwd</command> (Print Working Directory): <command>pwd</command> (Print Working Directory):
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>pwd</> <prompt>$ </><userinput>pwd</>
</screen> </screen>
<para> <para>
Later, you will be able to change to this directory by Later, you will be able to change to this directory by
running: running:
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>cd <replaceable>&lt;some_dir&gt;</></> <prompt>$ </><userinput>cd <replaceable>&lt;some_dir&gt;</></>
</screen> </screen>
<para> <para>
, where &lt;some_dir&gt; is the directory that , where &lt;some_dir&gt; is the directory that
<command>pwd</command> gave you. <command>pwd</command> gave you.
By running By running
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>cd wine</> <prompt>$ </><userinput>cd wine</>
</screen> </screen>
<para> <para>
, you can now change to the directory of the Wine CVS tree , you can now change to the directory of the Wine CVS tree
you just downloaded. Since you now have a fully working Wine you just downloaded. Since you now have a fully working Wine
@ -621,10 +606,10 @@ checkout -P
To proceed with updating Wine, simply <command>cd</command> To proceed with updating Wine, simply <command>cd</command>
to the Wine CVS tree directory, then run: to the Wine CVS tree directory, then run:
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>make distclean</> <prompt>$ </><userinput>make distclean</>
<prompt>$ </><userinput>cvs -d :pserver:cvs@cvs.winehq.com:/home/wine update</> <prompt>$ </><userinput>cvs -d :pserver:cvs@cvs.winehq.com:/home/wine update</>
</screen> </screen>
<para> <para>
The <command>make distclean</command> part is optional, but The <command>make distclean</command> part is optional, but
it's a good idea to remove old build and compile configuration it's a good idea to remove old build and compile configuration
@ -645,16 +630,16 @@ checkout -P
mailing list</>, and received a patch file to fix the bug. mailing list</>, and received a patch file to fix the bug.
You can apply the patch with the <command>patch</> command, You can apply the patch with the <command>patch</> command,
which takes a streamed patch from <filename>stdin</>: which takes a streamed patch from <filename>stdin</>:
<screen> <screen>
<prompt>$ </><userinput>cd wine</> <prompt>$ </><userinput>cd wine</>
<prompt>$ </><userinput>patch -p0 &lt;<replaceable>../patch_to_apply.diff</></> <prompt>$ </><userinput>patch -p0 &lt;<replaceable>../patch_to_apply.diff</></>
</screen> </screen>
</para> </para>
<para> <para>
To remove the patch, use the <parameter>-R</> option: To remove the patch, use the <parameter>-R</> option:
<screen> <screen>
<prompt>$ </><userinput>patch -p0 -R &lt;<replaceable>../patch_to_apply.diff</></> <prompt>$ </><userinput>patch -p0 -R &lt;<replaceable>../patch_to_apply.diff</></>
</screen> </screen>
</para> </para>
<para> <para>
If you want to do a test run to see if the patch will apply If you want to do a test run to see if the patch will apply
@ -662,10 +647,9 @@ checkout -P
newer version of the tree), you can use the newer version of the tree), you can use the
<parameter>--dry-run</> parameter to run the patch <parameter>--dry-run</> parameter to run the patch
without writing to any files: without writing to any files:
<screen> <screen>
<prompt>$ </><userinput>patch -p0 --dry-run &lt;<replaceable>../patch_to_apply.d <prompt>$ </><userinput>patch -p0 --dry-run &lt;<replaceable>../patch_to_apply.diff</></>
iff</></> </screen>
</screen>
</para> </para>
<para> <para>
<command>patch</> is pretty smart about extracting <command>patch</> is pretty smart about extracting

54
documentation/installing.sgml
View File

@ -48,12 +48,12 @@
.deb package file to. Once there, type these commands, .deb package file to. Once there, type these commands,
adapting the package file name as required: adapting the package file name as required:
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>su -</> <prompt>$ </><userinput>su -</>
Password: Password:
<prompt># </><userinput>cd /home/user</> <prompt># </><userinput>cd /home/user</>
<prompt># </><userinput>dpkg -i wine_<replaceable>0.0.20030115-1</>.deb</> <prompt># </><userinput>dpkg -i wine_<replaceable>0.0.20030115-1</>.deb</>
</screen> </screen>
<para> <para>
(Type the root password at the "Password:" prompt) (Type the root password at the "Password:" prompt)
</para> </para>
@ -69,17 +69,17 @@ Password:
Uninstalling an installed Wine Debian package can be done by Uninstalling an installed Wine Debian package can be done by
running: running:
</para> </para>
<screen> <screen>
<prompt># </><userinput>dpkg -l|grep wine</> <prompt># </><userinput>dpkg -l|grep wine</>
</screen> </screen>
<para> <para>
The second column of the output (if any) of this command will The second column of the output (if any) of this command will
indicate the installed packages dealing with "wine". indicate the installed packages dealing with "wine".
The corresponding packages can be uninstalled by running: The corresponding packages can be uninstalled by running:
</para> </para>
<screen> <screen>
<prompt># </><userinput>dpkg -r <replaceable>&lt;package_name&gt;</></> <prompt># </><userinput>dpkg -r <replaceable>&lt;package_name&gt;</></>
</screen> </screen>
<para> <para>
where &lt;package_name&gt; is the name of the Wine-related package where &lt;package_name&gt; is the name of the Wine-related package
which you want to uninstall. which you want to uninstall.
@ -93,9 +93,9 @@ Password:
Once there, type this one command as root, adapting the Once there, type this one command as root, adapting the
package file name as required: package file name as required:
</para> </para>
<screen> <screen>
<prompt># </><userinput>rpm -ivh wine-<replaceable>20020605-2.i386</>.rpm</> <prompt># </><userinput>rpm -ivh wine-<replaceable>20020605-2.i386</>.rpm</>
</screen> </screen>
<para> <para>
You may also want to install the You may also want to install the
<systemitem>wine-devel</systemitem> package. <systemitem>wine-devel</systemitem> package.
@ -104,16 +104,16 @@ Password:
Uninstalling an installed Wine RPM package can be done by Uninstalling an installed Wine RPM package can be done by
running: running:
</para> </para>
<screen> <screen>
<prompt># </><userinput>rpm -qa|grep -i wine</> <prompt># </><userinput>rpm -qa|grep -i wine</>
</screen> </screen>
<para> <para>
This command will indicate the installed packages dealing with "wine". This command will indicate the installed packages dealing with "wine".
The corresponding packages can be uninstalled by running: The corresponding packages can be uninstalled by running:
</para> </para>
<screen> <screen>
<prompt># </><userinput>rpm -e <replaceable>&lt;package_name&gt;</></> <prompt># </><userinput>rpm -e <replaceable>&lt;package_name&gt;</></>
</screen> </screen>
<para> <para>
where &lt;package_name&gt; is the name of the Wine-related package where &lt;package_name&gt; is the name of the Wine-related package
which you want to uninstall. which you want to uninstall.
@ -128,9 +128,9 @@ Password:
If you are in the directory of the Wine version that you just 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>: 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> </para>
<screen> <screen>
<prompt># </><userinput>make install</> <prompt># </><userinput>make install</>
</screen> </screen>
<para> <para>
This will copy the Wine binary files to their final destination This will copy the Wine binary files to their final destination
in your system. You can then proceed to the <link in your system. You can then proceed to the <link
@ -143,9 +143,9 @@ Password:
source code version, then change to the main directory of this source code version, then change to the main directory of this
version and run as <glossterm>root</glossterm>: version and run as <glossterm>root</glossterm>:
</para> </para>
<screen> <screen>
<prompt># </><userinput>make uninstall</> <prompt># </><userinput>make uninstall</>
</screen> </screen>
</sect1> </sect1>
</chapter> </chapter>

2
documentation/introduction.sgml
View File

@ -520,7 +520,7 @@
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
<literallayout>A computer ;-)</literallayout> A computer ;-)
<literallayout> Wine: only PCs >= i386 are supported at the moment.</literallayout> <literallayout> Wine: only PCs >= i386 are supported at the moment.</literallayout>
<literallayout> Winelib: selected other platforms are supported, but can be tricky.</literallayout> <literallayout> Winelib: selected other platforms are supported, but can be tricky.</literallayout>
</para> </para>

26
documentation/registry.sgml
View File

@ -36,10 +36,10 @@
workarounds for certain programs etc.). workarounds for certain programs etc.).
In the main Wine source code directory in a <glossterm>terminal</glossterm>, run: In the main Wine source code directory in a <glossterm>terminal</glossterm>, run:
</para> </para>
<screen> <screen>
<prompt>$ </><userinput>cd programs/regedit</> <prompt>$ </><userinput>cd programs/regedit</>
<prompt>$ </><userinput>./regedit ../../winedefault.reg</> <prompt>$ </><userinput>./regedit ../../winedefault.reg</>
</screen> </screen>
</sect2> </sect2>
<sect2> <sect2>
@ -232,19 +232,19 @@
files (which we assume will reside in files (which we assume will reside in
<filename>/usr/local/etc</filename> here), with: <filename>/usr/local/etc</filename> here), with:
</para> </para>
<screen> <screen>
cd ~/.wine cd ~/.wine
cp system.reg /usr/local/etc/wine.systemreg cp system.reg /usr/local/etc/wine.systemreg
cp wine.userreg /usr/local/etc/wine.userreg cp wine.userreg /usr/local/etc/wine.userreg
</screen> </screen>
<para> <para>
and perhaps even symlink these back to the administrator's and perhaps even symlink these back to the administrator's
account, to make it easier to install apps system-wide later: account, to make it easier to install apps system-wide later:
</para> </para>
<screen> <screen>
ln -sf /usr/local/etc/wine.systemreg system.reg ln -sf /usr/local/etc/wine.systemreg system.reg
ln -sf /usr/local/etc/wine.userreg wine.userreg ln -sf /usr/local/etc/wine.userreg wine.userreg
</screen> </screen>
<para> <para>
Note that the <filename>tools/wineinstall</filename> script Note that the <filename>tools/wineinstall</filename> script
already does all of this for you, if you install Wine source as root. already does all of this for you, if you install Wine source as root.