On Wed, Dec 31, 2008 at 4:48 PM, Eduardo Cavazos <[email protected]> wrote:
> A more complex wiki-style markup language would probably employ PEGs. Don't
> get me wrong, I love pegs, but they're definately a heavy-weight depenency.

PEGs are already loaded in the base image because io.launcher uses them.

> Since easy-help is implemented as parsing words which expand into the standard
> Factor help markup, it's no problem at all two mix the two styles in the same
> file, for example when easy-help doesn't easily allow for some complex
> expression.

If we adopt easy-help, I'd like it to completely replace the s-exp
syntax, even if it expands into it under the hood and older docs
continue to use that syntax; otherwise we end up with a situation
where there are two syntaxes for new developers to learn.

> It would be nice to be able to use something like 'easy-help' when documenting
> core words. I think a PEG dependency would prevent inclusion of such a markup
> system at the core level. Something along the lines of easy-help with it's
> much more conservative implementation might stand a better chance.

The help system is in basis and it already uses some non-core
vocabularies, such as the prettyprinter and fry.

Slava

------------------------------------------------------------------------------
_______________________________________________
Factor-talk mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/factor-talk

Reply via email to