Version française
Home     About     Download     Resources     Contact us    

This site is updated infrequently. For up-to-date information, please visit the new OCaml website at

Browse thread
[Caml-list] Documentation tools
[ Home ] [ Index: by date | by threads ]
[ Search: ]

[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
Date: 2001-05-14 (13:32)
From: Christian Lindig <lindig@e...>
Subject: Re: [Caml-list] Documentation tools
> Suggestions and pointers to existing documentation systems are most
> welcome.

Lesser known markup languages:

    Perl's POD:
    Can be translated to man, HTML, LaTeX, plain text.
    WikiWiki syntax:
    Many Wiki implementations use more advanced markup but this is the
    Python's Structured Text:
All three markup languages aim to use as feq special syntax as
possible.  Structured Text seems to be the most advanced using
indentation to denote structure.  This is in a sharp contrast to the
SGML/XML approach which is quite verbose at the source level.  LaTeX
seems to have found a middle ground.  Personally I'd prefer something
like Structured Text or LaTeX for OCaml.

-- Christian
Christian Lindig          Harvard University - DEAS   33 Oxford St, MD 242, Cambridge MA 02138
phone: +1 (617) 496-7157
To unsubscribe, mail  Archives: