Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 3 Jun 2012 20:59:43 -0400 (EDT)
From:      Benjamin Kaduk <kaduk@MIT.EDU>
To:        =?ISO-8859-15?Q?Ulrich_Sp=F6rlein?= <uqs@freebsd.org>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: Please review WINE chapter addition and linuxemu rename
Message-ID:  <alpine.GSO.1.10.1206031524550.18441@multics.mit.edu>
In-Reply-To: <20120601175450.GO10094@acme.spoerlein.net>
References:  <20120601175450.GO10094@acme.spoerlein.net>

next in thread | previous in thread | raw e-mail | index | archive | help
  This message is in MIME format.  The first part should be readable text,
  while the remaining parts are likely unreadable without MIME-aware tools.

---559023410-1961376562-1338754874=:18441
Content-Type: TEXT/PLAIN; CHARSET=ISO-8859-15; FORMAT=flowed
Content-Transfer-Encoding: QUOTED-PRINTABLE
Content-ID: <alpine.GSO.1.10.1206032004191.18441@multics.mit.edu>

On Fri, 1 Jun 2012, Ulrich Sp=F6rlein wrote:

> Dear all,
>
> in the process of adding the WINE section from the wiki to the handbook
> (GCIN 2011 project, yeah I know, I was rather busy ...), I also took the
> liberty of renaming it from linuxemu to compat. Also in the hope that
> someday we might have a blurp on SVR4 compatibility, although I guess no
> one is really interested in that.
>
> Anyway, please review the proposed changes at
> https://github.com/uqs/freebsd-doc/commits/wine
> or clone that branch and have a closer look.

2b3e8a6403909cdc752833e9c8b4f9196be9efe1 ("Move the linux section one=20
level down, add (empty) wine section.") seems to also include some=20
whitespace changes.


In c89922e4d1e23acfe93eff9ae23cebbb9a93203a ("Add WINE section from=20
wiki.freebsd.org"):

         1353  +    such things. Hence, the contraction of "Wine Is Not an =
Emulator."

I do not think that 'contraction' is the best word here; I think that=20
'acronym' might be better (as "acronym from").

   =091355 +    <para>Wine requires LDT support, but it is not available on=
 RELENG_7 and
   =091356 +    earlier versions. However, it works fine on versions 8.2 an=
d 9.0 or newer.

You probably want to specify that this is versions of FreeBSD (i.e. &os;),=
=20
and maybe only use the word 'versions' once and &os; for later=20
appearances.

   =091359 +    comes quite cleanly from a "make install clean" command whi=
le in the wine
   =091360 +    directory of ports; for how well individual applications wo=
rk, check the

In addition to Glen's fix, I would just say "while in <filename=20
class=3D"directory">ports/emulators/wine</filename>".

   =091362 +    website. Wine does not work out of the box on amd64 system.=
 However, with a

Should be "systems" plural.


   =091364 +    amd64 system (Diablo 2 works just fine). The following list=
 is not
   =091365 +    minimal, as I tried several different paths before I got on=
e working.

We really don't like to use the first person in our documentation ("I");=20
it would also be nice to attempt to turn the list into a minimal one=20
before finalizing the document.

Skipping the programlisting (please do heed Warren's comments),

   =091402 +    <para>For sound in Diablo 2 to work, run winecfg and set ac=
celeration

winecfg should be in <command> markup.

   =091403 +    to "Emulation" (see Known Problems section above) then run =
"wine32

<quote> would probably be good here, too (I think this is what Glen meant=
=20
instead of &quot;?).

   =091404 +    Game.exe." The problem seems to lie in the differences betw=
een OSS and

The command to run should be marked up using <userinput> and maybe in a=20
<screen> block, too.

   =091405 +    ALSA

Full stop at end of sentence.

   =091406 +    </para>
   =091407 +    <para>3D acceleration is working with the 64bit nvidia driv=
er provided

The document should be internally consistent about "32 bit" vs "64bit" vs=
=20
"64-bit" (I prefer the latter form, myself), but the first two appear in=20
this change.

I thought there was an &nvidia; entity that should be used here but I=20
can't find one; it is usually capitalized either nVidia or NVIDIA or=20
NVidia elsewhere in the tree.

This is x11/nvidia-driver, right?  That should probably be mentioned=20
explicitly.

   =091408 +    that you install the 32bit version (same version number) in=
to the

This is the 32-bit version of nvidia-driver (as opposed to, say, wine),=20
right?

-Ben Kaduk

   =091409 +    chroot (tested with World of Warcraft, 8.0-RELEASE).

>
> Rendering of that branch can be found here:
> https://www.spoerlein.net/handbook/compat.html
---559023410-1961376562-1338754874=:18441--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.GSO.1.10.1206031524550.18441>