[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: [RFR] templates://libpaper/{libpaper1.templates}



Christian Perrier wrote:
> Your review should be sent as an answer to this mail.

My main concern with libpaper is that it poses as an interim
release of a young, fast-moving project with extra functionality
coming Real Soon Now.  But that package description is unchanged
since 1996 (there's a copy on my Debian 1.2/Rex CD).  I think it's
about time it admitted that it's just for handling paper sizes.

> +Description: library for handling paper characteristics
> + This package contains a simple library for use by programs needing to
> + handle paper-printed output. 
> + .
> + It allows programs to automatically recognize many different paper
> + types along with their properties (currently their size).
> 
> Split in two paragraphs for readability.
> 
> Better wording, at least IMHO.

Definitely.
 
> Programs do not handle "paper", they handle "paper output".

It could just be "printed output", really.

>  Package: libpaper-utils
...
>  Description: Library for handling paper characteristics (utilities)
                l
> + It allows programs to automatically recognize many different paper
> + types along with their properties (currently their size).
> + .
> + It also includes a program for accessing paper type information
> + from shell scripts.

These paragraphs refer to different "it"s.


I think we should simplify it down to roughly

    The libpaper paper-handling library automates recognition of many
    different paper types and sizes for programs that need to deal with
    printed output.

then add paragraphs for -utils:

    This package contains utilities for setting the system's default paper
    type and for accessing paper type information from shell scripts. 

and -dev:

    This package contains the development files.
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
--- ../libpaper.old/debian/libpaper1.templates	2006-06-11 16:52:05.000000000 +0100
+++ debian/libpaper1.templates	2007-06-28 15:05:14.000000000 +0100
@@ -1,7 +1,7 @@
 Template: libpaper/defaultpaper
 Type: select
 __Choices: letter, a4, note, legal, executive, halfletter, halfexecutive, 11x17, statement, folio, quarto, 10x14, ledger, tabloid, a0, a1, a2, a3, a5, a6, a7, a8, a9, a10, b0, b1, b2, b3, b4, b5, c5, DL, Comm10, Monarch, archE, archD, archC, archB, archA, flsa, flse, csheet, dsheet, esheet
-_Description: Which paper size should be the system default?
- Please select which paper size to use as the default on your system.
- Various programs on your system will use this configuration option to
- determine how to print output.  The default is typically correct.
+_Description: System's default paper size:
+ Please select the default paper size for the system.
+ Various programs on the system will use this configuration option to
+ determine how to print output.
--- ../libpaper.old/debian/control	2006-06-11 16:52:05.000000000 +0100
+++ debian/control	2007-06-28 21:22:39.000000000 +0100
@@ -11,22 +11,23 @@
 Replaces: libpaperg (<< 1.1.9)
 Provides: libpaperg
 Recommends: libpaper-utils
-Description: Library for handling paper characteristics
- This package contains a simple library for use by programs needing
- to handle papers. It lets program automatically recognize a lot of
- different papers with their properties (actually their size).
+Description: library for handling paper sizes
+ The libpaper paper-handling library automates recognition of many
+ different paper types and sizes for programs that need to deal with
+ printed output.
 
 Package: libpaper-utils
 Section: utils
 Architecture: any
 Depends: ${shlibs:Depends}
 Replaces: libpaperg (<< 1.1.9), libpaper1 (<< 1.1.10)
-Description: Library for handling paper characteristics (utilities)
- This package contains the configuration utility for managing a simple
- library for use by programs needing to handle papers. It lets program
- automatically recognize a lot of different papers with their
- properties (actually their size).  It also includes a program for
- accessing paper information from shell scripts.
+Description: library for handling paper sizes (utilities)
+ The libpaper paper-handling library automates recognition of many
+ different paper types and sizes for programs that need to deal with
+ printed output.
+ .
+ This package contains utilities for setting the system's default paper
+ type and for accessing paper type information from shell scripts.
 
 Package: libpaper-dev
 Section: libdevel
@@ -34,8 +35,9 @@
 Depends: libpaper1 (= ${Source-Version})
 Replaces: libpaperg-dev (<< 1.1.9)
 Provides: libpaperg-dev
-Description: Library for handling paper characteristics (development files)
- This package contains the development files for a simple library for use
- by programs needing to handle papers. It lets program automatically
- recognize a lot of different papers with their properties (actually their
- size).
+Description: library for handling paper sizes (development files)
+ The libpaper paper-handling library can be used by programs needing to
+ handle printed output. It automates recognition of many different paper
+ types and sizes.         
+ .
+ This package contains the development files.
Template: libpaper/defaultpaper
Type: select
__Choices: letter, a4, note, legal, executive, halfletter, halfexecutive, 11x17, statement, folio, quarto, 10x14, ledger, tabloid, a0, a1, a2, a3, a5, a6, a7, a8, a9, a10, b0, b1, b2, b3, b4, b5, c5, DL, Comm10, Monarch, archE, archD, archC, archB, archA, flsa, flse, csheet, dsheet, esheet
_Description: System's default paper size:
 Please select the default paper size for the system.
 Various programs on the system will use this configuration option to
 determine how to print output.
Source: libpaper
Section: libs
Priority: optional
Maintainer: Giuseppe Sacco <eppesuig@debian.org>
Standards-Version: 3.6.2
Build-Depends: autotools-dev, debhelper (>> 4.1.16), po-debconf, autoconf

Package: libpaper1
Architecture: any
Depends: ${shlibs:Depends}, debconf (>= 1.3.22) | debconf-2.0, ucf (>= 0.28)
Replaces: libpaperg (<< 1.1.9)
Provides: libpaperg
Recommends: libpaper-utils
Description: library for handling paper sizes
 The libpaper paper-handling library automates recognition of many
 different paper types and sizes for programs that need to deal with
 printed output.

Package: libpaper-utils
Section: utils
Architecture: any
Depends: ${shlibs:Depends}
Replaces: libpaperg (<< 1.1.9), libpaper1 (<< 1.1.10)
Description: library for handling paper sizes (utilities)
 The libpaper paper-handling library automates recognition of many
 different paper types and sizes for programs that need to deal with
 printed output.
 .
 This package contains utilities for setting the system's default paper
 type and for accessing paper type information from shell scripts.

Package: libpaper-dev
Section: libdevel
Architecture: any
Depends: libpaper1 (= ${Source-Version})
Replaces: libpaperg-dev (<< 1.1.9)
Provides: libpaperg-dev
Description: library for handling paper sizes (development files)
 The libpaper paper-handling library can be used by programs needing to
 handle printed output. It automates recognition of many different paper
 types and sizes.         
 .
 This package contains the development files.

Reply to: