From martin@sumuk.de  Mon Apr  1 08:19:03 2002
Return-Path: <martin@sumuk.de>
Received: from Kain.sumuk.de (Kain.sumuk.de [213.221.86.114])
	by hub.freebsd.org (Postfix) with ESMTP id 684FA37B419
	for <FreeBSD-gnats-submit@freebsd.org>; Mon,  1 Apr 2002 08:19:02 -0800 (PST)
Received: from Moses.earth.sol (Moses.earth.sol [192.168.1.1])
	by Kain.sumuk.de (8.11.6/8.11.6) with ESMTP id g31GJ1N39711
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 1 Apr 2002 18:19:01 +0200 (CEST)
	(envelope-from martin@sumuk.de)
Received: (from vincent@localhost)
	by Moses.earth.sol (8.11.6/8.11.6) id g31GIxF14380;
	Mon, 1 Apr 2002 18:18:59 +0200 (CEST)
	(envelope-from vincent)
Message-Id: <200204011618.g31GIxF14380@Moses.earth.sol>
Date: Mon, 1 Apr 2002 18:18:59 +0200 (CEST)
From: Martin Heinen <martin@sumuk.de>
Reply-To: Martin Heinen <martin@sumuk.de>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] Chapter Storage: bad link to mkisofs
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         36618
>Category:       docs
>Synopsis:       [PATCH] Chapter Storage: bad link to mkisofs
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Apr 01 08:20:01 PST 2002
>Closed-Date:    Mon Jul 01 09:12:51 PDT 2002
>Last-Modified:  Mon Jul 01 09:12:51 PDT 2002
>Originator:     Martin Heinen
>Release:        FreeBSD 4.4-STABLE i386
>Organization:
>Environment:
System: FreeBSD Moses.earth.sol 4.4-STABLE FreeBSD 4.4-STABLE #0: Sat Dec 22 07:35:30 CET 2001 toor@Moses.earth.sol:/usr/obj/usr/src/sys/MOSES i386


	
>Description:
	The section 'Burning Raw Data CDs' still contains a bad link
	to the mkisofs port (left over from revisions 1.84 and 1.85).
	Replaced the link with <command>mkisofs</command>
>How-To-Repeat:
	Click on the 'sysutils/mkisofs' link in the aforementioned
	section.
>Fix:
Index: chapter.sgml
===================================================================
RCS file: /u/cvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v
retrieving revision 1.86
diff -u -r1.86 chapter.sgml
--- chapter.sgml	1 Apr 2002 14:39:23 -0000	1.86
+++ chapter.sgml	1 Apr 2002 16:04:13 -0000
@@ -1004,7 +1004,7 @@
 	  Such a CDROM cannot be read under any operating system
 	  except FreeBSD.  If you want to be able to mount the CD, or
 	  share data with another operating system, you must use
-	  <filename role="package">sysutils/mkisofs</filename> as described above.</para>
+	  <command>mkisofs</command> as described above.</para>
     </sect2>
   </sect1>
   
>Release-Note:
>Audit-Trail:

From: Tom Rhodes <darklogik@pittgoth.com>
To: Martin Heinen <martin@sumuk.de>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/36618: [PATCH] Chapter Storage: bad link to mkisofs
Date: Mon, 1 Apr 2002 11:45:48 -0500

 On Mon, 1 Apr 2002 18:18:59 +0200 (CEST)
 Martin Heinen <martin@sumuk.de> wrote:
  
 > 	
 > >Description:
 > 	The section 'Burning Raw Data CDs' still contains a bad link
 > 	to the mkisofs port (left over from revisions 1.84 and 1.85).
 > 	Replaced the link with <command>mkisofs</command>
 > >How-To-Repeat:
 > 	Click on the 'sysutils/mkisofs' link in the aforementioned
 > 	section.
 > >Fix:
 > Index: chapter.sgml
 > ===================================================================
 > RCS file:
 > /u/cvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v
 > retrieving revision 1.86 diff -u -r1.86 chapter.sgml
 > --- chapter.sgml	1 Apr 2002 14:39:23 -0000	1.86
 > +++ chapter.sgml	1 Apr 2002 16:04:13 -0000
 > @@ -1004,7 +1004,7 @@
 >  	  Such a CDROM cannot be read under any operating system
 >  	  except FreeBSD.  If you want to be able to mount the CD, or
 >  	  share data with another operating system, you must use
 > -	  <filename role="package">sysutils/mkisofs</filename> as
 > described above.</para>+	  <command>mkisofs</command> as described
 > above.</para>     </sect2>
 >    </sect1>
 
 
 %mkisofs
 mkisofs: Command not found.
 
 Not a command, I think this has been discussed a few times in the
 past, its not really the link, I think the port is lacking a file, but
 it would be best to dig through our FreeBSD-doc archives.  Hence, if
 this was going to be changed, i'd rather see <application> tags used. 
 Comments from anyone are very welcome.
 
 -- 
 Tom (Darklogik) Rhodes
 www.FreeBSD.org  -The Power To Serve
 www.Pittgoth.com -Pittgoth Discussion Portal
 trhodes@ {Pittgoth.com, FreeBSD.org}

