OpenEuphoria

Standards

• Posted by Mathew Hounsell <mfh03 at UOW.EDU.AU> Jun 25, 1999
• 471 views

I intend to track the standards if no one objects.
I will track things like syntax and how many people support it. I will also keep
a copy of the
documentation. I will write a euphoria program to make generating a submission
simple.
I will need to publish the standards on a web site and it would probablely
easier to use a free
one as I doubt RDS wants to give out access to there site and probabely don't
want to receive
heaps of mail from me. Any suggestions as to which free one ...

I will track code and values upon decision of prototypes etc.

I will write up te rules as soon as possible. Of course the main ones will be :
* All decisions will be made only by the euphoria community based on a
democratic vote.
* I will impartial.

-----------------------------------------------------------------------------------------------
A submission should be submitted as

In the Subject of the message ...
 EUSTD Submission <category>
In the body of the message ...
 Name :         Name of routine/constant/etc
 Type :         New/Change to a standard
 Reason :       I want a good reason.
 Comments :     If you want to say anything important
 Syntax :       Function Prototype
 Documentation :        On the lines underneath

The Categories are :
Mathematics, Sequence Manipulation, Object Oriented Programming, Algorithms,
Input/Output,
Networking, User Interface, Database, Graphics 2D/3D, Threads, Machine Level,
Operating System, Miscellaneous, Documentation, Standards

Vote Submision
-----------------------------------------------------------------------------------------------
In the Subject of the message ...
 VOTE Submission <category>
In the body of the message ...
 Name :         Name of routine/constant/etc
 Type :         Support / Against
 [Reason :      Out of interest]

-----------------------------------------------------------------------------------------------
If you suggest a routine you will have to provide the documentation in standard
RDS form, the
current standard.

The documentation whould be
[Platform:      DOS32/Win32/Linux]
Syntax:         [include <filename>]
function prototype / constant name / type
                                prototype
Description:    What it is / does
Comments:       Things you wnat to know
Example:
[See Also:]

A function protoype is written as...
<return type> <name>( [<type> <name>] [, <type> <name>] [, <type> <name>] etc )

A type protoype is written as...
type <name>( <type> <name> )

Types are  atom, integer, object, sequence
        string - ie a sequence of charcaters
        I know strings aren't supported however it is simpler to say string.

[] indicate it is optional.
<> idicates it should be replaced by the approriate value.

eg
PI
------------------------------------------------------------
Syntax:         include misc.e
                PI
Description:    PI (3.14159...) has been defined as a global constant.
Comments:       Enough digits have been used to attain the maximum accuracy
possible for a Euphoria
atom.
Example:        x = PI  -- x is 3.14159... See Also:    sin, cos, tan


------------------------------------------------------------
So far in Math (Votes are between [])

PI = 3.141592...                                [Approved!]
atom abs( atom )                                [6]
object = arcsin( object )       [Approved!]
object = arccos( object )       [Approved!]
atom min( sequence )            [4]
atom mean( sequence )           [2]
atom median( sequence ) [2]
atom min( atom, atom )          [4]
atom mode( sequence )           [2]
atom sign( atom )                       [3]
atom sum( sequence )            [2]
-------------------------
Sincerely,
Mathew Hounsell

mat.hounsell at excite.com