caml-list - the Caml user's mailing list
 help / color / mirror / Atom feed
From: David Mentre <David.Mentre@inria.fr>
To: Sven LUTHER <luther@dpt-info.u-strasbg.fr>
Cc: Fabrice Le Fessant <fabrice.le_fessant@inria.fr>,
	John Max Skaller <skaller@ozemail.com.au>,
	Markus Mottl <mottl@miss.wu-wien.ac.at>,
	caml-list@inria.fr
Subject: Re: [Caml-list] CDK binary release
Date: 10 May 2001 16:01:47 +0200	[thread overview]
Message-ID: <qtleltxcng4.fsf@pochi.inria.fr> (raw)
In-Reply-To: <20010510131646.A20887@lambda.u-strasbg.fr>

Sven LUTHER <luther@dpt-info.u-strasbg.fr> writes:

> What about sgml, most project use that, and they can then transform it in many
> different format afterward.

Or XML? (yes, I know, yet another buzzword)

In the Linux Documentation Project, they use heavily SGML or XML with
the DocBook DTD. From that format, they have tools to generate to LaTeX,
info, text, HTML, and RTF. From that you can generate MS Word,
PostScript, PDF, etc.

Ok, maybe an ocaml file is not a whole DocBook document, but using
DocBook tags would be a plus I think. From the files of a project, the
CDK doc tool could generate the whole XML DocBook document.

One problem against that solution is that DocBook tags are a bit
verbose:
 http://linuxdoc.org/LDP/LDP-Author-Guide/writing-docbook.html

Of course, I've not developed anything, so feel free to delete those
remarks. :)

My 2 cents,
d.
-- 
 David.Mentre@inria.fr -- http://www.irisa.fr/prive/dmentre/
 Opinions expressed here are only mine.
-------------------
To unsubscribe, mail caml-list-request@inria.fr.  Archives: http://caml.inria.fr


  parent reply	other threads:[~2001-05-13 20:55 UTC|newest]

Thread overview: 31+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2001-05-07  9:06 Fabrice Le Fessant
2001-05-07 16:09 ` Miles Egan
2001-05-07 17:17 ` John Max Skaller
2001-05-09 10:58 ` Markus Mottl
2001-05-09 12:01   ` [Caml-list] About documentation tools David Mentre
2001-05-09 13:18     ` [Caml-list] " Markus Mottl
2001-05-09 18:17       ` John Max Skaller
2001-05-09 17:58   ` [Caml-list] CDK binary release John Max Skaller
2001-05-09 22:40     ` Markus Mottl
2001-05-09 23:19       ` John Max Skaller
2001-05-10  9:19         ` Fabrice Le Fessant
2001-05-10 10:34           ` [Caml-list] CDK Documentation format Dave Mason
2001-05-13 21:26             ` Stefan Monnier
2001-05-10 11:16           ` [Caml-list] CDK binary release Sven LUTHER
2001-05-10 13:18             ` Markus Mottl
2001-05-10 15:42               ` Jean-Christophe Filliatre
2001-05-10 16:08                 ` Thorsten Ohl
2001-05-10 22:53                   ` Markus Mottl
2001-05-10 20:36                 ` John Max Skaller
2001-05-10 14:01             ` David Mentre [this message]
2001-05-10 15:09             ` Patrick M Doane
2001-05-10 15:06           ` Patrick M Doane
2001-05-11 11:58             ` Fabrice Le Fessant
2001-05-11 15:31               ` John Max Skaller
2001-05-11 15:44                 ` Fabrice Le Fessant
2001-05-13 21:33                 ` Stefan Monnier
2001-05-11 17:30               ` Patrick M Doane
2001-05-12  7:46                 ` Fabrice Le Fessant
2001-05-11 23:24               ` Brian Rogoff
2001-05-10 15:49           ` John Max Skaller
2001-05-14  8:21 ` Olivier Andrieu

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=qtleltxcng4.fsf@pochi.inria.fr \
    --to=david.mentre@inria.fr \
    --cc=caml-list@inria.fr \
    --cc=fabrice.le_fessant@inria.fr \
    --cc=luther@dpt-info.u-strasbg.fr \
    --cc=mottl@miss.wu-wien.ac.at \
    --cc=skaller@ozemail.com.au \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).