winelib + unicode

[Dimitrie O. Paun]

On December 11, 2002 10:52 am, Martin Wilck wrote:
> well the configure script should probably check if -fshort-wchar is
> supported, add the option to CFLAGS if yes, and issue a warning if no.

But the problem is that winemaker will run on different systems that
configure runs on... It will get it mostly right, but now always.
However, my comment was referring to this bit:
	http://www.winehq.org/Docs/winelib-user/unicode.shtml
It makes things look complicated. It should be: 
  "Use a gcc that support -fshort-wchar (2.9.7 or later)"

Instead, we present 3 options as if they are *equally* likely/desirable,
and then we let the poor developer not familiar with the problem to
agonize over which option to use. In reality, 1. is likely used in 
99.999% of case, the others are clever hacks that are maybe interesting 
for historical reasons nowadays.

I think we should try to make the documentation concise, not long.
Most people think that the quality of documentation is measured in
pages. Often times, is inversely proportional. Let's try to document
a preferred way of doing things (maybe present some options when they
are equally likely).

That being said, I want to stress that this is a minor nit, and that
I actually like our documentation (incomplete as it is). I just picked
it up as an excuse for my daily rant... :)

-- 
Dimi.