[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.
Notes
- Quoted lines have been omitted from some messages.
View the message alone to see the lines that have been omitted