Re: Re: What we really need...
Irv,
re: standardized documentation for libraries:
I'm writing a "Libraries Manager", which allows the user to create a listing
of libraries they might want to use & shows all routines available in each
library as selected, & short descriptions of each routine & jumps to an html
help doc for each library (& individual routine), & "auto" copy-paste of
the general form of any routine selected.
Each library's html help doc is generated by the Win32Lib "MakeDoc.exw"
(which is what is used to make the help documentation for Win32Lib, directly
*from* the library), which needs unique "slash-tags" included in the
comments of the library to allow the "makeDoc" to create the html, and the
"slash-tags" are also needed to consolidate all the routines & descriptions
from each library for the manager. Ricardo Forno added those "slash-tags"
to his "general functions" library, & I added some to Kat's strok.e so I
could include them in the manager and make the html help for the "general
functions" library.
Adopting the Win32Lib "slash-tags" commenting convention would be a
relatively easy way to generate standardized html documentation for
libraries.
As part of the "Libraries Manager", I'm working to create a utility that
will make it easy to "retro-fit" the Win32Lib "slash-tags" into existing
libraries.
Dan Moyer
----- Original Message -----
From: <irv at take.maxleft.com>
To: "EUforum" <EUforum at topica.com>
Sent: Wednesday, November 13, 2002 7:47 AM
Subject: Re: Re: What we really need...
On Tuesday 12 November 2002 09:55 pm, Ray wrote:
>
> david wrote:
> > Re: Kickstart Euphoria?
> >
> > A good start would be translating abandonware PC games into Euphoria.
> > Then redistribute them as freeware after debugging them.
>
> [snip]
>
> As far as I can tell very few Euphoria people are interested
> (or at least active) in the area of game making.
Actually, newcomers to Euphoria often seem most interested in games.
Unfortunately, these are always people who have never tried writing a game.
Those who *have* tried already know that creating a playable game is perhaps
the most difficult programming task imaginable.
This is unfortunate, because many beginning programmers think that
a game would be 'cool'. (Hey, I thought it would be 'cool' to fly an F-16,
but I only got as far as a Cessna 152 Aerobat :) So they get discouraged and
give up.
> This suggestion wouldn't hurt (almost everything helps) but much
> better results would be gained by:
>
> * Writing tutorials, getting started guides, web pages etc
>
> * An officially sponsored library (well documented and as cross
> platform as possible) - one of two of these started as sourceforge
> projects didn't they? what ever happened? These should be in the main
> Euphoria download or at least highly visible on the main eu web site.
>
> * More and better libraries of all types including doco and examples,
> (cross platform libraries being better)
There's lots of good code in the archives. Finding it is not real easy, and
using it is even less easy. Why? Because there is no accepted standard
for coding or documentation. If there were an officially sponsored library,
and some published standards, people could choose to follow those standards
or ignore them, with the understanding that they wouldn't get into the
official library unless they followed the guidelines.
> and for something completely different ...
>
> * A cross platform GUI library! (I'm sure no more needs to said on
> this topic that has been beaten to death!)
Yes, and no. There are real problems with cross-platform GUI's.
All things considered, a cross-platform GUI is probably way down the list
of important things to do.
Regards,
Irv
==^^===============================================================
This email was sent to: DANIELMOYER at prodigy.net
|
Not Categorized, Please Help
|
|
