[Pkg-libburnia-commits] r187 - trunk/libisoburn/debian

Thu May 19 09:52:35 UTC 2011

Author: danchev
Date: 2011-05-19 09:52:33 +0000 (Thu, 19 May 2011)
New Revision: 187

Modified:
   trunk/libisoburn/debian/README.Debian
   trunk/libisoburn/debian/changelog
   trunk/libisoburn/debian/control
Log:
improved package descriptions and README.Debian as sent by Mats

Modified: trunk/libisoburn/debian/README.Debian
===================================================================

--- trunk/libisoburn/debian/README.Debian	2011-05-19 07:22:50 UTC (rev 186)
+++ trunk/libisoburn/debian/README.Debian	2011-05-19 09:52:33 UTC (rev 187)
@@ -1,28 +1,30 @@
 Startup files for xorriso
 -------------------------
-Please find a sample startup file in examples directory.
-No startup files are installed by the xorriso package at
-their usual locations (see Startup Files in xorriso(1))
-as they are not required for xorriso normal operations.
+A sample startup file is now placed in the examples directory.
+Startup files are installed by the package 'xorriso' in their
+expected locations (see Startup Files in xorriso(1)), as they
+are not required for xorriso's normal operation.
 
 
 Abort check media file (as suggested by Thomas Schmitt)
 -------------------------------------------------------
-A run of xorriso -check_media can show very slow progress if
-the media causes many read errors. 
+Execution of 'xorriso -check_media' can exhibit very slow progress,
+if the medium causes many read errors. 
 
-To stop that gracefully, an abort check media file could be
-created (by default /var/opt/xorriso/do_abort_check_media),
-see touch(1), to end such a check run prematurely. 
+To prevent such a condition gracefully, an 'abort check media file'
+can be created (named '/var/opt/xorriso/do_abort_check_media' by
+default), see touch(1). This would interrupt a stalling check
+early on. 
 
-Abort happens if the mtime of abort media file is younger than
-the start time of the xorriso -check_media run.
+The abort takes place if the modification time of the 'abort media file'
+is more recent than the starting time of the 'xorriso -check_media'
+action.
 
-This is preferable over hitting Ctrl+C, especially if the 
--check_media run copies data blocks from media to hard disk.
+This is preferred over hitting Ctrl+C, especially if the check_media
+action copies data blocks from an optical medium to a hard disk.
 
-The file location of the abort media file could be tweaked by 
--check_media abort_file=path option, thus default abort check 
-media file is not installed by the xorriso package.
+The file location of the 'abort media file' can be tweaked using
+a "-check_media abort_file=path" option, if the default 'abort check 
+media file' was not installed by the package 'xorriso'.
 
  -- George Danchev <danchev at spnet.net>, Tue,  5 Apr 2011 10:14:15 +0300

Modified: trunk/libisoburn/debian/changelog
===================================================================
--- trunk/libisoburn/debian/changelog	2011-05-19 07:22:50 UTC (rev 186)
+++ trunk/libisoburn/debian/changelog	2011-05-19 09:52:33 UTC (rev 187)
@@ -3,6 +3,7 @@
   * [GD] Change build/libisoburn-doc:: to common-build-indep::
          so that documentation production is only invoked by
          arch independent parts.
+  * [MA] Improve package descriptions and README.Debian.
 
  -- George Danchev <danchev at spnet.net>  Thu, 19 May 2011 09:57:03 +0300
 

Modified: trunk/libisoburn/debian/control
===================================================================
--- trunk/libisoburn/debian/control	2011-05-19 07:22:50 UTC (rev 186)
+++ trunk/libisoburn/debian/control	2011-05-19 09:52:33 UTC (rev 187)
@@ -15,11 +15,11 @@
 Architecture: any
 Section: libs
 Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: library to enable creation and expansion of ISO-9660 filesystems
- libisoburn is a frontend for libraries libburn and libisofs which enables
- creation and expansion of ISO-9660 filesystems on all CD/DVD media supported
- by libburn. This includes media like DVD+RW, which do not support
- multi-session management on media level and even plain disk files or block
+Description: library to handle creation and inspection of ISO 9660 file systems
+ libisoburn is a frontend for the libraries libburn and libisofs. It handles
+ creation and inspection of ISO 9660 file systems on all CD/DVD media supported
+ by libburn. These include media like DVD+RW, which does not support multi-
+ session management at media level, as well as plain disk files and block
  devices.
  
 Package: libisoburn-dbg
@@ -28,18 +28,18 @@
 Priority: extra
 Depends: ${shlibs:Depends}, ${misc:Depends}, libisoburn1 (= ${binary:Version}), libisofs-dbg, libburn-dbg
 Description: debugging symbols for libisoburn and xorriso
- libisoburn is a frontend for libraries libburn and libisofs which enables
- creation and expansion of ISO-9660 filesystems on all CD/DVD media supported
+ libisoburn is a frontend for the libraries libburn and libisofs. It handles
+ creation and inspection of ISO 9660 file systems on all CD/DVD media supported
  by libburn.
  .
- This package contains debugging files used to investigate problems with
- binaries included in the libisoburn and xorriso packages.
+ This package contains debugging files useful for investigating any problems
+ with the binaries found in the packages 'libisoburn' and 'xorriso'.
     
 Package: libisoburn-doc
 Architecture: all
 Section: doc
 Depends: ${misc:Depends}
-Description: Development package for libisofs
+Description: development package for libisofs
  This package contains the documentation for libisoburn.
 
 Package: libisoburn-dev
@@ -48,7 +48,7 @@
 Depends: ${shlibs:Depends}, ${misc:Depends}, libisoburn1 (= ${binary:Version}), libisofs-dev, libburn-dev
 Suggests: libisoburn-doc (= ${source:Version})
 Description: development package for libisoburn
- This package contains the headers, pkgconfig data and static library for
+ This package contains the headers, pkgconfig data, and static library for
  libisoburn.
 
 Package: xorriso
@@ -56,14 +56,16 @@
 Section: otherosfs
 Depends: ${shlibs:Depends}, ${misc:Depends}, libisoburn1 (= ${binary:Version}), libburn4 (>= 0.7.2), libisofs6 (>= 0.6.24)
 Suggests: jigit (>= 1.17-2), cdck
-Description: command line ISO9660+RR manipulation tool
+Description: command line ISO 9660 and Rock Ridge manipulation tool
  xorriso is a command line and dialog application, which creates, loads,
- manipulates and writes ISO 9660 filesystem images with Rock Ridge extensions.
+ manipulates, and writes ISO 9660 file system images with Rock Ridge
+ extensions.
  .
- It maps file objects from POSIX compliant filesystems into Rock Ridge enhanced
- ISO 9660 filesystems and allows session-wise manipulation  of such
- filesystems. It can load the management information of existing ISO images
- and it writes the session results to optical media or to filesystem objects.
+ It maps file objects from POSIX compliant file systems into Rock Ridge
+ enhanced ISO 9660 file systems and it allows session-wise manipulation
+ of such file systems. It can load the management information of existing
+ ISO images and it writes the resulting session to optical medium, or as
+ file system objects.
  .
  Supported media types: 
   - CD-R, CD-RW
@@ -71,12 +73,12 @@
   - BD-R, BD-RE
  .
  Some interesting features:
-  - Emulation of programs mkisofs and cdrecord.
-  - Features for data backup and restore - compression, ACLs, and filters.
+  - Emulation of the programs mkisofs and cdrecord.
+  - Abilities for data backup and restore - compression, ACLs, and filters.
   - Isohybrid MBR with partition offset - allows to boot ISOLINUX from
-    USB sticks or other devices that appear to PC-BIOS as hard disk.
-    The images bear a quite conventional partition table on USB stick.
-    The first partition marks the size of the ISO image, but starts at a
-    non-zero address. It is nevertheless mountable.
-  - Jigdo Template Export - jigdo representation of the emerging ISO9660 
+    USB sticks, or from other devices that appear to PC-BIOS as hard disks.
+    The images carry a quite conventional partition table for a USB stick.
+    The first partition reports the size of the ISO image, but starts at a
+    non-zero address. It is nevertheless still mountable.
+  - Jigdo Template Export - jigdo representation of the resulting ISO 9660 
     image, on the fly.


