Re: API.htm example code clarification (bug 669654)

Ralph,

I'm still unhappy with the comment :

/* add this source to a project with gsdll32.dll, or compile it directly
with:
 *   cl -D_Windows -Isrc -Febin\ps2pdf.exe ps2pdf.c bin\gsdll32.lib
 */

It is only source for the information about -D_Windows.
As I said in the bug report, regular Windows programmers
newer deal with a command line compiler or/and with compiler options.
MSVC defines 'WIN32'.

I suggest :

- remove entire comment;

- instead that, add a new chapter "How to build examples" with so many
paragraphs as many environments may be used. Write explicit instructions
for each environment, or to corresponding sections of Make.htm .

- in the example codes, _WIN32 to be replaced with WIN32 at least for MSVC.

> save the example source code as a .c file

Can't we put a ready project into gs/examples/MSVC, etc ?
IMO a polite instruction should contain only 4 points :

1. Ensure an IDE is installed to your system;
2. Open the gs/examples/MSVC directory;
3. Double-click example1.dsw
4. After the IDE opens, choose Project/Build menu (F7 for MS Developer
Studio).

Igor.


----- Original Message ----- 
From: "Ralph Giles" <[email protected]>
To: <[email protected]>
Cc: <[email protected]>
Sent: Thursday, November 20, 2003 1:37 AM
Subject: API.htm example code clarification (bug 669654)


> Igor,
>
> I've committed some basic instructions for using the API.htm example code
within an IDE
> like MSVC. Bug 669654 was referred to me during a previous bug scrub as a
documentation
> fixup; I think this clarifies all the remaining issue you brought up, so
I'd like to
> close the bug.
>
>  -r
>