discussion:manual:chapter5:basics

So, in this period I cannot dedicate too much time to actual test of newRPL or digging the source code but I can help with the layout of unformatted parts. It is still something.

I know that Claudio copied the RPL documentation from the main site in this page, just the flow control part was not formatted. I also find a bit counterintuitive to define the loops before the conditionals, since looping requires conditionals (to check if an expression is true). Of course the explanation is simpler if one assumes that who uses the newRPL knows already about programming. Therefore I'm rearranging the contents like: conditionals first, FOR loops (because with a counter is easier to explain the loop range and STEP increments), then START loops (easy, just point to FOR loops, without the need of counters), then DO and WHILE (or WHILE and DO, they are one like the other).

I will take some revisions until I do the basic formatting (unless someone else is faster than me)

Of course if it is not liked, the sectioning of the parts allows an easy rearrangement. I think. — pier4r 2017/05/05 07:29

I'm OK with rearranging and improving. Try to keep the formatting consistent with the previous part, which I kept consistent with the articles that smartin wrote. C.L.

Done! — pier4r 2017/11/04 01:29

As far as I know RPL draws heavily from the userRPL, for basic syntax at least, until this holds true I would point also the large literature in terms of forums/documentation on hpcalc.org and other resources that people may use as source of examples. — pier4r 2017/05/05 07:29

Regarding links, it's fine but you should link to specific things related to the topic, not just generic links to the home page of a wiki or hpcalc.org. For example, link to the AUR details in hpcalc.org, or to the one post in the forum that has the AUR with bookmarks, or in this case to a specific document teaching about loops. C.L.
  • discussion/manual/chapter5/basics.txt
  • Last modified: 2017/11/04 01:30
  • by pier4r