scsh-users
[Top] [All Lists]

Re: documentation

To: scsh@martigny.ai.mit.edu
Subject: Re: documentation
From: spot@sandoz.cs.cmu.edu (Scott Draves)
Date: 18 Apr 1996 21:39:55 GMT
Organization: Carnegie-Mellon University, School of Computer Science
> Another possibility besides SGML would be to use Scott Draves' markup system.

which is available from http://www.cs.cmu.edu/~spot/markup or just
ftp://hopeless.mess.cs.cmu.edu/spot/markup.tar.gz

the latest release (0.4) fixes the problem with recent versions of
pnmscale that caused blank gif files.

the advantage of markup over sgml is that it has a very clean syntax
and extension model, and it already exists (though it could use a few
more more features).

one thing i've wondered is what's the ideal markup syntax for stuff
like

\defun  {port->string}      {port} {\str}
\defunx {port->sexp-list}   {port} {list}
\begin{desc}
...
\end{desc}

\dfn {run/port+proc} {. \var{epf}} {[port proc]} {syntax}
\dfnx {\&}       {. \var{epf}} {\integer}  {syntax}

-- 
                                balance
                                equilibrium
                                death

http://www.cs.cmu.edu/~spot
spot@cs.cmu.edu

<Prev in Thread] Current Thread [Next in Thread>