Arc Forumnew | comments | leaders | submit | bgutierrez's commentslogin

I just finished this book and I don't think you'd find much benefit from trying to use arc instead of scheme. The Little Schemer as about computation, not practical programming.

It's a fun book. Enjoy!

-----

1 point by tlrobinson 4651 days ago | link

I'm only on the third commandment, but so far I'm really bored... does it get better?

-----

1 point by w8lvn 4644 days ago | link

It is worthwhile, even if it is a little boring for a bit.

-----

1 point by bgutierrez 5052 days ago | link | parent | on: Updated range with step

Isn't this exactly the same as what I did, except with different formatting and a '() in place of a nil?...

-----

1 point by ryantmulligan 5052 days ago | link

the second line has less ifs

-----

1 point by bgutierrez 5052 days ago | link | parent | on: Updated range with step

Ah, I like that better.

-----


I'm all for an Arc wiki. I'd definitely get in on the documenting, and I don't want us all to be duplicating efforts.

-----

8 points by lojic 5055 days ago | link

Wouldn't inline comments be more in line with "the code is the spec" philosophy? I would think it would be much less likely to get out of sync as the code changes. If someone modifies a function, changing the comment right above it seems more likely to happen than to go track down all the doc sites and make sure they're accurate.

-----

4 points by Xichekolas 5055 days ago | link

I prefer inline comments with explanation and examples. If you want a somewhat decent example, think of (dare I say it) Javadoc comments and Rdoc comments. Someone just needs to write something (in arc of course) to parse .arc files and build up html docs, then you can have them on a website and in the code, but the code is the authority.

(In fact, this gives me something to do tonight.)

-----

1 point by tjr 5055 days ago | link

If pg & co. will add the comments and/or accept patches from users with comments, then yes, this would be the best method for function reference documentation, especially given Arc's present volatility.

-----

3 points by kennytilton 5055 days ago | link

I agree. As I said, the wiki solution would be needed iff the Arc team does not want to do this. As an open tool provider myself I always invite those complaining about my doc to go ahead and contribute some. Great way to silence them. :) And maybe we can have the best of both worlds if we do the work collaboratively on a wiki which then periodically gets scraped into arc.arc so typical users are just looking at that. as an aside, if this happens I do think the wiki entries should also include the relevant code.

-----

1 point by Gotttzsche 5054 days ago | link

Maybe we should do a temporary wiki and just paste arc.arc in it so everyone can add comments in a centralized way.

Maybe get one at wikia? (they are for free, right?)

edit: nevermind, there's already git.nex-3.com :)

-----

4 points by bgutierrez 5056 days ago | link | parent | on: Dear PG, Thank You for the Shed

Upmodded and ditto. Arc is my new favorite toy.

-----

4 points by bgutierrez 5056 days ago | link | parent | on: Improve your arc REPL

The latest version of rlwrap (0.30) lets you specify which characters are quote characters with the -q option.

-----

5 points by bgutierrez 5056 days ago | link | parent | on: [... _ ...] is fishy

I think [... _ ...] is fine. If I want a language to protect me from myself or others, I'll use Java. :-)

-----