Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 02 Jun 2012 12:32:39 +0200
From:      Benedict Reuschling <bcr@FreeBSD.org>
To:        freebsd-doc@FreeBSD.org
Subject:   Re: Please review WINE chapter addition and linuxemu rename
Message-ID:  <4FC9EBC7.5020102@FreeBSD.org>
In-Reply-To: <alpine.BSF.2.00.1206011950340.92108@wonkity.com>
References:  <20120601175450.GO10094@acme.spoerlein.net> <alpine.BSF.2.00.1206011950340.92108@wonkity.com>

next in thread | previous in thread | raw e-mail | index | archive | help
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 02.06.12 04:05, schrieb Warren Block:
> On Fri, 1 Jun 2012, Ulrich Spörlein wrote:
> 
>> 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.
> 
> Like Gabor suggested, a single diff makes it easier to see all that has
> changed.
> 
>> Rendering of that branch can be found here:
>> https://www.spoerlein.net/handbook/compat.html
> 
> Just looking at the WINE section:
> 
>   "check the Wine AppDB on their main website."
> 
> "their main website" could be removed.
> 
> Those <programlistings> should be <screen> sections:
> 
> <screen>&prompt.root; <userinput>chroot /compat/i386</userinput>
> &prompt.root; /etc/rc.d/ldconfig start</screen>
> 
> And so on.  Note that the ending tag should go on the last line of
> output.  If it is on a line of its own, there's an extra blank line in
> the rendered version.
> 
>> Perhaps we need to keep the anchor names for the linuxemu sections, to
>> not break too many links out there. Is there a way to add aliases so we
>> could deprecated the linuxemu anchors over time?
> 
> I suspect it's all or nothing.  Leave them as-is, or change them and
> anything that refers to them.  That may not be too hard; just do the
> whole doc tree.  (Do translators translate ID names?  I don't know.)
> 

@Warren: No, we don't translate them. There is no official rule to not
do that, but for the same reason as above, it avoids unnecessary breakage.

Regards

Benedict Reuschling
FreeBSD Documentation Committer

The FreeBSD Documentation Project
FreeBSD German Documentation Project - https://doc.bsdgroup.de
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.8 (Darwin)
Comment: GPGTools - http://gpgtools.org
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAk/J68cACgkQTSZQLkqBk0gkagCeOYWefwArWHA57xYavAjo6xmf
DHoAoMsjtjeJ2Ejs6h8Au9j+jjtcv3yn
=qzjA
-----END PGP SIGNATURE-----



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4FC9EBC7.5020102>