Hi Gregg, > If anyone has specific examples of docs for other languages that they > feel have helped them, pass them on to me, or post them here or on > AltMe.
Well, here's some documentation sites that I've found extremely helpful for some of the languages that I've used over the years: a.. Rexx (Open Object Rexx that is, Regina Rexx tends to stay a bit out of date most of the time): http://sourceforge.net/project/showfiles.php?group_id=119701 b.. Perl: http://aspn.activestate.com/ASPN/docs/ASPNTOC-ACTIVEPERL/ c.. Python: http://aspn.activestate.com/ASPN/docs/ActivePython/2.4/python/index.html and http://www.python.org/doc/ d.. AWK (GNU's GAWK): http://www.gnu.org/software/gawk/manual/html_node/index.html It's always been my experience that these docs have been pretty complete and up to date for each new release at same time as each new release. I find that fact pretty amazing, as each of them is a free, open source language. They're of similar quality as some of the expensive proprietary languages that I've seen, e.g., RealBasic. Best regards, Bernie Schneider The individual has always had to struggle to keep from being overwhelmed by the tribe. To be your own man is a hard business. If you try it, you will be lonely often and sometimes frightened. But no price is too high to pay for the privilege of owning yourself. -- Friedrich Nietzsche -- ----- Original Message ----- From: "Gregg Irwin" <[EMAIL PROTECTED]> To: "Bernie Schneider" <[EMAIL PROTECTED]> Sent: Tuesday, July 12, 2005 6:12 PM Subject: [REBOL] Re: REBOL Tutorials > > Bernie, Steven, et al > > These are all good and valid comments about the state of REBOL docs. > In some cases there aren't any docs, and in other cases there are too > many docs scattered about and sometimes they're very similar. > > Examples tend to favor conciseness very heavily; good for experts, not > for newbies. It's kind of a catch-22. People want to show how it takes > very little REBOL code to do things, but that means leveraging REBOL > in ways that make it harder for newbies to understand. By using > examples that are easy to understand--because they look like examples > in other languages--it can be hard to see that REBOL is different. > And, yes, REBOL's flexibility is both a boon and a curse. :) > > The idea of embedded documentation is based on Literate Programming, > which could actually be a pretty easy thing to do in REBOL, with > make-doc; just have an emitter spit out the code sections as a .r > file. > > I can't say why REBOL clicks OK for some folks and not for others, but > I *can* say that RT really does want to improve the state of REBOL > docs dramatically. There have been a lot of good comments here lately > and I'm trying to mark them so they don't get lost. > > If anyone has specific examples of docs for other languages that they > feel have helped them, pass them on to me, or post them here or on > AltMe. > > -- Gregg > > -- > To unsubscribe from the list, just send an email to > lists at rebol.com with unsubscribe as the subject. > > > > -- > No virus found in this incoming message. > Checked by AVG Anti-Virus. > Version: 7.0.323 / Virus Database: 267.8.13/47 - Release Date: 7/12/2005 > > -- Attached file included as plaintext by Ecartis -- -- Desc: "AVG certification" No virus found in this outgoing message. Checked by AVG Anti-Virus. Version: 7.0.323 / Virus Database: 267.8.13/47 - Release Date: 7/12/2005 -- To unsubscribe from the list, just send an email to lists at rebol.com with unsubscribe as the subject.
