Re: [AD] faq entry

[Eric Botcazou <ebotcazou@xxxxxxxxxx>]

> I've tried to make new version of the answer:
>
> =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- cut here -=-=-=-=-=-=
> Make sure you're building a Windows GUI Application, and not
> a Windows Console Application.
>
> If you are using an IDE (like MSVC, Dev-C++ or Borland C++ Builder)
> than is this typically set when you create new project. In already
> created project you can change it in project settings:
> in MSVC 6:  go to Project\Settings\Link tab and find in
>              the Project Options box "/subsystem:console"
>              and change it to "/subsystem:windows"
> in Dev-C++: go to Project\Project Options and in
>              the Type box change value from Win32 Console
>              to Win32 GUI

I think this is unnecessarily verbose. Switching back and forth from GUI to 
Console is a standard and well-documented feature of Windows IDEs.

> If you are using command line than is this specified:
> by the /subsystem:windows flag for the MSVC linker,

Are you sure it's not -subsytem:windows for the linker?

> by the -tW flag for the Borland C++ command line compiler or
> by the -mwindows flag for the MinGW or CygWin compiler.

This is supposed to be deprecated. The supposedly correct syntax is 
-Wl,--subsystem,windows.


I commited the attached patch to mainline and branch (with the 
ALLEGRO_USE_CONSOLE vs USE_CONSOLE correction).

-- 
Eric Botcazou

Index: docs/src/faq._tx
===================================================================
RCS file: /cvsroot/alleg/allegro/docs/src/faq._tx,v
retrieving revision 1.34
diff -u -r1.34 faq._tx
--- docs/src/faq._tx	18 Oct 2003 16:30:43 -0000	1.34
+++ docs/src/faq._tx	9 Nov 2003 18:05:57 -0000
@@ -291,11 +291,12 @@
 
       Make sure you're building a Windows GUI Application, and not a Windows
       Console Application. This is a setting when you create the project in
-      MSVC or Borland C++ Builder. This is specified by the <tt>-tW</tt> flag for the
-      Borland C++ command line compiler, or <tt>-subsystem:console</tt> for the MSVC
-      linker. Either that, or define the preprocessor symbol
-      <tt>ALLEGRO_USE_CONSOLE</tt> prior to including Allegro headers if you really
-      need the console for your program.
+      MSVC, Dev-C++ or Borland C++ Builder. Alternatively, this is specified
+      on the command line by the <tt>-subsystem:windows</tt> option for the MSVC
+      linker, by the <tt>-Wl,--subsystem,windows</tt> option for the MinGW compiler
+      or the <tt>-tW</tt> option for the Borland C++ compiler. Either that, or define
+      the preprocessor symbol <tt>ALLEGRO_USE_CONSOLE</tt> prior to including Allegro
+      headers if you really need the console for your program.
 
 
 @@   I get lots of compile errors about conflicting types for "struct BITMAP"!