My pleasure 2017-03-28 20:20 GMT+02:00 Tim Johnson <t...@akwebsoft.com>:
> * Joh-Tob Schäg <johtob...@gmail.com> [170328 10:09]: > > It is no doc string in the elisp sense even though function and syntax > are > > similar. > > > > (de do_nothing () "Does nothing") > > > > Does not behave as expected. It returns the evaluated transient symbol > > "Does nothing". > > > > (de return_null () "returns 0" 0) > > > > (de muliply_increase_add (A B C) (let N (* A B) "N is A * B" (inc 'N 1) > "N > > is increased by 1" (setq N (+ N C)) "Everything is done returning N now" > N)) > > > > > > Is an extreme example which illustrates the trade-of both in terms of > > handling return values and readability. Also be careful around @, @@, @@@ > > with these. The resulting code is also slower. Comments are often > preferred > > for that reason. > > Thank you. > > > 2017-03-28 19:26 GMT+02:00 Tim Johnson <t...@akwebsoft.com>: > > > > > * Joh-Tob Schäg <johtob...@gmail.com> [170323 22:18]: > > > > Either comments inside the code.# Like that > > > > > > > > Transistent Symbols at the beginn of the funtion. > > > > (de power (N E) > > > > "Calculates the exponent in a wastefull manner" > > > > (apply '* (need E N))) > > > > > > > > I have not seen another approach in Picolisp yet > > > > Am 24.03.2017 04:15 schrieb "Christopher Howard" < > > > > christopher.how...@qlfiles.net>: > > > > > > > > > Hi list. How does one document his picolisp code? Has anybody > developed > > > > > any cool markup systems for use with picolisp? > > > > > > > > Joh-Tob seems to be describing a docstring as in elisp and python. > > > Does the docstring have to be the third member of the 'de form? > > > > > > Thanks > > > -- > > > Tim > > > http://www.akwebsoft.com, http://www.tj49.com > > > -- > > > UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe > > > > > -- > Tim > http://www.akwebsoft.com, http://www.tj49.com > -- > UNSUBSCRIBE: mailto:picolisp@software-lab.de?subject=Unsubscribe >