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

[RFR] templates://gnumeric/{gnumeric.templates}



Please find, for review, the debconf templates and packages descriptions for the gnumeric source package.

This review will last from Monday, October 15, 2007 to Thursday, October 25, 2007.

Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.

Your review should be sent as an answer to this mail.

When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.

When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.

Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.

Rationale:
--- ../gnumeric.old/debian/gnumeric.templates	2007-10-06 19:14:46.006208834 +0200
+++ debian/gnumeric.templates	2007-10-11 07:50:49.437156748 +0200
@@ -1,10 +1,10 @@
 Template: gnumeric/existing-process
 Type: boolean
 Default: false
-_Description: Are you sure you want to upgrade gnumeric right now?
- It appears there is an instance of gnumeric running currently. If you
- upgrade gnumeric now, that instance may not be able to save its data
+_Description: Really upgrade gnumeric?

More direct

+ Gnumeric appears to be running currently. If you
+ upgrade it now, that instance may not be able to save its data
  anymore.

More direct. We are *sure* that gnumeric is running, let's assume this..:-)

  .
- You are strongly recommended to close the running instances of gnumeric
- prior to upgrading this package.
+ You should  close the running instances of gnumeric
+ before upgrading this package.

Avoid passive voice.

--- ../gnumeric.old/debian/control	2007-10-06 19:14:46.006208834 +0200
+++ debian/control	2007-10-11 07:55:59.921050804 +0200
@@ -26,32 +26,32 @@
 Replaces: zh-trans (<< 0.8-1), gnumeric1.0
 XS-Python-Version: current
 XB-Python-Version: ${python:Versions}
-Description: GNOME spreadsheet application
- Gnumeric is a powerful spreadsheet application that interoperates well
+Description: spreadsheet application for GNOME - main program

Use the common "generic description - specific description" system

Avoid putting GNOME first. After all, the main point is gnumeric being
a spreadsheet app.


+ Gnumeric is a spreadsheet application that interoperates well
  with other spreadsheets. It comes with plugins that enable it to deal with
  commonly used spreadsheet file formats.

"powerful" is judgement. Th
e policy recommends descriptions to be factual and avoid "advertising"
the software
  .
  The following formats can be imported and exported:
-  * Microsoft Excel (tm) 97/2000/XP (.xls)
-  * Microsoft Excel (tm) 95 (.xls)
-  * OASIS XML, OpenOffice.org XML, StarOffice (.sxc)
-  * Comma/Character Separated Values (.csv)
-  * Data Interchange Format (.dif)
-  * Applix version 4 (.as)
+  - Microsoft Excel (tm) 97/2000/XP (.xls);
+  - Microsoft Excel (tm) 95 (.xls);
+  - OASIS XML, OpenOffice.org XML, StarOffice (.sxc);
+  - Comma/Character Separated Values (.csv);
+  - Data Interchange Format (.dif);
+  - Applix version 4 (.as).

Our standard bulleting system.

  .
  Additionally, the following formats can be imported:
-  * GNU Oleo (.oleo)
-  * Linear and integer program expression format (.mps)
-  * Lotus 123 (.wks, .wk1)
-  * MultiPlan (.sylk)
-  * Plan Perfect (.pln)
-  * Quatro Pro (tm)
-  * SC/XSpread
-  * XBase (.dbf), 
+  - GNU Oleo (.oleo);
+  - Linear and integer program expression format (.mps);
+  - Lotus 123 (.wks, .wk1);
+  - MultiPlan (.sylk);
+  - Plan Perfect (.pln);
+  - Quatro Pro (tm);
+  - SC/XSpread;
+  - XBase (.dbf).

Ditto.

  .
  Gnumeric can export to LaTeX 2e (.tex), TROFF (.me) and HTML as well.
  .
- Gnumeric should be easy to use, in particular if you are familiar with
+ Gnumeric should be easy to use, in particular for users familiar with
  Excel.

Avoid "personnalization".

  .
  Gnumeric is a GNOME application. GNOME (GNU Network Object Model Environment) 
@@ -61,9 +61,13 @@
 Package: gnumeric-common
 Architecture: all
 Replaces: gnumeric (<= 1.2.6-1)
-Description: common files for Gnumeric, the GNOME spreadsheet application
+Description: spreadsheet application for GNOME - common files
+ Gnumeric is a spreadsheet application that interoperates well
+ with other spreadsheets. It comes with plugins that enable it to deal with
+ commonly used spreadsheet file formats.
+ .

Same than above

  This package contains architecture-independent data files needed by the
- "gnumeric" package.
+ gnumeric package.

No need to quote the package name
 
 Package: gnumeric-doc
 Architecture: all
