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

[REBOL] Re: Comments about make-doc-pro?

From: dness:home at: 8-Aug-2001 14:05

Ladislav Mecir wrote:
> > Hi, I hope that some of you had a look at the make-doc-pro script and > played > > around with it a bit. Any comments? Robert > > Hi, > > I like the idea and I am using the make-doc. The simplicity is appealing. > But the "dialect" used to specify the document is a little bit "irrebolar" > IMO. > I would like to have it a little bit more "rebolar" as follows: > > instead of saying: > > ===Objective > > I'd prefer to say: > > [section] Objective > > Instead of saying: > > ---Primary Rule > > I'd prefer > > [subsection] Primary Rule >
> What do you think? >
I've played around with make-doc (not yet with make-doc-pro, which I should be getting to later today) and I'd _disagree_ fairly strongly with these suggestions. It seems to me that they not only generally require _more_ typing, but also are more prone to misspelling, and thus extra error/correction cycles, during document preparation. Of course, I guess I wouldn't ultimately object to just about anything that could be done/undone with a simple set of perl substitutions, so I don't feel strongly about it, but I do prefer the current way of marking up simple text.