OpenEuphoria

Re: Error when tryijng to use Upper()

• Posted by ronaustin at alltel.net Oct 17, 2003
• 461 views

=0D
 =0D
-------Original Message-------=0D
 =0D
From: EUforum at topica.com=0D
Subject: Re: Error when trying to use Upper()=0D
 =0D
 =0D
 =0D
----- Original Message ----- =0D
From: <Louis at cwshop.com>=0D
To: "EUforum" <EUforum at topica.com>=0D
Sent: Saturday, October 18, 2003 1:30 AM=0D
Subject: Re: Error when trying to use Upper()=0D
 =0D
 =0D
> =0D
> =0D
> I, too, struggle with the documentation. OK, Here's the problem. =0D
>We go to Win32Lib index.htm, press Ctl-F and search for "ES_UPPER" =0D
>or "SelText" and find nothing. You will say this is because index.htm=0D
>is only one of 44 files of HTML documentation. I say I don't have =0D
>time to initiate up to 44 separate searches to locate the explanation=0D
> for "ES_UPPER".=0D
 =0D
Its worse than that...there *is* no explanation of ES_UPPERCASE and SelTe=
xt
in the win32lib docs. This is because I'm not likely to describe the
Microsoft defined constants or API routines in Win32lib's documentation.
Think of it this way, if I write a book to describe the workings of a
Porsche 911, you would still have to go else where to learn how to drive.=
=0D
 =0D
There are many sources of information about the Microsoft Windows API, an=
d
all better written than I could ever do.=0D
 =0D
On the other hand, if you wish to pay me large amounts, I might be persua=
ded
to add extra to the free win32lib documentation.=0D
 =0D
> Two possible solutions come to mind...=0D
> 1. Someone could write a search tool.=0D
> 2. A link could be placed in index.htm for "EX_*" (I assume all of=0D
> them are in one file) so we could find them in two steps. =0D
>Hopefully, a similar thing would be done for the other batches of consta=
nts
=0D
 =0D
Well, yes and no. The search tool could be created, but the content to
search for is still not there.=0D
 =0D
> Idea for the (perhaps distant) future - design special flags to put=0D
>in the comments in Win32Lib source (or any source) which allow a =0D
>documentation generator to produce documentation for the program. =0D
>That way, when the source is changed, it will only be necessary to=0D
>run docgen to make new documentation. It could produce a text file=0D
> with HTML links, and the single file could be easily searched.=0D
 =0D
Ummm...that's how its done now. Have you looked at the comments in the
library? They are sprinkled with markup codes already so that the MakeDoc
program can generate the HTML code.=0D
 =0D
For example...=0D
 =0D
--/topic Events=0D
--/func subClassControl(sequence Id, atom hWnd)=0D
--/desc Used to access Windows created controls as if they were win32lib
controls.=0D
--/return INTEGER: A win32lib control id. ZERO if it fails.=0D
-- /i Id is a sequence {ControlType, ParentID} /n=0D
-- /i hWnd is the Windows Handle to the control.=0D
--=0D
--Example=0D
--/code=0D
-- newid =3D subClassControl( {EditText, myWindow}, winhandle)=0D
--/endcode=0D
 =0D
generates an entry in the EVENTS.HTM file (the topic) about a function
called 'subClassControl'. =0D
 =0D
-- =0D
Derek=0D
 =0D
For people who are familiar with API programing and know where to look, t=
he
lack of documentation =0D
is probably not a big problem,  but for people like me who have come from=
 a
non GUI language to =0D
Euphoria it's kind of tough.    I'm not complaining, mind you,  Euphoria =
is
great.  When I want to add =0D
some new code to my program I first check for any examples, then I check =
any
documentation I can find,=0D
 then check my code again, then I check for examples again and after 3 or=
 4
rounds if I still don't have=0D
the answer I post a question here.  I'll go download or buy some
documentation for the MS API.=0D
 =0D
 =0D
TOPICA - Start your own email discussion group. FREE!=0D
 =0D
 =0D
 =0D
=2E=20