From owner-freebsd-doc  Tue Apr  2  3:42:39 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from rhadamanth.submonkey.net (pc4-card4-0-cust162.cdf.cable.ntl.com [80.4.14.162])
	by hub.freebsd.org (Postfix) with ESMTP id E7F4A37B405
	for <freebsd-doc@freebsd.org>; Tue,  2 Apr 2002 03:42:33 -0800 (PST)
Received: from setantae by rhadamanth.submonkey.net with local (Exim 3.35 #1)
	id 16sMfy-0002NG-00; Tue, 02 Apr 2002 12:42:10 +0100
Date: Tue, 2 Apr 2002 12:42:10 +0100
From: Ceri <setantae@submonkey.net>
To: Peter Pentchev <roam@ringlet.net>
Cc: Tom Rhodes <darklogik@pittgoth.com>, freebsd-doc@FreeBSD.org
Subject: Re: docs/36618: [PATCH] Chapter Storage: bad link to mkisofs
Message-ID: <20020402114210.GB8887@submonkey.net>
Mail-Followup-To: Ceri <setantae@submonkey.net>,
	Peter Pentchev <roam@ringlet.net>,
	Tom Rhodes <darklogik@pittgoth.com>, freebsd-doc@FreeBSD.org
References: <200204011710.g31HA4891168@freefall.freebsd.org> <20020401202402.B1814@straylight.oblivion.bg>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20020401202402.B1814@straylight.oblivion.bg>
User-Agent: Mutt/1.3.28i
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

On Mon, Apr 01, 2002 at 08:24:02PM +0300, Peter Pentchev wrote:
> >  
> >  I'll take this one.  Martin, I feel with you, the <command> and
> >  <application> tags in the Primer MAY need a little bit added
> >  to them, so that users can understand the difference.  A few
> >  times I have been smacked by the difference in use, ask
> >  Ceri about Re: NFS and the part he pointed out where it was
> >  not a command ;)

You still have the scars ?!  :)

Murray and I were talking about this one just a few days ago, where
I strongly objected to using <filename role="package">sysutils/cdrtools</fil..
because that port doesn't actually install mkisofs.

In the interim I think we went for omitting the markup altogether, but I'm
not sure as I don't recall actually looking.  The commit log for
doc/.../books/handbook/disks/chapter.sgml should hold the truth (iirc).

> >  Even though this has been pointed out before, its about time
> >  SOMEONE fixed it.  Thanks alot for your help Martin!
> 
> As noted in PR docs/32468, the real fix would be to add an attribute
> to the <filename> (it was <port> at the time of discussion of 32468,
> it's <filename> now :), which overrides the default pkg-descr file.
> Then, everywhere mkisofs is mentioned, it should just point to the
> cdrtools pkg-descr file.

Agreed. I'd volunteer, but I don't believe my powers quite reach that far yet.

Ceri

-- 
keep a mild groove on

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message