Date: Fri, 15 Mar 2002 03:01:21 +0100 From: Udo Erdelhoff <ue@nathan.ruhr.de> To: "Bruce A. Mah" <bmah@freebsd.org> Cc: freebsd-doc@freebsd.org Subject: Re: FreeBSD/sparc64 install document active in -CURRENT Message-ID: <20020315020121.GY90154@nathan.ruhr.de> In-Reply-To: <200203150023.g2F0Nce26272@bmah.dyndns.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>
next in thread | previous in thread | raw e-mail | index | archive | help
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 @@
<style-specification-body>
<![ %output.html; [
+ (define %callout-graphics%
+ ;; Use graphics in callouts?
+ #f)
+
(define ($email-footer$)
(make sequence
(make element gi: "p"
It is also be possible to put this statement into
src/release/doc/share/sgml/release.dsl:
RCS file: /home/ncvs/src/release/doc/share/sgml/release.dsl,v
retrieving revision 1.4
diff -u -r1.4 release.dsl
--- release.dsl 7 Jan 2002 03:51:41 -0000 1.4
+++ release.dsl 15 Mar 2002 01:15:47 -0000
@@ -89,6 +89,11 @@
(define %footnote-ulinks% #t)
]]>
+ <![ %output.html; [
+ (define %callout-graphics%
+ ;; Use graphics in callouts?
+ #f)
+ ]]>
</style-specification-body>
</style-specification>
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 <screen></screen> 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 <foo>/chapter.sgml <foo2>/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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020315020121.GY90154>