@@ -72,8 +76,13 @@
 Suggests: gnumeric (>= ${Upstream-Version}), docbook-xsl
 Conflicts: gnumeric1.0-doc
 Replaces: gnumeric (<< 1.1.17-2), gnumeric1.0-doc, docbook-xsl
-Description: documentation for Gnumeric, the GNOME spreadsheet application
- The `Gnumeric's User Manual' in Gnome Help (DocBook XML) format.
+Description: spreadsheet application for GNOME - documentation
+ Gnumeric is a spreadsheet application that interoperates well
+ with other spreadsheets. It comes with plugins that enable it to deal with
+ commonly used spreadsheet file formats.

Same than above. Add an explanation about Gnumeric here also.

+ .
+ This package provides the `Gnumeric's User Manual' in Gnome Help
+ (DocBook XML) format.

And separate the specific part alone.
 
 Package: gnumeric-plugins-extra
 Architecture: any
@@ -82,14 +91,18 @@
 Replaces: gnumeric1.0-gda, gnumeric1.0-python, gnumeric-python, gnumeric-gda, gnumeric (<= 1.3.92-1)
 XS-Python-Version: current
 XB-Python-Version: ${python:Versions}
-Description: additional plugins for the GNOME spreadsheet
- Gnumeric ships with a number of plugins; this package contains those
- plugins that require additional packages above what the 'gnumeric' package
- needs.
- .
- This includes
-  * The Perl plugin
-  * The Python plugin
-  * The Python plugin loader
-  * Additional Python functions
-  * The Gnome glossary
+Description: spreadsheet application for GNOME - additional plugins
+ Gnumeric is a spreadsheet application that interoperates well
+ with other spreadsheets. It comes with plugins that enable it to deal with
+ commonly used spreadsheet file formats.
+ .

Same than above


+ Some plugins shipped with gnumeric require additional packages to those
+ required by the main gnumeric program. These plugins are therefore
+ packaged separately.

Another way to explain why the plugins have to be provided spearately.

+ .
+ This includes:
+  - Perl plugin;
+  - Python plugin;
+  - Python plugin loader;
+  - additional Python functions;
+  - Gnome glossary.

And bulleting stuff.

-- 


Template: gnumeric/existing-process
Type: boolean
Default: false
_Description: Really upgrade gnumeric?
 Gnumeric appears to be running currently. If you
 upgrade it now, that instance may not be able to save its data
 anymore.
 .
 You should close the running instances of gnumeric
 before upgrading this package.
--- gnumeric.old/debian/gnumeric.templates	2007-10-06 19:14:46.006208834 +0200
+++ gnumeric/debian/gnumeric.templates	2007-10-15 07:11:56.130524614 +0200
@@ -1,10 +1,10 @@
 Template: gnumeric/existing-process
 Type: boolean
 Default: false
-_Description: Are you sure you want to upgrade gnumeric right now?
- It appears there is an instance of gnumeric running currently. If you
- upgrade gnumeric now, that instance may not be able to save its data
+_Description: Really upgrade gnumeric?
+ Gnumeric appears to be running currently. If you
+ upgrade it now, that instance may not be able to save its data
  anymore.
  .
- You are strongly recommended to close the running instances of gnumeric
- prior to upgrading this package.
+ You should close the running instances of gnumeric
+ before upgrading this package.
--- gnumeric.old/debian/control	2007-10-06 19:14:46.006208834 +0200
+++ gnumeric/debian/control	2007-10-11 07:55:59.921050804 +0200
@@ -26,32 +26,32 @@
 Replaces: zh-trans (<< 0.8-1), gnumeric1.0
 XS-Python-Version: current
 XB-Python-Version: ${python:Versions}
-Description: GNOME spreadsheet application
- Gnumeric is a powerful spreadsheet application that interoperates well
+Description: spreadsheet application for GNOME - main program
+ Gnumeric is a spreadsheet application that interoperates well
  with other spreadsheets. It comes with plugins that enable it to deal with
  commonly used spreadsheet file formats.
  .
  The following formats can be imported and exported:
-  * Microsoft Excel (tm) 97/2000/XP (.xls)
-  * Microsoft Excel (tm) 95 (.xls)
-  * OASIS XML, OpenOffice.org XML, StarOffice (.sxc)
-  * Comma/Character Separated Values (.csv)
-  * Data Interchange Format (.dif)
-  * Applix version 4 (.as)
+  - Microsoft Excel (tm) 97/2000/XP (.xls);
+  - Microsoft Excel (tm) 95 (.xls);
+  - OASIS XML, OpenOffice.org XML, StarOffice (.sxc);
+  - Comma/Character Separated Values (.csv);
+  - Data Interchange Format (.dif);
+  - Applix version 4 (.as).
  .
  Additionally, the following formats can be imported:
