Date: Tue, 2 Apr 2002 11:01:55 -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: <20020402110155.31a21fac.darklogik@pittgoth.com> In-Reply-To: <20020402114210.GB8887@submonkey.net> References: <200204011710.g31HA4891168@freefall.freebsd.org> <20020401202402.B1814@straylight.oblivion.bg> <20020402114210.GB8887@submonkey.net>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 2 Apr 2002 12:42:10 +0100
Ceri <setantae@submonkey.net> wrote:
> 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 ?! :)
Never will they heal ;)
>
> 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 ;)
>
> > > 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. This one is your call
Ceri, were both still mentor-bound ;)
>
> Ceri
>
> --
> keep a mild groove on
>
> To Unsubscribe: send mail to majordomo@FreeBSD.org
> with "unsubscribe freebsd-doc" in the body of the message
>
--
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?20020402110155.31a21fac.darklogik>