From owner-freebsd-doc  Tue Apr  2  8: 8: 8 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 58F5F37B4D0
	for <freebsd-doc@freebsd.org>; Tue,  2 Apr 2002 08:06:53 -0800 (PST)
Received: from setantae by rhadamanth.submonkey.net with local (Exim 3.35 #1)
	id 16sQo4-00037A-00; Tue, 02 Apr 2002 17:06:48 +0100
Date: Tue, 2 Apr 2002 17:06:48 +0100
From: Ceri <setantae@submonkey.net>
To: Tom Rhodes <darklogik@pittgoth.com>
Cc: roam@ringlet.net, freebsd-doc@FreeBSD.ORG
Subject: Re: docs/36618: [PATCH] Chapter Storage: bad link to mkisofs
Message-ID: <20020402160648.GA11708@submonkey.net>
Mail-Followup-To: Ceri <setantae@submonkey.net>,
	Tom Rhodes <darklogik@pittgoth.com>, roam@ringlet.net,
	freebsd-doc@FreeBSD.ORG
References: <200204011710.g31HA4891168@freefall.freebsd.org> <20020401202402.B1814@straylight.oblivion.bg> <20020402114210.GB8887@submonkey.net> <20020402110155.31a21fac.darklogik@pittgoth.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20020402110155.31a21fac.darklogik@pittgoth.com>
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 Tue, Apr 02, 2002 at 11:01:55AM -0500, Tom Rhodes wrote:
> Ceri <setantae@submonkey.net> wrote:
> > 
> > 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).
> 
> hmmm.  I do not think we should just drop the markup, because then
> a new user may try to run the application and wonder why its not
> working like we say.  Perhaps, a link to the port?  Just <application>
> tags?  Maybe a regular <filename> tag would do.  But we should point
> out that this is NOT part of the base system ;)

Oh yeah, I meant something like:

    ...from the sysutils/mkisofs port....

as opposed to :

    ...from the <filename role="package">sysutils/mkisofs</filename> port..,

whacked into shape as appropriate for the context.

> > > >  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.
> 
> Perhaps a <filename role="download me"> or something dumb like that,
> for ports that a pkg-descr is not availible.

<filename role="PITA_for_doc"> ?

> This one is your call
> Ceri, were both still mentor-bound ;)

Oh no, you don't! ;)

Having said that, one day I have promised myself I'll look deeper into the
build process of /doc, but then I also promised myself a lot of other stuff,
so don't look toward me for any kind of fix.

I agree with Peter that SOMEONE should fix it, however.
("How *do* you spell your first name, Mr. Else..?")

Ceri

-- 
keep a mild groove on

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