Improving the Wine Users Guide

[Lei Zhang]

Hi,

For our 1.0 release, we should have a polished users guide to help
people to learn to use Wine properly. I did a quick read of the Wine
Users Guide [1] and here are my comments:

* Near the top - mention virus / security issues, warn against running
Wine as root.
* Remove references to tools/wineinstall - does anyone use this anymore?
* Section 2.3.1 - mention ./configure --verbose
* Section 3.1.2.1 - are there dlls besides kernel32, gdi32, user32,
and ntdll that we should never use the native one? Add warning about
downloading dlls from the web.
* Section 3.1.3 - the default virtual window resolution is 800x600
now. Add documentation for the dpi setting. Remove references to
"desktop double buffering" - option no longer exists.
* Section 3.1.4 - document the advanced options.
* Section 3.1.5 - add a blurb about setting directsound emulation to
none when wine complains about it.
* Section 4.5 - mention the WINEPREFIX environment variable.
* Section 5.2.1 - mention including hardware / drivers info in bug reports

- Lei

[1] http://www.winehq.org/docs/en/wineusr-guide.html

[Jérôme Gardou]

Le Sunday 16 March 2008 19:17:38 Lei Zhang, vous avez écrit :
> - Section 3.1.2.1 - are there dlls besides kernel32, gdi32, user32,
>
> and ntdll that we should never use the native one? Add warning about
> downloading dlls from the web.

Isn't ddraw a part of this ones ?

___________________________________________________________________________ 
Yahoo! Mail réinvente le mail ! Découvrez le nouveau Yahoo! Mail et son interface révolutionnaire.
http://fr.mail.yahoo.com

[Stefan Dösinger]

Am Sonntag, 16. März 2008 20:13:13 schrieb Jérôme Gardou:
> Le Sunday 16 March 2008 19:17:38 Lei Zhang, vous avez écrit :
> > - Section 3.1.2.1 - are there dlls besides kernel32, gdi32, user32,
> >
> > and ntdll that we should never use the native one? Add warning about
> > downloading dlls from the web.
>
> Isn't ddraw a part of this ones ?

ddraw,d3d8,d3d9,d3d10,dsound, also mostly true for dinput

[Vitaliy Margolen]

Stefan Dösinger wrote:
> Am Sonntag, 16. März 2008 20:13:13 schrieb Jérôme Gardou:
> > Le Sunday 16 March 2008 19:17:38 Lei Zhang, vous avez écrit :
> > > - Section 3.1.2.1 - are there dlls besides kernel32, gdi32, user32,
> > >
> > > and ntdll that we should never use the native one? Add warning about
> > > downloading dlls from the web.
> >
> > Isn't ddraw a part of this ones ?
>
> ddraw,d3d8,d3d9,d3d10,dsound, also mostly true for dinput

Native dinput works perfectly for keyboard and mouse. Not at all for 
joystick. So I don't see any reason to put it on that list.

Add ntoskrnl.exe, hal.dll.

Vitaliy.

[Jeff Zaroyko]

Lei Zhang <thestig <at> google.com> writes:
> Hi,
>
> For our 1.0 release, we should have a polished users guide to help
> people to learn to use Wine properly. I did a quick read of the Wine
> Users Guide [1] and here are my comments:
> - Remove references to tools/wineinstall - does anyone use this anymore?

Anyone who reads the README distributed with wine might, it's listed under the
quick start section as the recommended way to build and install.

[Juan Lang]

> - Section 3.1.2.1 - are there dlls besides kernel32, gdi32, user32,
>
> and ntdll that we should never use the native one? Add warning about
>  downloading dlls from the web.

This list may end up being rather large.  Certainly not iphlpapi.
Right now, not netapi32 or crypt32, either, though whether that will
always be the case I can't say.
--Juan

[Maarten Lankhorst]

2008/3/16, Juan Lang :
> > - Section 3.1.2.1 - are there dlls besides kernel32, gdi32, user32,
> >
> > and ntdll that we should never use the native one? Add warning about
> >  downloading dlls from the web.
>
> This list may end up being rather large.  Certainly not iphlpapi.
>  Right now, not netapi32 or crypt32, either, though whether that will
>  always be the case I can't say.

Winecfg already warns for a lot of dlls you shouldn't override.