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

Igor,

If someone can't follow that example, then any more complex 
examples have even less chance of being successful.
Do not remove that comment.
I have no objection to adding instructions about how to compile 
it in MSVC++, but you then need to explain the procedures for 6, 
7 and 7.1, or provide project files compatible with all 3.
The _Windows is used in a number of places and dates from 
Borland C++ days.

The file dwmainc.c and dxmain.c are listed as examples.

Russell

On 20 Nov 2003 at 11:21, Igor V. Melichev wrote:

> 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
> >
> 
> _______________________________________________
> gs-code-review mailing list
> [email protected]
> http://www.ghostscript.com/mailman/listinfo/gs-code-review


Russell Lang                   [email protected]
Ghostgum Software Pty Ltd      http://www.ghostgum.com.au/