Date: Tue, 2 Apr 2002 11:38:06 -0500 From: Tom Rhodes <darklogik@pittgoth.com> To: Ceri <setantae@submonkey.net> Cc: roam@ringlet.net, freebsd-doc@FreeBSD.ORG Subject: Re: docs/36618: [PATCH] Chapter Storage: bad link to mkisofs Message-ID: <20020402113806.018443fb.darklogik@pittgoth.com> In-Reply-To: <20020402160648.GA11708@submonkey.net> References: <200204011710.g31HA4891168@freefall.freebsd.org> <20020401202402.B1814@straylight.oblivion.bg> <20020402114210.GB8887@submonkey.net> <20020402110155.31a21fac.darklogik@pittgoth.com> <20020402160648.GA11708@submonkey.net>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 2 Apr 2002 17:06:48 +0100
Ceri <setantae@submonkey.net> wrote:
> 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....
Perfect for a temporary fix ;) But your right, we do need some
kind of (if a port isn't there, how to handle it tag)
>
> 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"> ?
Perhaps ;)
>
> > This one is your call
> > Ceri, were both still mentor-bound ;)
>
> Oh no, you don't! ;)
HAHAHA I KNEW i'd hear that!
>
> 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.
But your so good ;)
>
> I agree with Peter that SOMEONE should fix it, however.
> ("How *do* you spell your first name, Mr. Else..?")
How are you, i'm Mr. Else, and I appoint user trhodes for this...
<Mr.Else> Tom get off yer ass and fix it
<trhodes> Yes sir, getting off my ass and fixing it sir
<Mr.Else> And bring me my tea while your at it!
>
> Ceri
>
> --
> keep a mild groove on
>
--
Tom (Darklogik) Rhodes
www.FreeBSD.org -The Power To Serve
www.Pittgoth.com -Pittgoth Discussion Portal
trhodes@{Pittgoth.com, FreeBSD.org}
PGP key by www:
http://www.pittgoth.com/~darklogik/darklogik.key
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?20020402113806.018443fb.darklogik>