To: djgpp AT sun DOT soe DOT clarkson DOT edu
Cc: eliz AT is DOT elta DOT co DOT il
Subject: setmode() docs
Date: Sun, 05 Jun 94 09:29:31 +0300
From: eliz AT is DOT elta DOT co DOT il

There is an error in the docs of setmode() library function.  The docs say that
it returns ZERO on success, while actually it returns the PREVIOUS MODE SETTING.
This is Borland problem, because their setmode() (which is eventually called by
GO32 on behalf of DJGPP program) works this way.  It can be clearly seen e.g. by
stepping into Borland setmode() with Turbo Debugger.  Borland C 3.1 docs were
corrected to specify the actual behavior.  I would suggest to correct the docs
in DJGPP libcref.info file, too.
The above means that if you want to test for setmode()'s success, you should
write:

	if (setmode (....) == -1)
	   error-action;
	else
	   ok-action;

	Eli Zaretskii