From owner-freebsd-doc Thu Mar 14 18:10: 9 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ruhr.de (in-ruhr4.ruhr.de [212.23.134.2]) by hub.freebsd.org (Postfix) with SMTP id BEFBA37B417 for ; Thu, 14 Mar 2002 18:09:53 -0800 (PST) Received: (qmail 23847 invoked by uid 10); 15 Mar 2002 02:09:52 -0000 Received: (from ue@localhost) by nathan.ruhr.de (8.11.6/8.11.2) id g2F21LY23705; Fri, 15 Mar 2002 03:01:21 +0100 (CET) (envelope-from ue) Date: Fri, 15 Mar 2002 03:01:21 +0100 From: Udo Erdelhoff To: "Bruce A. Mah" Cc: freebsd-doc@freebsd.org Subject: Re: FreeBSD/sparc64 install document active in -CURRENT Message-ID: <20020315020121.GY90154@nathan.ruhr.de> Mail-Followup-To: "Bruce A. Mah" , freebsd-doc@freebsd.org References: <200203140543.g2E5hek56478@bmah.dyndns.org> <20020314185648.GO90154@nathan.ruhr.de> <200203142134.g2ELY8O23997@bmah.dyndns.org> <20020314222604.GU90154@nathan.ruhr.de> <20020314224338.GV90154@nathan.ruhr.de> <200203150023.g2F0Nce26272@bmah.dyndns.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <200203150023.g2F0Nce26272@bmah.dyndns.org> User-Agent: Mutt/1.3.27i 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 Bruce, > Maybe we could use your stylesheet hack > to switch to text callouts for the release documentation only. this is no problem as I found the solution in the meantime (the article was written for DocBook 3.1): RCS file: /home/ncvs/src/release/doc/en_US.ISO8859-1/share/sgml/release.dsl,v retrieving revision 1.4 diff -u -r1.4 release.dsl --- release.dsl 11 Dec 2001 23:55:41 -0000 1.4 +++ release.dsl 15 Mar 2002 01:07:25 -0000 @@ -11,6 +11,10 @@ + I'd prefer to put it into both files, just to make sure that these !"§$% graphics don't litter the repo and websitre tree. > If there is no easy way around this, I will drop my original objection > to the extra text within the element. No need - it is worth doing, so it is worth doing it right. > PS. Nice article on callouts BTW. What about dropping this into the > tree? The core of this article was originally written a long, long time ago to be included in the FDP. Back then, the callouts section of the FDP consisted of nothing more than a 'this must be documented' remark. So I wrote this thing and sent it to Nik, saying 'Hey, here is the missing callout chapter for the FDP.' In reaction, Nik added his own version of the callout chapter (about a week later, IIRC). Until today, there hasn't been a single reply from him to my original mail which led me to believe that my contribution was a) not suitable for the project b) not worth commenting Having you ask for its inclusion now... Well, it proves that the item #2 on the big list of rules for committers is there for a reason. Especially because this article uses a modified build environment that a) is able to handle more than one sgml file in one directory b) seperates the jade processing from the tidy procesing Which is also something I offered to the project and which was also ignored. Especially point a) would have been a GREAT benefit as it would have stopped the /chapter.sgml /chapter.sgml thing we have now. Which is major pain in the posterior if you are working on several documents at once: "Ok, I have three editors with chapter.sgml. Which one is the one I want?". Point b) is no longer intresting because the default Makefiles used by the FDP are finally making of use of make's main reason for existance: If the created file is newer than the file it was created from, you do not have to touch it. Back then, make would always build everyting... Ah, the irony of it all... /s/Udo -- "Treason is a charge invented by winners as an excuse for hanging the losers." - Benjamin Franklin, ca. 1776 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message