Bug 69087

Summary: sysutils/mkisofs no longer exist
Product: Documentation Reporter: Mohacsi Janos <mohacsi>
Component: Books & ArticlesAssignee: Giorgos Keramidas <keramida>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Mohacsi Janos 2004-07-15 09:30:27 UTC
	sysutils/mkisofs no longer exist (i.e merged to sysutils/cdrtools)
	There are lots of reference to mkisofs that has to be update:
	1. man page of burncd
	2. Chapter 16 of FreeBSD Handbook

Fix: 

Do I send patches?
How-To-Repeat: 	Read man page and Chapter 16.
Comment 1 Giorgos Keramidas freebsd_committer freebsd_triage 2004-07-15 13:44:50 UTC
On 2004-07-15 10:23, Janos Mohacsi <mohacsi@niif.hu> wrote:
> sysutils/mkisofs no longer exist (i.e merged to sysutils/cdrtools)
> There are lots of reference to mkisofs that has to be update:
> 1. man page of burncd
> 2. Chapter 16 of FreeBSD Handbook

Does this patch look ok for the Handbook chapter?

%%
Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v
retrieving revision 1.212
diff -u -r1.212 chapter.sgml
--- chapter.sgml	14 Jul 2004 05:33:13 -0000	1.212
+++ chapter.sgml	15 Jul 2004 12:43:07 -0000
@@ -920,13 +920,13 @@
 	working with systems that do not support those extensions.</para>
 
       <indexterm>
-        <primary><filename role="package">sysutils/mkisofs</filename></primary>
+        <primary><filename role="package">sysutils/cdrtools</filename></primary>
       </indexterm>
-      <para>The <filename role="package">sysutils/mkisofs</filename>
-	program is used to produce a data file containing an ISO 9660 file
+      <para>The <filename role="package">sysutils/cdrtools</filename>
+	port includes &man.mkisofs.8;, a program that you can use 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
-	<filename role="package">sysutils/mkisofs</filename> port.</para>
+	described below.</para>
 
       <indexterm>
         <primary>CD burner</primary>
@@ -972,7 +972,9 @@
     <sect2 id="mkisofs">
       <title>mkisofs</title>
 
-      <para><filename role="package">sysutils/mkisofs</filename> produces an ISO 9660 file system
+      <para>The &man.mkisofs.8; program, which is part of the
+	<filename role="package">sysutils/cdrtools</filename> port,
+        produces an ISO 9660 file system
 	that is an image of a directory tree in the &unix; file system name
 	space. The simplest usage is:</para>
 
@@ -1045,7 +1047,7 @@
 	and <filename>/tmp/myboot</filename> are identical.</para>
 
       <para>There are many other options you can use with
-	<filename role="package">sysutils/mkisofs</filename> to fine-tune its behavior.  In particular:
+	&man.mkisofs.8; to fine-tune its behavior.  In particular:
 	modifications to an ISO 9660 layout and the creation of Joliet
 	and HFS discs.  See the	&man.mkisofs.8; manual page for details.</para>
     </sect2>
@@ -1213,7 +1215,7 @@
 
       <para>You can copy a data CD to a image file that is
 	functionally equivalent to the image file created with
-	<filename role="package">sysutils/mkisofs</filename>, and you can use it to duplicate
+        &man.mkisofs.8;, and you can use it to duplicate
 	any data CD.  The example given here assumes that your CDROM
 	device is <devicename>acd0</devicename>.  Substitute your
 	correct CDROM device.  Under &os;&nbsp;4.X, a <literal>c</literal> must be appended
@@ -1307,7 +1309,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>
+	  &man.mkisofs.8; as described above.</para>
     </sect2>
 
     <sect2 id="atapicam">
%%
Comment 2 Giorgos Keramidas freebsd_committer freebsd_triage 2004-07-15 13:49:48 UTC
On 2004-07-15 10:23, Janos Mohacsi <mohacsi@niif.hu> wrote:
> sysutils/mkisofs no longer exist (i.e merged to sysutils/cdrtools)
> There are lots of reference to mkisofs that has to be update:
> 1. man page of burncd

Here's a patch for the burncd manpage too.  Does this look ok?
I'm most concerned about the use of .Pa to mark up the port name.

%%
Index: burncd.8
===================================================================
RCS file: /home/ncvs/src/usr.sbin/burncd/burncd.8,v
retrieving revision 1.31
diff -u -r1.31 burncd.8
--- burncd.8	18 Nov 2003 02:33:27 -0000	1.31
+++ burncd.8	15 Jul 2004 12:46:39 -0000
@@ -179,7 +179,9 @@
 .Xr mkisofs 8 ,
 available in the
 .Fx
-Ports Collection, is commonly used to create ISO9660 file system images
+Ports Collection as part of the
+.Pa sysutils/cdrtools
+port, is commonly used to create ISO9660 file system images
 from a given directory tree.
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
%%
Comment 3 Mohacsi Janos 2004-07-15 14:11:23 UTC
On Thu, 15 Jul 2004, Giorgos Keramidas wrote:

> Does this patch look ok for the Handbook chapter?
>

Yes, I think so.

Janos Mohacsi
Network Engineer, Research Associate
NIIF/HUNGARNET, HUNGARY
Key 00F9AF98: 8645 1312 D249 471B DBAE  21A2 9F52 0D1F 00F9 AF98
Comment 4 Giorgos Keramidas freebsd_committer freebsd_triage 2004-07-15 16:54:01 UTC
On 2004-07-15 15:11, Mohacsi Janos <mohacsi@niif.hu> wrote:
> On Thu, 15 Jul 2004, Giorgos Keramidas wrote:
> >Does this patch look ok for the Handbook chapter?
>
> Yes, I think so.

Nice.  If nobody raises any ort of objections or has style comments to
make, I'll commit this tomorrow morning at 10:00-11:00 EEST -- that is,
in about 14 hours.

Giorgos
Comment 5 Giorgos Keramidas freebsd_committer freebsd_triage 2004-07-16 11:21:42 UTC
State Changed
From-To: open->closed

I've committed some fixes to burncd.8 and the Handbook.  If you happen 
to notice any other places where the sysutils/mkisofs port is 
mentioned please let us know :) 


Comment 6 Giorgos Keramidas freebsd_committer freebsd_triage 2004-07-16 11:21:42 UTC
Responsible Changed
From-To: freebsd-doc->keramida