-  * GNU Oleo (.oleo)
-  * Linear and integer program expression format (.mps)
-  * Lotus 123 (.wks, .wk1)
-  * MultiPlan (.sylk)
-  * Plan Perfect (.pln)
-  * Quatro Pro (tm)
-  * SC/XSpread
-  * XBase (.dbf), 
+  - GNU Oleo (.oleo);
+  - Linear and integer program expression format (.mps);
+  - Lotus 123 (.wks, .wk1);
+  - MultiPlan (.sylk);
+  - Plan Perfect (.pln);
+  - Quatro Pro (tm);
+  - SC/XSpread;
+  - XBase (.dbf).
  .
  Gnumeric can export to LaTeX 2e (.tex), TROFF (.me) and HTML as well.
  .
- Gnumeric should be easy to use, in particular if you are familiar with
+ Gnumeric should be easy to use, in particular for users familiar with
  Excel.
  .
  Gnumeric is a GNOME application. GNOME (GNU Network Object Model Environment) 
@@ -61,9 +61,13 @@
 Package: gnumeric-common
 Architecture: all
 Replaces: gnumeric (<= 1.2.6-1)
-Description: common files for Gnumeric, the GNOME spreadsheet application
+Description: spreadsheet application for GNOME - common files
+ Gnumeric is a spreadsheet application that interoperates well
+ with other spreadsheets. It comes with plugins that enable it to deal with
+ commonly used spreadsheet file formats.
+ .
  This package contains architecture-independent data files needed by the
- "gnumeric" package.
+ gnumeric package.
 
 Package: gnumeric-doc
 Architecture: all
@@ -72,8 +76,13 @@
 Suggests: gnumeric (>= ${Upstream-Version}), docbook-xsl
 Conflicts: gnumeric1.0-doc
 Replaces: gnumeric (<< 1.1.17-2), gnumeric1.0-doc, docbook-xsl
-Description: documentation for Gnumeric, the GNOME spreadsheet application
- The `Gnumeric's User Manual' in Gnome Help (DocBook XML) format.
+Description: spreadsheet application for GNOME - documentation
+ Gnumeric is a spreadsheet application that interoperates well
+ with other spreadsheets. It comes with plugins that enable it to deal with
+ commonly used spreadsheet file formats.
+ .
+ This package provides the `Gnumeric's User Manual' in Gnome Help
+ (DocBook XML) format.
 
 Package: gnumeric-plugins-extra
 Architecture: any
@@ -82,14 +91,18 @@
 Replaces: gnumeric1.0-gda, gnumeric1.0-python, gnumeric-python, gnumeric-gda, gnumeric (<= 1.3.92-1)
 XS-Python-Version: current
 XB-Python-Version: ${python:Versions}
-Description: additional plugins for the GNOME spreadsheet
- Gnumeric ships with a number of plugins; this package contains those
- plugins that require additional packages above what the 'gnumeric' package
- needs.
- .
- This includes
-  * The Perl plugin
-  * The Python plugin
-  * The Python plugin loader
-  * Additional Python functions
-  * The Gnome glossary
+Description: spreadsheet application for GNOME - additional plugins
+ Gnumeric is a spreadsheet application that interoperates well
+ with other spreadsheets. It comes with plugins that enable it to deal with
+ commonly used spreadsheet file formats.
+ .
+ Some plugins shipped with gnumeric require additional packages to those
+ required by the main gnumeric program. These plugins are therefore
+ packaged separately.
+ .
+ This includes:
+  - Perl plugin;
+  - Python plugin;
+  - Python plugin loader;
+  - additional Python functions;
+  - Gnome glossary.
Source: gnumeric
Section: math
Priority: optional
Maintainer: J.H.M. Dassen (Ray) <jdassen@debian.org>
Build-Depends: debhelper (>= 5.0.37.2), python-central (>= 0.5), dh-buildinfo,
 po-debconf, gettext, bison, flex, scrollkeeper, libxml-parser-perl,
 zlib1g-dev, libglib2.0-dev (>= 2.6.0), libgsf-1-dev (>= 1.14.0-1),
 libgoffice-1-dev (>= 0.2.1), libxml2-dev (>= 2.6.10-2),
 libpango1.0-dev (>= 1.8.1),
 libgtk2.0-dev (>= 2.6.0), libglade2-dev (>= 1:2.4.0-1),
 libgnomeprint2.2-dev (>= 2.8.2), libgnomeprintui2.2-dev (>= 2.8.2),
 libart-2.0-dev (>= 2.3.16-5),
 libgconf2-dev (>= 2.6.2-1), libbonobo2-dev (>= 2.6.2-4),
 libbonoboui2-dev (>= 2.6.1-1),
 libgnome2-dev (>= 2.4.0-2), libgnomeui-dev (>= 2.4.0-2),
 libgsf-gnome-1-dev (>= 1.13.2),
 pxlib-dev (>= 0.5.1-2+b1), libperl-dev,
 python-dev, python-gtk2-dev
