From owner-freebsd-questions@FreeBSD.ORG Fri Jun 16 06:43:26 2006 Return-Path: X-Original-To: freebsd-questions@freebsd.org Delivered-To: freebsd-questions@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A101C16A47A for ; Fri, 16 Jun 2006 06:43:26 +0000 (UTC) (envelope-from fbsdlists@gmail.com) Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.172]) by mx1.FreeBSD.org (Postfix) with ESMTP id E688B43D48 for ; Fri, 16 Jun 2006 06:43:25 +0000 (GMT) (envelope-from fbsdlists@gmail.com) Received: by ug-out-1314.google.com with SMTP id m3so1549487uge for ; Thu, 15 Jun 2006 23:43:24 -0700 (PDT) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=mMiKM66AYAw/8fL2U4FBnpdjaxs3UKmherki1KLzveqAEyuvqjliCFKmBAyJq5t0udIa4W0dOi2YuJwuCJdHbS1vRbJO5KjV75AxGCpaDT4cpWaH3wFsK1xLHX/0Hou5AiFlhme2l8fz3vJokmUj9IhZPpYDaXd+FZkjiMA02Q4= Received: by 10.78.31.18 with SMTP id e18mr796266hue; Thu, 15 Jun 2006 14:44:29 -0700 (PDT) Received: by 10.78.12.15 with HTTP; Thu, 15 Jun 2006 14:44:29 -0700 (PDT) Message-ID: <54db43990606151444p58169468l36a66814bc6d8425@mail.gmail.com> Date: Thu, 15 Jun 2006 17:44:29 -0400 From: "Bob Johnson" To: "Chuck Robey" In-Reply-To: <4491B189.3020201@chuckr.org> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <448E5692.1070105@chuckr.org> <448EC4A6.50808@scls.lib.wi.us> <4491B189.3020201@chuckr.org> Cc: Greg Barniskis , freebsd-questions Subject: Re: formatting tools for Docbook X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 Jun 2006 06:43:26 -0000 On 6/15/06, Chuck Robey wrote: > Greg Barniskis wrote: > > > Chuck Robey wrote: > > > docs, because then no one else would be able to use my documents. Am I > wrong in considering the FDP generated documentation as being in that > category, not terribly uselful outside the FreeBSD project. I believe you are wrong, or I misunderstand the question. I haven't used XML DocBook, but I've used DocBook with DSSSL. I assume what you are really asking is not whether the FreeBSD extensions to the DocBook markup language are a problem (they aren't), but whether the stylesheets used by FreeBSD are compatible with those on other systems. They are (or they claim to be, as I said I haven't actually used the XML/XSL tools yet). To clarify: the real issue for me, and probably what you are really referring to, is that the output format is not defined by the DocBook markup, but by the stylesheets (or equivalent) in the tool set used to produce the output. That's both the advantage and disadvantage of Docbook (and SGML in general). If you want strict control of the output format, then you run into the problem of a standard stylesheet format so you can also distribute your stylesheets along with your marked up documents. DSSSL stylesheets are an incredible pain to modify, and I sympathize with your desire to avoid them. XSL stylesheets are becoming a widely accepted standard, so that's the way to go, and since they are pretty much a standard, the details of what tools you use to do your document rendering shouldn't matter. If you need to modify the "standard" XSL stylesheets to meet your needs, just distribute the modified stylesheets along with your marked up documents and that should allow the person at the other end to duplicate your output. The FreeBSD XML DocBook tool set claims to use XSL stylesheets, so as I said, the answer to your question should be "no, the tools are not FreeBSD specific". Is that explanation helping at all, or am I way off track? And have I said anything that is just flat wrong? You may also want to look at http://wiki.docbook.org/topic/DocBookXslStylesheets if you haven't already. - Bob