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> In-Reply-To: <20020402110155.31a21fac.darklogik@pittgoth.com> References: <200204011710.g31HA4891168@freefall.freebsd.org> <20020401202402.B1814@straylight.oblivion.bg> <20020402114210.GB8887@submonkey.net> <20020402110155.31a21fac.darklogik@pittgoth.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020402160648.GA11708>