sysutils/cd9660_unicode

[Giorgos Keramidas]

On 2006-08-21 19:05, Marc Fonvieille <blackend at freebsd.org> wrote:
> On Mon, Aug 21, 2006 at 06:10:38PM +0300, Andrei Kolu wrote:
> > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/creating-cds.html
> >
> > "Disks with certain ISO 9660 extensions might behave oddly, however.
> > For example, Joliet disks store all filenames in two-byte Unicode
> > characters. The FreeBSD kernel does not speak Unicode (yet!), so
> > non-English characters show up as question marks. (The FreeBSD
> > CD9660 driver includes hooks to load an appropriate Unicode
> > conversion table on the fly. Modules for some of the common
> > encodings are available via the sysutils/cd9660_unicode port.)"
> >
> > # cd /usr/ports/sysutils/cd9660_unicode
> > # make install
> > ===>  cd9660_unicode-1.0 is obsolete. See mount_cd9660(8).
> > *** Error code 1
>
> What about the following diff mentioning the -C option for particular
> cases:
>
> %%%
> Index: disks/chapter.sgml
> ===================================================================
> RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v
> retrieving revision 1.264
> diff -u -r1.264 chapter.sgml
> --- disks/chapter.sgml	21 Aug 2006 07:58:16 -0000	1.264
> +++ disks/chapter.sgml	21 Aug 2006 17:01:12 -0000
> @@ -1200,12 +1200,12 @@
>  	way.  Disks with certain ISO 9660 extensions might behave
>  	oddly, however.  For example, Joliet disks store all filenames
>  	in two-byte Unicode characters.  The FreeBSD kernel does not
> -	speak Unicode (yet!), so non-English characters show up as
> -	question marks.  (The FreeBSD
> -	CD9660 driver includes hooks to load an appropriate Unicode
> -	conversion table on the fly.  Modules for some of the common
> -	encodings are available via the
> -	<filename role="package">sysutils/cd9660_unicode</filename> port.)</para>
> +	speak Unicode, but the &os; CD9660 driver is able to convert
> +	Unicode characters on the fly.  If some non-English characters
> +	show up as question marks you will need to specify the local
> +	charset you use with the <option>-C</option> option.  For more
> +	information, consult the &man.mount.cd9660.8; manual
> +	page.</para>
>
>        <para>Occasionally, you might get <errorname>Device not
>  	configured</errorname> when trying to mount a CDROM.  This
> %%%

FWIW, this looks fine to me.  It's better, at least, than having
documentation that is out of date with the current state of things :)