*BSD News Article 85763


Return to BSD News archive

Path: euryale.cc.adfa.oz.au!newshost.carno.net.au!harbinger.cc.monash.edu.au!news.rmit.EDU.AU!news.unimelb.EDU.AU!munnari.OZ.AU!news.ecn.uoknor.edu!feed1.news.erols.com!howland.erols.net!news.mathworks.com!fu-berlin.de!irz401!orion.sax.de!uriah.heep!news
From: j@uriah.heep.sax.de (J Wunsch)
Newsgroups: comp.unix.bsd.freebsd.misc
Subject: Re: PPP how-to available here!
Date: 27 Dec 1996 20:05:26 GMT
Organization: Private BSD site, Dresden
Lines: 40
Message-ID: <5a1a66$df1@uriah.heep.sax.de>
References: <591h16$kue@nntp.interaccess.com> <59uabf$c91@uriah.heep.sax.de>
  <59v617$af4$1@news-s01.ca.us.ibm.net>
Reply-To: joerg_wunsch@uriah.heep.sax.de (Joerg Wunsch)
NNTP-Posting-Host: localhost.heep.sax.de
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 8bit
X-Newsreader: knews 0.9.6
X-Phone: +49-351-2012 669
X-PGP-Fingerprint: DC 47 E6 E4 FF A6 E9 8F  93 21 E0 7D F9 12 D6 4E
Xref: euryale.cc.adfa.oz.au comp.unix.bsd.freebsd.misc:33214

reyes01@ibm.net wrote:

> >Great!  Would you perchance be willing to contribute this in SGML,
> >too, so it can become a part of the handbook?
> 
> I think that we need to add some info on the handbook on how to submit
> documents and some basic info on SGML. I recall once I wanted to help with
> the documentation project and I didn't get very far because I did not know
> SGML and there isn't much online anyway. There is practically nothing
> in the handbook which indicates how/where to send contributions.

Yes.  You should probably approach doc@freebsd.org for this.

> cc to FreeBSD doc

...ah ok, you did.

> What I suggest is that in the handbook we add:
> -A few basic sample SGML pages so people can use them as guide
> -Where existing documents are so people can FTP them to study them and
> modify them.
> -What are the programs one need to use to validate/parse (or whatever one
> needs to do with SGML).

Just what i do if i write a new handbook chapter is:

 cvs co handbook
 cd handbook
 <edit what i like, using the existing stuff as templates>
 make FORMATS=html
 <pick up handbook.html with my browser, re-edit as needed>

But agreed, a little more explanation would help.

-- 
cheers, J"org

joerg_wunsch@uriah.heep.sax.de -- http://www.sax.de/~joerg/ -- NIC: JW11-RIPE
Never trust an operating system you don't have sources for. ;-)