From: Martin Heinen <martin@sumuk.de>
To: Tom Rhodes <darklogik@pittgoth.com>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/36618: [PATCH] Chapter Storage: bad link to mkisofs
Date: Mon, 1 Apr 2002 18:53:07 +0200

 On Mon, Apr 01, 2002 at 11:45:48AM -0500, Tom Rhodes wrote:
 > On Mon, 1 Apr 2002 18:18:59 +0200 (CEST)
 > Martin Heinen <martin@sumuk.de> wrote:
 >  
 > > 	
 > > >Description:
 > > 	The section 'Burning Raw Data CDs' still contains a bad link
 > > 	to the mkisofs port (left over from revisions 1.84 and 1.85).
 > > 	Replaced the link with <command>mkisofs</command>
 > > >How-To-Repeat:
 > > 	Click on the 'sysutils/mkisofs' link in the aforementioned
 > > 	section.
 > > >Fix:
 > > Index: chapter.sgml
 > > ===================================================================
 > > RCS file:
 > > /u/cvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v
 > > retrieving revision 1.86 diff -u -r1.86 chapter.sgml
 > > --- chapter.sgml	1 Apr 2002 14:39:23 -0000	1.86
 > > +++ chapter.sgml	1 Apr 2002 16:04:13 -0000
 > > @@ -1004,7 +1004,7 @@
 > >  	  Such a CDROM cannot be read under any operating system
 > >  	  except FreeBSD.  If you want to be able to mount the CD, or
 > >  	  share data with another operating system, you must use
 > > -	  <filename role="package">sysutils/mkisofs</filename> as
 > > described above.</para>+	  <command>mkisofs</command> as described
 > > above.</para>     </sect2>
 > >    </sect1>
 > 
 > 
 > %mkisofs
 > mkisofs: Command not found.
 > 
 > Not a command, I think this has been discussed a few times in the
 > past, its not really the link, I think the port is lacking a file, but
 > it would be best to dig through our FreeBSD-doc archives.  Hence, if
 > this was going to be changed, i'd rather see <application> tags used. 
 > Comments from anyone are very welcome.
 
 mkisofs is installed through the cdrtools meta-port, therefore
 linking to
 
   http://www.freebsd.org/cgi/url.cgi?ports/sysutils/mkisofs/pkg-descr
 
 doesn't work.  Note that marking up a port with <filename role="package">
 links to the description of that port.  If <command> is resticted
 to binaries of the base system, than I'm fine with <application>
 (I'm fine with <application> anyway :).
 
 Martin
 
 -- 
 Marxpitn

From: Tom Rhodes <darklogik@pittgoth.com>
To: Martin Heinen <martin@sumuk.de>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/36618: [PATCH] Chapter Storage: bad link to mkisofs
Date: Mon, 1 Apr 2002 12:12:41 -0500

 On Mon, 1 Apr 2002 18:53:07 +0200
 Martin Heinen <martin@sumuk.de> wrote:
 
 > On Mon, Apr 01, 2002 at 11:45:48AM -0500, Tom Rhodes wrote:
 > > On Mon, 1 Apr 2002 18:18:59 +0200 (CEST)
 > > Martin Heinen <martin@sumuk.de> wrote:
 > >  
 > > > 	
 > > > >Description:
 > > > 	The section 'Burning Raw Data CDs' still contains a bad link
 > > > 	to the mkisofs port (left over from revisions 1.84 and 1.85).
 > > > 	Replaced the link with <command>mkisofs</command>
 > > > >How-To-Repeat:
 > > > 	Click on the 'sysutils/mkisofs' link in the aforementioned
 > > > 	section.
 > > > >Fix:
 > > > Index: chapter.sgml
 > > > ===============================================================
 > > > ==== RCS file:
 > > > /u/cvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v
 > > > retrieving revision 1.86 diff -u -r1.86 chapter.sgml
 > > > --- chapter.sgml	1 Apr 2002 14:39:23 -0000	1.86
 > > > +++ chapter.sgml	1 Apr 2002 16:04:13 -0000
 > > > @@ -1004,7 +1004,7 @@
 > > >  	  Such a CDROM cannot be read under any operating system
 > > >  	  except FreeBSD.  If you want to be able to mount the CD, or
 > > >  	  share data with another operating system, you must use
 > > > -	  <filename role="package">sysutils/mkisofs</filename> as
 > > > described above.</para>+	  <command>mkisofs</command> as
 > > > described above.</para>     </sect2>
 > > >    </sect1>
 > > 
 > > 
 > > %mkisofs
 > > mkisofs: Command not found.
 > > 
 > > Not a command, I think this has been discussed a few times in the
 > > past, its not really the link, I think the port is lacking a file,
 > > but it would be best to dig through our FreeBSD-doc archives. 
 > > Hence, if this was going to be changed, i'd rather see
 > > <application> tags used. Comments from anyone are very welcome.
 > 
 > mkisofs is installed through the cdrtools meta-port, therefore
 > linking to
 > 
 >   http://www.freebsd.org/cgi/url.cgi?ports/sysutils/mkisofs/pkg-descr
 > 
 > doesn't work.  Note that marking up a port with <filename
 > role="package"> links to the description of that port.  If <command>
 > is resticted to binaries of the base system, than I'm fine with
 > <application>(I'm fine with <application> anyway :).
 > 
 > Martin
 > 
 > -- 
 > Marxpitn
 > 
 
 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 ;)
 
 Even though this has been pointed out before, its about time
 SOMEONE fixed it.  Thanks alot for your help Martin!
 
 -- 
 Tom (Darklogik) Rhodes
 www.FreeBSD.org  -The Power To Serve
 www.Pittgoth.com -Pittgoth Discussion Portal
 trhodes@ {Pittgoth.com, FreeBSD.org}
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Mon Jul 1 08:34:59 PDT 2002 
Responsible-Changed-Why:  
I was working on this awhile ago, and owe everyone an apology for my lack 
of work time. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=36618 
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Mon Jul 1 09:11:13 PDT 2002 
State-Changed-Why:  
With the remnant mkisofs listings in the handbook obtaining my fix, this is 
the end of our 404's... (for mkisofs anyway) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=36618 
>Unformatted:
