1. Manual problem
- Posted by ryanj Aug 18, 2009
- 1046 views
What is going on with Section 5 Syntax Reference in the manual?
2. Re: Manual problem
- Posted by DerekParnell (admin) Aug 18, 2009
- 1024 views
What is going on with Section 5 Syntax Reference in the manual?
Awaiting contributions, maybe?
The format of this was a bit experimental; so how does it look to you guys? Any suggestions - beyond "more content" 
3. Re: Manual problem
- Posted by DanM Aug 18, 2009
- 1049 views
not the SAME problem as mentioned in the original post, but a proglem with the manual:
when I click on "manual" at top of forum, I get a table of contents (on the right side of the page, nothing but empty space on left side, text in small font), but when I click on ANY of the items in the TOC, there's nothing there.
http://openeuphoria.org/docs/eu400_0001.html
Dan
4. Re: Manual problem
- Posted by jeremy (admin) Aug 18, 2009
- 1020 views
not the SAME problem as mentioned in the original post, but a proglem with the manual:
when I click on "manual" at top of forum, I get a table of contents (on the right side of the page, nothing but empty space on left side, text in small font), but when I click on ANY of the items in the TOC, there's nothing there.
Dan,
Can you give me a URL where there is nothing there? Everywhere I click there is something. I've tested in IE, Firefox and Safari.
Jeremy
5. Re: Manual problem
- Posted by mattlewis (admin) Aug 18, 2009
- 1019 views
Can you give me a URL where there is nothing there? Everywhere I click there is something. I've tested in IE, Firefox and Safari.
His description was confusing, but go to any section, such as:
http://openeuphoria.org/docs/eu400_0003.html#_2_introduction
Now click on a link on the right (Quick Links), such as:
http://openeuphoria.org/manual/eu400_0001.html
In fact, someone opened a bug:
https://sourceforge.net/tracker/?func=detail&aid=2839570&group_id=182827&atid=902782
It's listed in the general bug tracker, and not on the website tracker, however.
Matt
6. Re: Manual problem
- Posted by ryanj Aug 19, 2009
- 947 views
- Last edited Aug 20, 2009
Maybe I didn't explain well enough...why does Section 5 contain some sort of odd syntax instead of the nicely-written plain english sentences that are in all the other documentation?
Some examples:
5.1 basics
LABEL ==: label STRINGLIT
LISTDELIM ==: ,
STRINGLIT ==: SINGLESTRINGLIT | MULTISTRINGLIT
SINGLESTRINGLIT ==: SSLITSTART [ (CHAR | ESCCHAR) ... ] SSLITEND
SSLITSTART ==: "
SSLITEND ==: "
CHAR ==: {any byte value}
ESCCHAR ==: ESCLEAD ( t | n | r | \ | " \ ')
ESCLEAD ==: \
5.4 if
IFSTMT ==: IFTEST [ ELSIF ...] [ELSE] ENDIF
IFTEST ==: if ATOMEXPR [ LABEL ] then [ STMTBLOCK ]
ELSIF ==: elsif ATOMEXPR then [ STMTBLOCK ]
ELSE ==: else [ STMTBLOCK ]
ENDIF ==: end if
Why is it like this?
7. Re: Manual problem
- Posted by Lone_EverGreen_Ranger Aug 19, 2009
- 935 views
- Last edited Aug 20, 2009
Maybe I didn't explain well enough...why does Section 5 contain some sort of odd syntax instead of the nicely-written plain english sentences that are in all the other documentation?
Some examples:
5.1 basics
LABEL ==: label STRINGLIT
LISTDELIM ==: ,
STRINGLIT ==: SINGLESTRINGLIT | MULTISTRINGLIT
SINGLESTRINGLIT ==: SSLITSTART [ (CHAR | ESCCHAR) ... ] SSLITEND
SSLITSTART ==: "
SSLITEND ==: "
CHAR ==: {any byte value}
ESCCHAR ==: ESCLEAD ( t | n | r | \ | " \ ')
ESCLEAD ==: \
5.4 if
IFSTMT ==: IFTEST [ ELSIF ...] [ELSE] ENDIF
IFTEST ==: if ATOMEXPR [ LABEL ] then [ STMTBLOCK ]
ELSIF ==: elsif ATOMEXPR then [ STMTBLOCK ]
ELSE ==: else [ STMTBLOCK ]
ENDIF ==: end if
Why is it like this?
I'd just like to ask, is the Eu 4.0 manual complete? It kinda dosen't seem like it.
8. Re: Manual problem
- Posted by jeremy (admin) Aug 20, 2009
- 837 views
I'd just like to ask, is the Eu 4.0 manual complete? It kinda dosen't seem like it.
There may be a missing item or two, but if missing it's by accident. The manual should be complete. If an area is missing or lacking, please let us know. (5. already stated of course).
Jeremy
9. Re: Manual problem
- Posted by DerekParnell (admin) Aug 20, 2009
- 891 views
Maybe I didn't explain well enough...why does Section 5 contain some sort of odd syntax instead of the nicely-written plain english sentences that are in all the other documentation?
Why is it like this?
The "odd syntax" is a syntax language based on the Extended Backus-Naur Form, which is understood by those that study programming languages. It is a formal representation of a language's syntax.
If you don't understand this section then you probably don't need to
I guess we could do an English version of the section, but it would be a bit dry.
| Term | Definition |
|---|---|
| Alpha-Character | a byte in the range 'a' - 'z' or in the range 'A' - 'Z' |
| Digit | a byte in the range '0' to '9' |
| Underscore | the byte value '_' |
| Identifier | an Alpha-Character or Underscore followed by any number of Alpha-characters, Underscores or Digits. |
| For Statement | The text 'for' followed by a For-Index, optionally followed by a By-Clause , followed by the text 'do', followed by zero or more Statements, followed by the text 'end', followed by the text 'for' |
etc etc etc ...
10. Re: Manual problem
- Posted by DerekParnell (admin) Aug 20, 2009
- 906 views
I'd just like to ask, is the Eu 4.0 manual complete? It kinda dosen't seem like it.
No, but that is not by design. I'm sure it contains mistakes and omits some things. That is where we'd like your help to tell us what needs improving.
This specific section, is definitely incomplete, but it is being worked on. Whether or not it makes the final release edition is still undecided.
