From nobody@FreeBSD.org  Mon Dec  3 05:48:26 2001
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 3FFFB37B416
	for <freebsd-gnats-submit@FreeBSD.org>; Mon,  3 Dec 2001 05:48:26 -0800 (PST)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id fB3DmQe37380;
	Mon, 3 Dec 2001 05:48:26 -0800 (PST)
	(envelope-from nobody)
Message-Id: <200112031348.fB3DmQe37380@freefall.freebsd.org>
Date: Mon, 3 Dec 2001 05:48:26 -0800 (PST)
From: wolfram schneider <wosch@FreeBSD.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: broken link in handbook: sysutils/mkisofs
X-Send-Pr-Version: www-1.0

>Number:         32468
>Category:       docs
>Synopsis:       broken link in handbook: sysutils/mkisofs
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Dec 03 05:50:00 PST 2001
>Closed-Date:    Sat Jun 29 13:36:05 PDT 2002
>Last-Modified:  Sat Jun 29 13:36:05 PDT 2002
>Originator:     wolfram schneider
>Release:        
>Organization:
>Environment:
>Description:
Date: Mon, 19 Nov 2001 23:39:56 -0800 (PST)
From: Todd Greenwood-Geer <tgreenwoodgeer@yahoo.com>
Subject: sysutils/mkisofs
To: www@FreeBSD.ORG


This page is hosting a broken link for:

sysutils/mkisofs

PAGE:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/creating-cds.html

BROKEN LINK:
http://www.freebsd.org/cgi/url.cgi?ports/sysutils/mkisofs/pkg-descr

NOTES:
the function can be found at:

ftp://ftp.freebsd.org/pub/FreeBSD/branches/-current/ports/sysutils/mkisofs/

-Todd
>How-To-Repeat:

>Fix:

>Release-Note:
>Audit-Trail:

From: Alexey Zelkin <phantom@ark.cris.net>
To: wolfram schneider <wosch@FreeBSD.ORG>
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: docs/32468: broken link in handbook: sysutils/mkisofs
Date: Mon, 3 Dec 2001 15:59:01 +0200

 hi,
 
 On Mon, Dec 03, 2001 at 05:48:26AM -0800, wolfram schneider wrote:
 > 
 > >Number:         32468
 > >Category:       docs
 > >Synopsis:       broken link in handbook: sysutils/mkisofs
  
 > This page is hosting a broken link for:
 > 
 > sysutils/mkisofs
 > 
 > PAGE:
 > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/creating-cds.html
 > 
 > BROKEN LINK:
 > http://www.freebsd.org/cgi/url.cgi?ports/sysutils/mkisofs/pkg-descr
 
 Root of problem is that mkisofs is slave port of cdrecord and has not own
 pkg-descr. Correct link should look like
 ..?ports/sysutils/cdrtools/pkg-descr.mkisofs, but current there's no
 simple way to do it in docbook :-(
 
 To fix this problem someone should rewrite this section in order to
 mention cdrtools port istead of mkisofs or directly use correct
 reference to pkg-descr.mkisofs file.
 
 
 

From: Hiten Pandya <hitmaster2k@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc: wosch@FreeBSD.org
Subject: Re: docs/32468: broken link in handbook: sysutils/mkisofs
Date: Tue, 11 Dec 2001 03:49:15 -0800 (PST)

 i have made a patch which resolves the issue, the way
 i have done it is:
 
 - it is not possible to directly link to a port,
 so, i had to remove a sentence from the section and
 add a <note> which explains how to install the new
 mkisofs which, is under sysutils/cdrtools....
 
 i have a patch here...
 
 =Hiten
 =<hiten@uk.FreeBSD.org>
 
 *** chapter.sgml.old Tue Dec 11 11:16:26 2001
 --- chapter.sgml Tue Dec 11 11:35:20 2001
 ***************
 *** 731,738 ****
 <para>The <command><link
 linkend="mkisofs">mkisofs</link></command>
 program is used to produce a data file containing an
 ISO 9660 file
 system. It has options that support various
 extensions, and is
 ! described below. You can install it with the 
 ! <port>sysutils/mkisofs</port> port.</para>
 
 <indexterm>
 <primary>CD burner</primary>
 --- 731,737 ----
 <para>The <command><link
 linkend="mkisofs">mkisofs</link></command>
 program is used to produce a data file containing an
 ISO 9660 file
 system. It has options that support various
 extensions, and is
 ! described below.</para>
 
 <indexterm>
 <primary>CD burner</primary>
 ***************
 *** 749,754 ****
 --- 748,762 ----
 supported drives. To find out if a drive is supported,
 see
 <ulink url="http://freebsd.dk/ata/">CD-R/RW supported
 drives</ulink>.</para>
 + 
 + <note>
 + <para>The <application>mkisofs</application> tool is
 now part of
 + <port>sysutils/cdrtools</port> port. All references
 to 
 + <filename>sysutils/mkisofs</filename> should be
 updated to the
 + later one (<filename>sysutils/cdrtools</filename>);
 i.e. you will
 + need to install <port>sysutils/cdrtools</port>
 inorder to use
 + <application>mkisofs</application>.</para>
 + </note>
 </sect2>
 
 <sect2 id="mkisofs">
 
 
 
 
 =====
 -Hiten,
 
 Thank You,
 Yours Sincerely,
 Hiten Pandya,
 <hiten@uk.freebsd.org>
 <http://www.geocities.com/hitmaster2k>
 
 __________________________________________________
 Do You Yahoo!?
 Check out Yahoo! Shopping and Yahoo! Auctions for all of
 your unique holiday gifts! Buy at http://shopping.yahoo.com
 or bid at http://auctions.yahoo.com

From: Hiten Pandya <hitmaster2k@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org, wosch@FreeBSD.org,
	roam@ringlet.net
Cc:  
Subject: Re: docs/32468: broken link in handbook: sysutils/mkisofs
Date: Tue, 11 Dec 2001 17:27:50 +0000

 the above patch states the change incorrectly, please use this patch
 in-order to
 get the right result.
 
 --- chapter.sgml        Sat Dec  8 12:08:40 2001
 +++ chapter.sgml.new    Tue Dec 11 17:20:30 2001
 @@ -732,7 +732,15 @@
         program is used to produce a data file containing an ISO 9660
 file
         system. It has options that support various extensions, and is
         described below. You can install it with the 
 -       <port>sysutils/mkisofs</port> port.</para>
 +       <port>sysutils/cdrtools</port> port.</para>
 +
 +      <note>
 +        <para>The <application>mkisofs</application> is part of
 <port>cdrtools
 +       </port>.  Inorder to install <application>mkisofs</application>
 you
 +       will need to install <port>sysutils/cdrtools</port>.  Although
 the
 +       <filename>sysutils/mkisofs</filename>> still exists but cannot
 be 
 +       refrenced directly.</para>
 +      </note>
      
        <indexterm>
          <primary>CD burner</primary>
 
 
 The Patch above will show the user why to install sysutils/cdrtools and
 why 
 sysutils/mkisofs cannot be referenced directly.
 
 =Hiten
 =<hiten@uk.FreeBSD.org>

From: Peter Pentchev <roam@ringlet.net>
To: hiten@uk.FreeBSD.org
Cc: freebsd-gnats-submit@FreeBSD.org, wosch@FreeBSD.org
Subject: Re: docs/32468: broken link in handbook: sysutils/mkisofs
Date: Tue, 11 Dec 2001 19:32:58 +0200

 On Tue, Dec 11, 2001 at 05:27:50PM +0000, Hiten Pandya wrote:
 > the above patch states the change incorrectly, please use this patch
 > in-order to
 > get the right result.
 > 
 > --- chapter.sgml        Sat Dec  8 12:08:40 2001
 > +++ chapter.sgml.new    Tue Dec 11 17:20:30 2001
 > @@ -732,7 +732,15 @@
 >         program is used to produce a data file containing an ISO 9660
 > file
 >         system. It has options that support various extensions, and is
 >         described below. You can install it with the 
 > -       <port>sysutils/mkisofs</port> port.</para>
 > +       <port>sysutils/cdrtools</port> port.</para>
 > +
 > +      <note>
 > +        <para>The <application>mkisofs</application> is part of
 > <port>cdrtools
 > +       </port>.  Inorder to install <application>mkisofs</application>
 > you
 > +       will need to install <port>sysutils/cdrtools</port>.  Although
 > the
 > +       <filename>sysutils/mkisofs</filename>> still exists but cannot
 > be 
 > +       refrenced directly.</para>
 > +      </note>
 >      
 >        <indexterm>
 >          <primary>CD burner</primary>
 > 
 > 
 > The Patch above will show the user why to install sysutils/cdrtools and
 > why 
 > sysutils/mkisofs cannot be referenced directly.
 
 Uh.  I only meant that it could not be referenced directly
 in the web-site documentation, because the <port> tag links
 to a pkg-descr file, which is non-existant in this case.
 
 In general, the sysutils/mkisofs port is a very much viable
 and used way to get mkisofs working.  As a matter of fact,
 the src/release/i386/mkisoimages.sh script, used to build
 ISO images of the FreeBSD releases, tries to install exactly
 the sysutils/mkisofs port if no mkisofs binary is found
 on the system.
 
 IMHO, the correct fix in this case should be to fix the doc
 markup scheme, so that the <port> tag allows linking to another
 file instead of pkg-descr.  I'll look into this later today.
 This would let us reference the mkisofs port properly.
 
 G'luck,
 Peter
 
 -- 
 This sentence claims to be an Epimenides paradox, but it is lying.
State-Changed-From-To: open->closed 
State-Changed-By: blackend 
State-Changed-When: Sat Jun 29 13:34:49 PDT 2002 
State-Changed-Why:  
The broken link was fixed. 

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