[REBOL] Re: [Fwd: Re: RSL: Rebol Standard Library]
From: chris:starforge:demon at: 24-May-2001 14:32
Joel Neely wrote:
> <UHURU version="1.2">
> <UHURU:unit name="del-ascii-html"
> ver="2.1"
> path="/text/conversion" />
> <UHURU:keywords>
> ASCII HTML comma tab convert text conversion
> </UHURU:keywords>
> <UHURU:depends-on>
> /text/conversion/delimited-ascii
> </UHURU:depends-on>
> <UHURU:doc type="html" />
> </UHURU>
>
> <html>
> <head>
> <title>del-ascii-html: Delimited ASCII to HTML
> conversions</title>
> </head>
> <body>
> ... lots of useful documentation ...
> </body>
> </html>
>
> REBOL [
> ....
> ]
>
> make UHURU/unit [
> ...
> tdf-to-table: func [...][...]
> ...
> ]
100% agreement up to this point. IMO <UHURU ...>..</UHURU> is not
required - look at the REBOL header, we already have File (which is
UHURU:unit name) and Version. By extending the header so we have,
say, a standard like:
REBOL [
Title: "del-ascii-html: Delimited ASCII to HTML conversions"
Version: 2.1
File: %del-ascii-html.r
.. other standard fields in here ...
UHURU-Path: %/text/conversion/
UHURU-Keywords: ["ASCII" "HTML" "comma" "tab" "convert" "text"
"conversion"]
UHURU-depends: %/text/conversion/delimited-ascii
UHURU-doc: %del-ascii-html.html
]
This way scripts could use their UHURU (we really need a better acronym
I'm afraid ;)) information as metadata and the header processing the
UHURU handling scripts would need is already built into REBOL.
I'd even suggest allowing UHURU-doc to be either a file, in which case
the file is obtained, or the keyword "auto" in which case code like
my reboldoc is used to extract the html documentation from the source
itself (which IMO is a lot easier on the programmer, and thus more
likely to be used properly - there's only one set of docs, the docs in
the code, to maintain rather than two.)
Chris
