Improve chapter 4 "The Programming Language" of the reference manual #4547
Conversation
doc/ref/language.xml
Outdated
| <Item>function literals (see section <Ref Sect="Function"/>),</Item> | ||
| <Item>function calls (see section <Ref Sect="Function Calls"/>),</Item> | ||
| <Item>integer literals (see chapter <Ref Chap="Integers"/>),</Item> | ||
| <Item>floating point literals (see chapter <Ref Chap="Floats"/>),</Item> |
There was a problem hiding this comment.
note that floats were missing in the list before this PR
| <Item></Item> | ||
| </Row> | ||
| <Row> | ||
| <Item> <C>^</C></Item> |
There was a problem hiding this comment.
I am abusing non breaking spaces here to force the tables to look not too bad, as a workaround for lack in GAPDoc of a way to merge table cells (something like HTML's colspan attribute for tables) 😞
There was a problem hiding this comment.
So your purpose is to achieve a kind of indentation. For those other reviewers interested in how this looks when rendered, here are the HTML and PDF versions, respectively:
There was a problem hiding this comment.
Thanks. I actually updated it further now:
| <Item></Item> | ||
| </Row> | ||
| <Row> | ||
| <Item> <C>^</C></Item> |
There was a problem hiding this comment.
So your purpose is to achieve a kind of indentation. For those other reviewers interested in how this looks when rendered, here are the HTML and PDF versions, respectively:
fingolfin
force-pushed
the
mh/doc-language
branch
from
342976e
to
413c66b
Compare
|
Any more thoughts on this, @wilfwilson ? |
| <Item></Item> | ||
| </Row> | ||
| <Row> | ||
| <Item> <C>^</C></Item> |
- turned list of "basic" expressions into an actual list - made the references in that list better - add a table listing the precedence and associativity of various operators - turned sections discussing various kinds of statements into subsections of the "Statements" section
Before it was listed under "Statements", even though it describes an expression (a literal, to be precise).
wilfwilson
force-pushed
the
mh/doc-language
branch
from
413c66b
to
7173f7e
Compare
fingolfin
added
the
release notes: not needed
No description provided.