ossp-pkg/sugar/test.srml
Sugar - The Markup Language With Invisible Syntactic Sugar
==========================================================
Title: Sugar - The Markup Language With Invisible Syntactic Sugar
Author: Ralf S. Engelschall <rse@engelschall.com>
Author: Christian Reiber <chrei@en.muc.de>
Genesis: 12-Mar-1999
Date: 26-Jun-2000
Introduction
------------
Me & you Sugar is a markup language and corresponding translator tool for
writing technical documentation that uses mostly invisible markup
tags (the so-called //syntactic sugar// in compiler construction folk
terminology). See ->foo<- **foo**
The general idea is that the markup text looks already like the
textual output of the translator phase, that is, the Sugar source
can be already treated as its text output format ("ASCII WYSIWYG").
Additionally the Sugar markup language is considered intuitive enough
to be recognized easily, so writing technical documentation is mainly
just a matter of performing a brain dump. (+foo+)
|| Special Block For testing
o. foo
bar
o baz1
o baz2
-. quux
purposes only.
So Sugars syntactic principle is "keep it simple'n'stupid" (KISS)
but still powerful enough to allow one to produce high-quality
output. Sugars goal is not to **provide** all features of a full featured
documentation system. Instead it provides only a few markup concepts
but those are streched to a **maximum.
Sugar Grammar
-------------
A Sugar document is described by the following grammar:
++ table
foo bar
quux
where <regular-block> is defined visually as a rectangular block
of continued text inside the document, that is a paragraph of
** BOLD TEXT
text (without any blank lines) where each line starts at the same
** BOLD TEXT
A SECOND TIME
indentation position.