Standards-Version: 3.7.2

Package: gnumeric
Architecture: any
Depends: ${shlibs:Depends}, gsfonts, gnumeric-common (= ${source:Version}), ${misc:Depends}
Suggests: gnumeric-doc (>= ${Upstream-Version}), gnumeric-plugins-extra
Conflicts: gnumeric1.0, gnumeric1.0-doc, gnumeric-doc (<< ${Upstream-Version})
Replaces: zh-trans (<< 0.8-1), gnumeric1.0
XS-Python-Version: current
XB-Python-Version: ${python:Versions}
Description: spreadsheet application for GNOME - main program
 Gnumeric is a spreadsheet application that interoperates well
 with other spreadsheets. It comes with plugins that enable it to deal with
 commonly used spreadsheet file formats.
 .
 The following formats can be imported and exported:
  - Microsoft Excel (tm) 97/2000/XP (.xls);
  - Microsoft Excel (tm) 95 (.xls);
  - OASIS XML, OpenOffice.org XML, StarOffice (.sxc);
  - Comma/Character Separated Values (.csv);
  - Data Interchange Format (.dif);
  - Applix version 4 (.as).
 .
 Additionally, the following formats can be imported:
  - GNU Oleo (.oleo);
  - Linear and integer program expression format (.mps);
  - Lotus 123 (.wks, .wk1);
  - MultiPlan (.sylk);
  - Plan Perfect (.pln);
  - Quatro Pro (tm);
  - SC/XSpread;
  - XBase (.dbf).
 .
 Gnumeric can export to LaTeX 2e (.tex), TROFF (.me) and HTML as well.
 .
 Gnumeric should be easy to use, in particular for users familiar with
 Excel.
 .
 Gnumeric is a GNOME application. GNOME (GNU Network Object Model Environment) 
 is a user-friendly set of applications and desktop tools to be used in 
 conjunction with a window manager for the X Window System.

Package: gnumeric-common
Architecture: all
Replaces: gnumeric (<= 1.2.6-1)
Description: spreadsheet application for GNOME - common files
 Gnumeric is a spreadsheet application that interoperates well
 with other spreadsheets. It comes with plugins that enable it to deal with
 commonly used spreadsheet file formats.
 .
 This package contains architecture-independent data files needed by the
 gnumeric package.

Package: gnumeric-doc
Architecture: all
Section: doc
Recommends: yelp (>= 2.6.0), gnome-desktop-data
Suggests: gnumeric (>= ${Upstream-Version}), docbook-xsl
Conflicts: gnumeric1.0-doc
Replaces: gnumeric (<< 1.1.17-2), gnumeric1.0-doc, docbook-xsl
Description: spreadsheet application for GNOME - documentation
 Gnumeric is a spreadsheet application that interoperates well
 with other spreadsheets. It comes with plugins that enable it to deal with
 commonly used spreadsheet file formats.
 .
 This package provides the `Gnumeric's User Manual' in Gnome Help
 (DocBook XML) format.

Package: gnumeric-plugins-extra
Architecture: any
Depends: gnumeric (= ${binary:Version}), python-gtk2, ${python:Depends}, ${shlibs:Depends}
Conflicts: gnumeric1.0-python, gnumeric1.0-gda, gnumeric-python, gnumeric-gda
Replaces: gnumeric1.0-gda, gnumeric1.0-python, gnumeric-python, gnumeric-gda, gnumeric (<= 1.3.92-1)
XS-Python-Version: current
XB-Python-Version: ${python:Versions}
Description: spreadsheet application for GNOME - additional plugins
 Gnumeric is a spreadsheet application that interoperates well
 with other spreadsheets. It comes with plugins that enable it to deal with
 commonly used spreadsheet file formats.
 .
 Some plugins shipped with gnumeric require additional packages to those
 required by the main gnumeric program. These plugins are therefore
 packaged separately.
 .
 This includes:
  - Perl plugin;
  - Python plugin;
  - Python plugin loader;
  - additional Python functions;
  - Gnome glossary.

Attachment: signature.asc
Description: Digital signature


Reply to: