[ALLY] REBOL Dictionary Returns
[1/16] from: carl:rebol at: 10-May-2001 11:56
A draft of the REBOL Dictionary (all functions of REBOL listed in alpha order) is now available in HTML format. If you like to wait for the net, you can download it from http://www.rebol.com/docs/dictionary.html. It's 878 KB. If you prefer to use REBOL distributed computing, you can get the doc from REF-MAKE in the DOCS folder on REBOL/View desktop. It's about 45 KB. You decide. I would like your comments regarding its formatting on your browser. Please report problems to [docs--rebol--com]. I wrote this formatter in a couple hours, so I'm sure it still has some glitches. -Carl
[2/16] from: ptretter:charter at: 10-May-2001 15:38
What I always wanted to know is what is the "default" refinements used within a function such as whether the /string refinement is default for the 'open function. This should be added to help and maybe this dictionary as well. Paul Tretter
[3/16] from: john:schuhr at: 10-May-2001 15:52
Well, on the website, the images are broken..
[4/16] from: joel:neely:fedex at: 10-May-2001 15:23
I notice that the data types are missing: binary! object! logic! etc... -jn- Carl Sassenrath wrote:
[5/16] from: larry:ecotope at: 10-May-2001 13:49
Hi Carl The updated dictionary.html on the RT website displays and prints fine in IE5.01 SP2. No problem with the two images, but some browsers may not support .png files. -Larry
[6/16] from: holger:rebol at: 11-May-2001 6:19
On Fri, May 11, 2001 at 02:31:27PM +0200, Will Arp wrote:
> why can't you make a port of view/pro for OSX > in a couple hours..
Because we would need to port the user interface over to Cocoa/Aqua, and that takes more than a couple of hours. Besides before we can even start Apple needs to provide some more complete developer documentation. At the moment everywhere you look it says "Description forthcoming", "This topic is under construction". The MacOS X section of their developer web site is pretty much empty :-(. At the moment the user interface engines we have for View are X11, Amiga Intuition, BeOS and Windows. MacOS 8/9 QuickDraw will be next, after that probably MacOS X Cocoa/Aqua, assuming more documentation is available by then. Others on the list are QNX Photon and TAO Elate/Intent, if there is sufficient demand for them. -- Holger Kruse [holger--rebol--com]
[7/16] from: joel:neely:fedex at: 11-May-2001 6:46
Hi, Petr & Carl,
>From a different perspective...
Petr Krenzelok wrote:
> Hello Carl, > > as for formatting - it is formatted well, but it simply is "plain" > and is not "nice". >
Well, maybe not "plain", but "clean" -- which is nearly synonymous nice in my book. When it comes to hard-core reference material, I prefer as little visual distraction (and as much content) as possible.
> I remember the same doc with very nice color scheme, where command > was in white-on-black color scheme, refinements white-on-magenta, > description white-on-bright-brown or something like that ... and >
Reverse text for the command is a very good thing, simultaneously providing visual breaks between topics, emphasis for the "search keys", and minimum of lost space. (Although generally I like whitespace in a graphic design, in this case minimizing scrolling and/or pages of print would be A Good Thing.) As for the rest of the coloring, PLEASE be cautious. When printing on a non-color printer, various color-on-color combinations can harm readability by reducing contrast (and also burn up toner/ink much faster ;-). Finally, as a significant percentage of the (male, oddly enough) population has some degree of color-blindness, such documents should NEVER depend on color-coding alone for critical distinctions.
> ... the spacing was not so drastic, and also function names are > just way too big ... >
As above, I'd agree that reducing page count would be good. It currently prints 159 pages on one of my printers (and that's with some omissions still in place -- e.g., binary!, object!, etc.) -jn-
[8/16] from: gjones05:mail:orion at: 11-May-2001 7:28
From: "Joel Neely"
> Finally, as a significant percentage of the > (male, oddly enough) population has some degree of color-blindness, > such documents should NEVER depend on color-coding alone for > critical distinctions.
Excellent point that I *never* thought about in the context of web page color coding. (As a side-bar that is TOTALLY off topic, the most common form of color blindness is x chromosome linked. Women have two x chromosomes and men have an x and a y chromosome. If the one x chromosome is deficient in men, then the trait appears. In women, it requires that both x chromosomes be deficient for the trait to appear. This is similar to the so-called male-pattern baldness trait. Few people realize that men inherit these characteristics from their mothers, not fathers. US male residents who are color-blind and/or bald, be sure to thank your mother on the upcoming "Mother's Day". End of off-topic side-bar. Isn't genetics fun?! ;) --Scott Jones
[9/16] from: jeff:rebol at: 11-May-2001 8:33
>> On Fri, May 11, 2001 at 02:31:27PM +0200, Will Arp wrote: >> why can't you make a port of view/pro for OSX > in a couple
<<quoted lines omitted: 3>>> QuickDraw will be next, after that probably MacOS X > Cocoa/Aqua,
And the Mac OS version will run under OSX with the compatability jobber... -jeff
[10/16] from: petr:krenzelok:trz:cz at: 11-May-2001 6:28
Hello Carl, as for formatting - it is formatted well, but it simply is "plain" and is not "nice". I remember the same doc with very nice color scheme, where command was in white-on-black color scheme, refinements white-on-magenta, description white-on-bright-brown or something like that ... and ... the spacing was not so drastic, and also function names are just way too big ... ... but of course I think that it could be added even now ... Cheers, -pekr- Carl Sassenrath wrote:
[11/16] from: carl:rebol at: 11-May-2001 11:47
I took all that stuff out because I did not think you liked all that fancy formatting! At 5/11/01 06:28 AM +0200, you wrote:
[12/16] from: warp:reboot:ch at: 11-May-2001 14:31
why can't you make a port of view/pro for OSX in a couple hours.. 8) Will Arp
[13/16] from: petr:krenzelok:trz:cz at: 11-May-2001 14:38
Will Arp wrote:
> why can't you make a port of view/pro for OSX > in a couple hours..
or for Elate? :-) Or for QNX RtP, which has pretty stable GUI environment? QNX is used in embedded area, maybe someone would decide to use Rebol as a support tool for kiosk systems? ... but - I can understand that OSX is more important now - it is one of the mainstream platforms ... -pekr-
[14/16] from: arolls::bigpond::net::au at: 11-May-2001 16:41
What about choice of background colour? Sorry, I think white is too bright. Regards, Anton.
[15/16] from: deryk:iitowns at: 11-May-2001 10:46
Carl Sassenrath wrote:
> A draft of the REBOL Dictionary (all functions of REBOL > listed in alpha order) is now available in HTML format.
<<quoted lines omitted: 6>>> I wrote this formatter in a couple hours, so I'm sure it > still has some glitches.
Looks just fine under KDE's Konqueror. One question though..where are they images under the lynx text based browser? j/k ;) On that related note, the document fails to validate as HTML 4.01 transitional by the W3C validtator (http://validator.w3.org/). The first 8 errors or so pretty much nail down what's missing with the last being the rest of the errors (missing ALT tag for corresponding IMG tags) which under Lynx could be set as ALT=" " for example. :) Regards, Deryk -- Binary/unsupported file stripped by Listar -- -- Type: application/x-pkcs7-signature -- File: smime.p7s -- Desc: S/MIME Cryptographic Signature
[16/16] from: arolls:bigpond:au at: 13-May-2001 20:48
Now I think about printing perhaps I was too quick. Does anyone know if specifically setting the background colour to white makes the document more likely to print correctly? Sorry, Anton.
- Quoted lines have been omitted from some messages.
View the message alone to see the lines that have been omitted