Re: Use of SGML for documentation (Re: potato -> woody upgrade not smooth...)

[mdanish@andrew.cmu.edu]

Please CC me if you reply to debian-sgml only.
On Sat, Jul 07, 2001 at 05:14:43PM -0400, Matt Zimmerman wrote:
> On Sat, Jul 07, 2001 at 01:14:05PM -0400, mdanish@andrew.cmu.edu wrote:
> 
> > Okay, I have taken a look at debiandoc, but I have an issue: What I had been
> > envisioning is some sort of quick-reference chart that you could print out in
> > one or two pages and put on up your wall :) I really don't see how debiandoc
> > (or even DocBook, Wichert) fits into this, it seems to be meant for
> > outputting a nice book format style document.  Is there some sort of
> > "document class", or whatever they call it, for this?
> 
> I agree that debiandoc (if we are to continue to use it) needs something like
> this.  It is simple enough, though, that looking at a few documents written
> with it is sufficient to get you started.
> 
> I'm pretty sure there are a few quick-reference documents for DocBook.

I'm sorry, this is not what I meant.  What I meant was that I wanted my
document to be formatted as a quick-reference chart, since that is pretty
much what it is.  Something you could refer to quickly and easily, without
having to navigate chapters and title pages.. etc.

> 
> > > > And if I want to write data in an easily manipulatable form, I use Lisp.
> > > 
> > > I refuse to believe that you're advocating writing documentation in LISP.
> > LISP is a data-representation format.  
> 
> I don't think I was advocating using SGML or any related technology as a
> general-purpose data-representation format (as some have insisted XML is).
> 
> -- 
>  - mdz
> 
> 
> -- 
> To UNSUBSCRIBE, email to debian-devel-request@lists.debian.org
> with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
> 

-- 
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Matthew Danish                         email: mdanish@andrew.cmu.edu ;;
;; OpenPGP public key available from:        'finger mrd@db.debian.org' ;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;