Please find, for review, the debconf templates of lynx-cur.
This review will last from Thursday, July 23, 2009 to Sunday, August 02, 2009.
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:
--- ../lynx-cur.old/debian/templates 2009-07-18 21:09:45.000000000 +0300
+++ debian/templates 2009-07-23 14:51:31.000000000 +0300
@@ -1,16 +1,17 @@
Template: lynx-cur/defaulturl
Type: string
Default: http://www.debian.org/
-_Description: Lynx's homepage:
- Please enter the default URL to use if none is given when invoking lynx.
+_Description: Home page in Lynx:
+ Please enter a URL to be loaded if none is given when Lynx is invoked.
Make clear that question asks for user home page, not programs home page.
Capitalize program name here and elsewhere.
.
- You must enter either a full URL (including the "http://";, etc.) or an
- absolute pathname.
+ This must be a full URL (including the "http://";) or an absolute pathname
+ (beginning with "/").
Refer to the earlier chapter. I'm not sure if the parts in the parentheses
are necessary.
Template: lynx-cur/etc_lynx.cfg
Type: note
-_Description: Please check old /etc/lynx.cfg
- /etc/lynx.cfg is found but the configuration file of lynx-cur is
- /etc/lynx-cur/lynx.cfg so /etc/lynx.cfg would be of lynx or lynx-ssl.
+_Description: Please check the old configuration file /etc/lynx.cfg
+ File /etc/lynx.cfg belongs to the obsolete package lynx. The lynx-cur package
+ uses configuration file /etc/lynx-cur/lynx.cfg.
.
- Please check it and it will be better to PURGE lynx or lynx-ssl.
+ Please check the old file and move appropriate settings to the new.
+ It is recommended that you then purge the package lynx.
Improve language and remove references to lynx-ssl. They probably are not
needed as there has not been such package in Debian since 2002. Maybe
lynx-ssl could be removed also from the Conflicts line below.
--- ../lynx-cur.old/debian/control 2009-07-18 21:09:45.000000000 +0300
+++ debian/control 2009-07-23 14:50:50.000000000 +0300
@@ -13,27 +13,24 @@
Conflicts: lynx (<< 2.8.7dev9-1.1), lynx-ssl
Recommends: mime-support
Suggests: lynx-cur-wrapper
-Description: Text-mode WWW Browser with NLS support (development version)
- Lynx is a fully-featured World Wide Web (WWW) client for users running
- cursor-addressable, character-cell display devices.
- It is very fast and easy to use. It will display HTML documents
- containing links to files residing on the local system,
- as well as files residing on remote systems running Gopher, HTTP, FTP,
- WAIS, and NNTP servers.
- .
- This package contains a development version of lynx.
+Description: text-mode web browser
+ Lynx is a fully-featured and fast web browser to be used in text terminal.
+ It can't display images or videos embedded to HTML pages but can launch
+ external programs to handle them.
+
+ Lynx supports HTTP, HTTPS, FTP, NNTP, Gopher, WAIS, and more.
Start all the short descriptions with lower-case.
I wouldn't say that lynx is particularly easy for beginners.
Don't mention NLS (Native Language Support) as this afaik only means that
the program can be translated to another languages easily.
Don't mention this being development version as there is no stable versions
available in Debian. All the versions since oldstable are from the development
branch of the 2.8.7 which was actually just released as stable.
Use term web browser instead of WWW browser (or client) as this is more
common and even more appropriate for lynx. All the web browsers probably
can also view local files so no need to mention that either.
I also tried to make the description more user friendly and less technical,
Moved the protocol list to end and ordered it so that more common are at
the beginning, and added interesting detail about the possibility of using
external programs for multimedia.
Package: lynx-cur-wrapper
Architecture: all
Depends: lynx-cur
-Description: Wrapper for lynx-cur
- This wrapper will provide almost all basic setup of lynx mainly for novice
- users using LANG environment variable so a user needs essentially nothing
- to do except setting LANG appropriately.
+Description: basic settings for Lynx
+ This package provides most common settings for the text-mode web browser
+ Lynx. This package is aimed for novice users. Make sure that the LANG
+ environment variable is set appropriately as this package relies on it.
The name already says it's a wrapper so no need to repeat that.
Improve language and tell more about Lynx.
Package: lynx
Architecture: all
Depends: lynx-cur (>= ${source:Version})
-Description: Text-mode WWW Browser (transitional package)
+Description: text-mode web browser (transitional package)
This is a transitional package and can safely be removed; see the
lynx-cur package instead.
Template: lynx-cur/defaulturl Type: string Default: http://www.debian.org/ _Description: Home page in Lynx: Please enter a URL to be loaded if none is given when Lynx is invoked. . This must be a full URL (including the "http://";) or an absolute pathname (beginning with "/"). Template: lynx-cur/etc_lynx.cfg Type: note _Description: Please check the old configuration file /etc/lynx.cfg File /etc/lynx.cfg belongs to the obsolete package lynx. The lynx-cur package uses configuration file /etc/lynx-cur/lynx.cfg. . Please check the old file and move appropriate settings to the new. It is recommended that you then purge the package lynx.
--- ../lynx-cur.old/debian/templates 2009-07-18 21:09:45.000000000 +0300
+++ debian/templates 2009-07-23 14:51:31.000000000 +0300
@@ -1,16 +1,17 @@
Template: lynx-cur/defaulturl
Type: string
Default: http://www.debian.org/
-_Description: Lynx's homepage:
- Please enter the default URL to use if none is given when invoking lynx.
+_Description: Home page in Lynx:
+ Please enter a URL to be loaded if none is given when Lynx is invoked.
.
- You must enter either a full URL (including the "http://";, etc.) or an
- absolute pathname.
+ This must be a full URL (including the "http://";) or an absolute pathname
+ (beginning with "/").
Template: lynx-cur/etc_lynx.cfg
Type: note
-_Description: Please check old /etc/lynx.cfg
- /etc/lynx.cfg is found but the configuration file of lynx-cur is
- /etc/lynx-cur/lynx.cfg so /etc/lynx.cfg would be of lynx or lynx-ssl.
+_Description: Please check the old configuration file /etc/lynx.cfg
+ File /etc/lynx.cfg belongs to the obsolete package lynx. The lynx-cur package
+ uses configuration file /etc/lynx-cur/lynx.cfg.
.
- Please check it and it will be better to PURGE lynx or lynx-ssl.
+ Please check the old file and move appropriate settings to the new.
+ It is recommended that you then purge the package lynx.
--- ../lynx-cur.old/debian/control 2009-07-18 21:09:45.000000000 +0300
+++ debian/control 2009-07-23 14:50:50.000000000 +0300
@@ -13,27 +13,24 @@
Conflicts: lynx (<< 2.8.7dev9-1.1), lynx-ssl
Recommends: mime-support
Suggests: lynx-cur-wrapper
-Description: Text-mode WWW Browser with NLS support (development version)
- Lynx is a fully-featured World Wide Web (WWW) client for users running
- cursor-addressable, character-cell display devices.
- It is very fast and easy to use. It will display HTML documents
- containing links to files residing on the local system,
- as well as files residing on remote systems running Gopher, HTTP, FTP,
- WAIS, and NNTP servers.
- .
- This package contains a development version of lynx.
+Description: text-mode web browser
+ Lynx is a fully-featured and fast web browser to be used in text terminal.
+ It can't display images or videos embedded to HTML pages but can launch
+ external programs to handle them.
+
+ Lynx supports HTTP, HTTPS, FTP, NNTP, Gopher, WAIS, and more.
Package: lynx-cur-wrapper
Architecture: all
Depends: lynx-cur
-Description: Wrapper for lynx-cur
- This wrapper will provide almost all basic setup of lynx mainly for novice
- users using LANG environment variable so a user needs essentially nothing
- to do except setting LANG appropriately.
+Description: basic settings for Lynx
+ This package provides most common settings for the text-mode web browser
+ Lynx. This package is aimed for novice users. Make sure that the LANG
+ environment variable is set appropriately as this package relies on it.
Package: lynx
Architecture: all
Depends: lynx-cur (>= ${source:Version})
-Description: Text-mode WWW Browser (transitional package)
+Description: text-mode web browser (transitional package)
This is a transitional package and can safely be removed; see the
lynx-cur package instead.
Source: lynx-cur
Section: web
Priority: extra
Maintainer: Atsuhito KOHDA <kohda@debian.org>
Homepage: http://lynx.isc.org/
Build-Depends: debhelper (>= 4.1.16), dpatch, po-debconf, libncursesw5-dev, zlib1g-dev, gettext, libgnutls-dev, zip, unzip, sharutils, bzip2, telnet, openssh-client, exim4-daemon-light | mail-transport-agent
Standards-Version: 3.7.2
Package: lynx-cur
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Provides: www-browser, news-reader
Conflicts: lynx (<< 2.8.7dev9-1.1), lynx-ssl
Recommends: mime-support
Suggests: lynx-cur-wrapper
Description: text-mode web browser
Lynx is a fully-featured and fast web browser to be used in text terminal.
It can't display images or videos embedded to HTML pages but can launch
external programs to handle them.
Lynx supports HTTP, HTTPS, FTP, NNTP, Gopher, WAIS, and more.
Package: lynx-cur-wrapper
Architecture: all
Depends: lynx-cur
Description: basic settings for Lynx
This package provides most common settings for the text-mode web browser
Lynx. This package is aimed for novice users. Make sure that the LANG
environment variable is set appropriately as this package relies on it.
Package: lynx
Architecture: all
Depends: lynx-cur (>= ${source:Version})
Description: text-mode web browser (transitional package)
This is a transitional package and can safely be removed; see the
lynx-cur package instead.
Attachment:
signature.asc
Description: Digital signature