[question]userRPL, functions or (sub)subprograms and directories

[Gerson W. Barbosa]

(03-29-2017 06:15 PM)pier4r Wrote:  Side note: Gerson if you will ever read this thread. You are a very prolific writer about user RPL programs and mathematical solutions, but as a reader of your code I see that you heavily use the stack (that is not easy to read nor debug) and you put almost no comments in your programs. So one is left debugging them to understand what happens. Could you put more comments in them? Would be great! :love:

Pier, sorry for the very belated reply, but this is the first time I ever read this post. You are indeed too kind when you say I “put almost no comments” in my programs. I actually put no comments at all, which is a really bad thing as I have a hard time when trying to understand my own programs only a few months later. In order to try to fix that, lately I have been adding algorithms in pseudo-code to my RPL codes, as in this recent thread:

https://www.hpmuseum.org/forum/post-1394...#pid139476

Comment to every line of the RPL code would be be better, but at least we have an idea of what’s going on.

Best regards,

Gerson.

[John Keith]

Gerson: Thanks for dredging up this thread. I either missed it or forgot about it, and it is full of useful information.

Pier: I am also guilty of posting stack-heavy programs with few if any comments. I want the programs to be as fast as possible and easy for others to copy onto their devices, but another reason is simple laziness.

If anyone has questions about programs I have posted, I would be happy to answer them or provide commented and/or simplified versions.

[pier4r]

(12-13-2020 04:19 PM)Gerson W. Barbosa Wrote:  Pier, sorry for the very belated reply, but this is the first time I ever read this post. You are indeed too kind when you say I “put almost no comments” in my programs. I actually put no comments at all, which is a really bad thing as I have a hard time when trying to understand my own programs only a few months later. In order to try to fix that, lately I have been adding algorithms in pseudo-code to my RPL codes, as in this recent thread:

https://www.hpmuseum.org/forum/post-1394...#pid139476

Comment to every line of the RPL code would be be better, but at least we have an idea of what’s going on.

Best regards,

Gerson.

Thank you!

"I have a hard time when trying to understand my own programs only a few months later" yes indeed it happens to many (me included), now imagine not being in your mind!

John thank you too!

I for one, start to write comments first, and then I add statements