From edwin@mavetju.org  Sun Mar  3 18:37:31 2002
Return-Path: <edwin@mavetju.org>
Received: from topaz.mdcc.cx (topaz.mdcc.cx [212.204.230.141])
	by hub.freebsd.org (Postfix) with ESMTP
	id 07E3637B405; Sun,  3 Mar 2002 18:37:31 -0800 (PST)
Received: from k7.mavetju.org (topaz.mdcc.cx [212.204.230.141])
	by topaz.mdcc.cx (Postfix) with ESMTP
	id ACAE52B696; Mon,  4 Mar 2002 03:37:26 +0100 (CET)
Received: by k7.mavetju.org (Postfix, from userid 1001)
	id 55130302; Mon,  4 Mar 2002 13:37:17 +1100 (EST)
Message-Id: <20020304023717.55130302@k7.mavetju.org>
Date: Mon,  4 Mar 2002 13:37:17 +1100 (EST)
From: Edwin Groothuis <edwin@mavetju.org>
Reply-To: Edwin Groothuis <edwin@mavetju.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc: sos@FreeBSD.org
Subject: [patch] update man-page of burncd(8) to tell about the use of mkisofs before burning a cd.
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         35524
>Category:       bin
>Synopsis:       [patch] update man-page of burncd(8) to tell about the use of mkisofs before burning a cd.
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Mar 03 18:40:01 PST 2002
>Closed-Date:    Thu Mar 28 03:08:07 PST 2002
>Last-Modified:  Thu Mar 28 03:08:07 PST 2002
>Originator:     Edwin Groothuis
>Release:        FreeBSD 4.5-RELEASE i386
>Organization:
-
>Environment:
System: FreeBSD k7.mavetju.org 4.5-RELEASE FreeBSD 4.5-RELEASE #1: Thu Feb 28 14:56:20 EST 2002 edwin@k7.mavetju.org:/usr/src/sys/compile/k7 i386

>Description:

More and more questions in the freebsd-questions mailinglist are
about people having problems to mount a self-created cd-rom. This
is because they don't know about the fact that burncd(8) is used
to burn cd images and not plain files.

>How-To-Repeat:

>Fix:

This patch of the man-page of burncd(8) add these lines:

NOTES
     If you are creating a CD which has to be mountable, please note that you
     first have to make a CD image with mkisofs(8).  Mkisofs(8) is available
     from the FreeBSD ports-collection.  Please see the section in the man-
     page of mkisofs(8) on how to create these.


--- burncd.8.old        Mon Mar  4 13:23:09 2002
+++ burncd.8    Mon Mar  4 13:36:15 2002
@@ -145,6 +145,12 @@
 .Bd -literal
 # gunzip -c file.iso.gz | burncd -f /dev/acd0c data - fixate
 .Ed
+.Sh NOTES
+If you are creating a CD which has to be mountable, please note that you
+first have to make a CD image with mkisofs(8).  Mkisofs(8) is available
+from the FreeBSD ports-collection.  Please see the 
+.B EXAMPLES
+section in the man-page of mkisofs(8) on how to create these.
 .Sh BUGS
 Probably, please report when found.
 .Sh HISTORY

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Thu Mar 28 03:05:07 PST 2002 
State-Changed-Why:  
I've added some text to the examples section of the man page to 
mention mkisofs.  I will MFC the addition in about 3 days. 

I didn't use your patch because we'd like to avoid the word "you" in 
man pages if possible.  Also, you should start sentences on a new line 
in FreeBSD, always use lower case for command names, and use the .Xr 
macro to cross reference another man page. 

Thanks for the submission.   

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