From owner-freebsd-doc Mon Jul 16 5:53: 6 2001 Delivered-To: freebsd-doc@freebsd.org Received: from smtp012.mail.yahoo.com (smtp012.mail.yahoo.com [216.136.173.32]) by hub.freebsd.org (Postfix) with SMTP id 9CB7C37B401 for ; Mon, 16 Jul 2001 05:53:00 -0700 (PDT) (envelope-from wyldephyre2@yahoo.com) Received: from ae07209.powerup.com.au (HELO warhawk) (203.147.166.209) by smtp.mail.vip.sc5.yahoo.com with SMTP; 16 Jul 2001 12:52:59 -0000 X-Apparently-From: From: "Haikal Saadh" To: "Nik Clayton" Cc: Subject: RE: New article on Firewall-1 and FreeBSD Date: Mon, 16 Jul 2001 22:57:17 +1000 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.2416 (9.0.2910.0) X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400 Importance: Normal In-Reply-To: <20010714111644.G35484@clan.nothing-going-on.org> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Hi, I think this should go into the fdp primer, perhaps in an "Overview Section"? From reading just the primer, I was under the impression that I had to jump through numerous hoops before I could get a document up and running. Now that I see otherwise, I may actually give writing something a go. > -----Original Message----- > From: owner-freebsd-doc@FreeBSD.ORG > [mailto:owner-freebsd-doc@FreeBSD.ORG]On Behalf Of Nik Clayton > Sent: Saturday, 14 July 2001 8:17 PM > To: Jon O . > Cc: freebsd-doc@FreeBSD.ORG > Subject: Re: New article on Firewall-1 and FreeBSD > > > On Fri, Jul 13, 2001 at 06:49:34PM -0700, Jon O . wrote: > > Hello: > > > > A friend and I have written an article outlining how > > to create a VPN between Checkpoint Firewall-1 and FreeBSD > > using Kame and racoon. I've converted the article to the > > standard FreeBSD html style for your review here: > > > > http://www.securityreports.com/vpn/index.html > > > > Please send me any feedback you have. > > Looks good. It's not an area I'm familiar with, so I can't say more > than that :-) > > > Also, I have another article in the first stages outlining > > how to create a VPN between FreeBSD and Windows 2000. > > My understanding is that I should write any docs in SGML then > > use a tool to convert to HTML (the FreeBSD HTML style). > > Is this correct? > > Yes. By far the easiest way to do it is. > > 1. Install the docproj/ meta-port, as described in the Doc. Proj. > Primer, at > http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ > > 2. Get a local copy of the FreeBSD doc/ tree. Either use CVSup in > "checkout" mode to do this, or get a full copy of the CVS repository > locally. > > If you have the CVS repository locally then as a minimum you will > need to checkout the doc/share, doc/en_US.ISO8859-1/share, and > doc/en_US.ISO8859-1/articles directories. > > 3. Place your document in a subdirectory of the articles/ directory, > (perhaps vpn-w2k/) call it article.sgml, and give it a Makefile > (which you can copy from any of the other articles). > > 4. Edit away. > > 5. To convert your document from DocBook to another format simply do > > make FORMAT=foo > > where 'foo' is one of html, html-split, txt, ps, pdf, rtf, or pdb. > > 6. Submit article.sgml using send-pr. > > > The article listed above is in HTML > > using another FreeBSD article as an example. I suppose > > it can't be converted to SGML from HTML > > I think there are mechanical converters around, but they tend to work > best on big documents -- the Firewall 1 article isn't too big, so doing > it manually should probably only take about 30 minutes. > > N > -- > FreeBSD: The Power to Serve http://www.freebsd.org/ > FreeBSD Documentation Project http://www.freebsd.org/docproj/ > > --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- > _________________________________________________________ Do You Yahoo!? Get your free @yahoo.com address at http://mail.yahoo.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message