From owner-freebsd-doc Sun Feb 10 13:19:39 2002 Delivered-To: freebsd-doc@freebsd.org Received: from rwcrmhc53.attbi.com (rwcrmhc53.attbi.com [204.127.198.39]) by hub.freebsd.org (Postfix) with ESMTP id 848DB37BBDA for ; Sun, 10 Feb 2002 13:11:54 -0800 (PST) Received: from bmah.dyndns.org ([12.233.149.189]) by rwcrmhc53.attbi.com (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP id <20020210211103.XFBG2951.rwcrmhc53.attbi.com@bmah.dyndns.org>; Sun, 10 Feb 2002 21:11:03 +0000 Received: (from bmah@localhost) by bmah.dyndns.org (8.11.6/8.11.6) id g1ALAxG79251; Sun, 10 Feb 2002 13:10:59 -0800 (PST) (envelope-from bmah) Message-Id: <200202102110.g1ALAxG79251@bmah.dyndns.org> X-Mailer: exmh version 2.5 07/13/2001 with nmh-1.0.4 To: Dima Dorfman Cc: doc@FreeBSD.ORG Subject: Re: replacement In-reply-to: <20020210100554.9A7DB3E35@bazooka.trit.org> References: <20020210100554.9A7DB3E35@bazooka.trit.org> Comments: In-reply-to Dima Dorfman message dated "Sun, 10 Feb 2002 10:05:49 +0000." From: "Bruce A. Mah" Reply-To: bmah@FreeBSD.ORG X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Sun, 10 Feb 2002 13:10:58 -0800 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 If memory serves me right, Dima Dorfman wrote: > I propose to replace the tag with and a "role" > attribute as follows: > > > > There have been some discussions about this in the past, and I think > everyone agrees that should be taken out and shot. Some people > wanted to do weird (to me, at least) things instead, but I believe the > above is what most people felt comfortable with. Bravo! Thanks for taking the time to do the work on this. > The attached patch makes the above valid and removes . I've > only tested it with HTML output, so if someone could test it with > other output formats I'd appreciate it. The following patches replace > all instances of with the new construct for the doc tree, > relnotes in -current, and relnotes in -stable, respectively: > > http://www.trit.org/~dima/home/p/docport.doc.diff > http://www.trit.org/~dima/home/p/docport.rc.diff > http://www.trit.org/~dima/home/p/docport.r4.diff I tested your patches for RELNOTESng (-CURRENT and 4-STABLE). My usual HTML/PDF/TXT builds went fine, and I did a quick visual inspection of the output. The TXT output looks the same as it did before (no great surprise there). In the PDF files, the old port output used to be rendered in red for some reason (murray and I never were able to figure out why). After your change, the port filenames are rendered in black. I don't know why this changed, but I think it looks better now than it did before. In the HTML files, the stylesheet seems to be causing the port names to be rendered using the style for filenames, rather than the style for hyperlinks (this would be green, rather than blue, on the version of Netscape I have). I presume that an edit to docbook.css could change this back, if desired. I'd say go for it. If there's any little cosmetic tweaks to be made, they can happen after you get the syntactic changes done. Thanks, Bruce. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message