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

[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