Mailing List Archive: 49091 messages
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search
 

[REBOL] REBOL might be easy, but not with this documentation

From: rebolmikko:ya:hoo at: 18-Oct-2001 3:14

I'm reporting my very early experiences as a REBOL programmer - although I have read about the progress with the language several years, I just hours ago started to program my first scripts. The problem with programming REBOL is that the documentation lacks. It is well written sort of and I guess everything is there, BUT: it clearly shows that someone too familiar with the language has written it. Let's take the problem I solved just minutes ago as example: I wanted to have a window with no borders and no title. I had no idea what to do. I looked at quite many documents, such as the beginner's guide to REBOL/View, but no help. After some time I tried the command-line help (I didn't read about command line help anywhere, I just tried it because many systems have such thing). Ok, I had already knowledge about view-command, so I instantly saw that I had to use refinements . So I tried: "view/options [no-title no-border] layout[...". After some more time I finally found an example by using altavista search +view/options +rebol from codeconscious.com, which showed that "[no-title no-border]" must come after the layout block. Ok, so I didn't read the manuals very well before starting to program - but how many does? I understand that REBOL Technologies might not have huge resources to put on writing the documentation. But how about adding a possibility to send short scripts with errors to rebol.com and using them as a material for producing a better error parser (the current one isn't very good, you admit?)? I guess my personal problems will go away with the books I have ordered, but not all of the millions of programmers you are trying to lure to use REBOL will buy a book... 8) Cheers, Mikko Mäkelä