From owner-freebsd-questions@FreeBSD.ORG Tue Aug 2 17:06:34 2005 Return-Path: X-Original-To: freebsd-questions@freebsd.org Delivered-To: freebsd-questions@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B1B7616A41F; Tue, 2 Aug 2005 17:06:34 +0000 (GMT) (envelope-from marc@blackend.org) Received: from abigail.blackend.org (blackend.org [212.11.35.229]) by mx1.FreeBSD.org (Postfix) with ESMTP id 1205843D46; Tue, 2 Aug 2005 17:06:33 +0000 (GMT) (envelope-from marc@blackend.org) Received: from gothic.blackend.org (gothic.blackend.org [192.168.1.203]) by abigail.blackend.org (8.13.3/8.13.3) with ESMTP id j72H6Ve4081103; Tue, 2 Aug 2005 19:06:32 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: from gothic.blackend.org (localhost.blackend.org [127.0.0.1]) by gothic.blackend.org (8.13.3/8.13.3) with ESMTP id j72H6V0x001736; Tue, 2 Aug 2005 19:06:31 +0200 (CEST) (envelope-from marc@gothic.blackend.org) Received: (from marc@localhost) by gothic.blackend.org (8.13.3/8.13.3/Submit) id j72H6Vn8001735; Tue, 2 Aug 2005 19:06:31 +0200 (CEST) (envelope-from marc) Date: Tue, 2 Aug 2005 19:06:31 +0200 From: Marc Fonvieille To: Chuck Swiger Message-ID: <20050802170631.GG595@gothic.blackend.org> References: <20050801203145.GA830@twelvegates.homeip.net> <20050802002003.GX75379@wantadilla.lemis.com> <20050802050818.GA69657@localhost.local> <42EF03C2.6060209@mac.com> <20050802054603.GA69870@localhost.local> <42EF8819.5000306@mac.com> <20050802154435.GF595@gothic.blackend.org> <42EF9FD5.7060204@mac.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <42EF9FD5.7060204@mac.com> X-Useless-Header: blackend.org X-Operating-System: FreeBSD 5.4-STABLE User-Agent: Mutt/1.5.9i Cc: Marc Fonvieille , freebsd-questions@freebsd.org Subject: Re: growisofs: no mkisofs options are permitted with =, aborting X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Aug 2005 17:06:34 -0000 On Tue, Aug 02, 2005 at 12:31:17PM -0400, Chuck Swiger wrote: > > The Handbook has good documentation on using dvd+rw-tools as well as other > software, and I would second the recomendation that people take a look at > it if they want to burn CD's or DVD's. > > You are welcome to hold the opinion that the documentation is complete, but: > > 13-sec% cd /usr/ports/sysutils/dvd+rw-tools && make extract > /dev/null > 14-sec% grep luke work/dvd+rw-tools-5.21.4.10.8/growisofs.c > * - undocumented -use-the-force-luke flag to overwrite the media > * - extended syntax for -use-the-force-luke option, it's now possible > * to engage DVD-R[W] dummy mode by -use-the-force-luke=[tty,]dummy > * - complement -use-the-force-luke=dao[:size] to arrange for piping > * - implement -use-the-force-luke=seek:N -Z /dev/dvd=image to arrange > * -use-the-force-luke=seek:N it's easier to maintain "tar-formatted" > * - -use-the-force-luke=tracksize:size option by suggestion from K3b; > * - -use-the-force-luke=wrvfy for WRITE AND VERIFY(10); > * - -use-the-force-luke=4gms to allow ISO9660 directory structures > * - more sane sanity check for -use-the-force-luke=tracksize:N; > * - -use-the-force-luke=break:size to set Layer Break position for > * - -use-the-force-luke=noload to leave tray ejected at the end; > else if (!strncmp(opt,"-use-the-force-luke",19)) > > ...or consult the manpage, again: > > "There're several undocumented options commonly denoted > with > -use-the-force-luke prefix. Some of them serve debugging purposes. > Some > require certain knowledge about recording process or even OS > kernel > internals and as being such can induce confusing behaviour. Some are > to > be used in very specific situations better recognized by front-ends > or > automated scripts. Rationale behind leaving these options > undocumented > is that those few users who would actually need to use them > directly > can as well consult the source code or obtain specific > instructions > elsewhere." > I don't see the problem, the text above clearly explain the reason. And according to questions on freebsd-questions@,, the main problem is the fact no one read the "existing" documentation; For example, a recent thread about DVD burning speed/DMA issue... with the solution documented in many places... However I can understand your point of view regarding the fact the manual page do not even mention briefly the "invisible" options. A volunteer should write a patch against the manual page and send it to Andy. Marc