Permalink
Browse files

Update README.md to reflect current status.

  • Loading branch information...
1 parent 15d83fc commit 07c43d7474a4aa2777ed493f815e9bce077f0979 @rocky committed Aug 8, 2011
Showing with 23 additions and 22 deletions.
  1. +23 −22 README.md
View
@@ -8,18 +8,18 @@ handling. Perl programs wishing to be oblivious of the OS- and
device-dependent properties of a CD-ROM can use this library.
The encapsulation is done in two parts. The lower-level Perl interface
-creates `perlcdio` and `perliso9660` libraries and these are generated by
-SWIG.
-
-There are also object-oriented modules that use perlcdio and
-perliso9660. Although perlcdio and perliso9660 are perfectly usable on
-there own, it is expected that the Device::Cdio... modules are what
-most people will use. As `perlcdio` and `perliso9660` more closely model
-the C interface, it is conceivable (if unlikely) that die-hard libcdio
-or libiso9660 C users who are very familiar with that interface may
-use that.
-
-It is probably possible to change the SWIG in such a way to combine
+creates _perlcdio_, _perliso9660_ and _perlmmc_ libraries; these
+are generated by SWIG.
+
+There are also object-oriented modules that use _perlcdio_ and
+_perliso9660_ (but not yet _perlmmc_). Although _perlcdio_ and
+`perliso9660 are perfectly usable on there own, it is expected that
+the _Device::Cdio..._ modules are what most people will use. As
+_perlcdio_ and _perliso9660_ more closely model the C interface, it is
+conceivable (if unlikely) that die-hard _libcdio_ or _libiso9660_ C
+users who are very familiar with that interface may use that.
+
+It may also be possible to change the SWIG in such a way to combine
the low-level and Object-Oriented pieces. However there are the
problems. First, I'm not that much of a SWIG expert. Second it looks
as though the resulting SWIG code would be more complex. Third the
@@ -28,28 +28,29 @@ maintain: first we get what's in C into Perl as a one-to-one
translation. Then we implement some nice Perl abstraction off of
that. The abstraction can be modified without having to redo the
underlying translation. (But the reverse is generally not true:
-usually changes to the C-to-Perl translation, perlcdio or perliso9660,
-do result in small, but obvious and straightforward changes to the
-abstraction layer cdio.)
+usually changes to the C-to-Perl translation, _perlcdio_ or
+_perliso9660_, do result in small, but obvious and straightforward
+changes to the abstraction layer cdio.)
GNU CD Input and Control Library is rather large, and yet may yet grow
-a bit. (UDF support may be on the horizon.) So what is here is
+a bit. (Any volunteers for adding UDF support?) So what is here is
incomplete; over time it may grow to completion, depending on various
factors: e.g. whether others will help out (hint).
Some of the incompleteness is due to my lack of understanding of how
to get SWIG to accomplish wrapping various return values. If you know
how to do better, please let me know. Likewise suggestions on how to
-improve classes or Python interaction are more than welcome.
+improve classes or Perl interaction are more than welcome.
-Sections of libcdio that have been left out wholesale are the (SCSI)
-MMC commands, the cdparanoia library, CD-Text handling. About 1/2 of
-the ISO-9660 library has been done. Of the audio controls, I put in
-those things that didn't require any thought.
+Sections of _libcdio_ that have been left out wholesale is the the
+cdparanoia library and almost all of the MMC library. About 1/2 of the
+ISO-9660 library has been done. Of the audio controls, I put in those
+things that didn't require any thought. But Jerry G. Geiger added
+more audio and CD-Text support
There is much to be done - you want to help out, please do so!
-Standalone documentation via perlpod. See also the
+Standalone documentation via _perlpod_. See also the
programs in the example directory.

0 comments on commit 07c43d7

Please sign in to comment.