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

[RFR] templates://zekr-quran-translations-en/{templates}



Please find, for review, the debconf templates and packages descriptions for the zekr-quran-translations-en 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:
--- ../zekr-quran-translations-en.old/debian/templates	2007-10-12 08:13:30.592122027 +0200
+++ debian/templates	2007-10-13 09:59:04.407713893 +0200
@@ -1,42 +1,33 @@
 Template: quran-translations-en/present-Zekr-Quran-Trans-disclaimer
 Type: note
-_Description: NO WARRANTY FOR AUTHENTICITY OF THE QUR'AN TRANSLATIONS!
- Disclaimer: The translations come with this package are publicly
- available on the web. We just collected and debianized them into a
- single package. So, THERE IS NO WARRANTY OF ANY KIND FOR AUTHENTICITY
- AND/OR CORRECTNESS OF THE PROVIDED QUR'AN TRANSLATIONS.
+_Description: No authenticity warranty
+ Translations provided in this package are a colelction of publicly
+ available translations on the web.

Really no reason to yell out in synopsis..:)

The following comment applies to many changes I propose, indeed:

This template already interrupts installations and is therefore
invasive enough.

I perfectly understand that the topic is sensitive and you want the
main point to be understood by readers: any translatio of the Qur'an
is by definition imperfect and an interpretation of the original text.

But That can be done without being too verbose, imhi.

  .
- Besides, According to Islamic theology, perfectly translating the
- Qur'an is impossible. For instance, Abdullah Yusuf Ali, whose
- translation of the Qur'an ranks alongside the translation of
- Marmaduke Pickthall as the most widely-known and used in the world,
- wrote the following passage in the preface to his translation:
+ According to Islamic theology, perfectly translating the
+ Qur'an is impossible. Most of the time, English translations are
+ considered to be 'intepretations', side by side with the Arabic text.
+ attempting to provide its best expression.

Shorten this down. Keep the topic general instead of bringing one of
the Qur'an translators opinion.


  .
- "Gentle and discerning reader! what I wish to present to you is an
- English Interpretation, side by side with the Arabic Text. The
- English shall be, not a mere substitution of one word for another,
- but the best expression I can give to the fullest meaning which I can
- understand from the Arabic Text."
- .
- For more information see README.txt.
+ For more information, please read the
+ /usr/share/doc/zekr-quran-translations-en/README.txt.gz file.

Drop the quote. It can be kept in README.Debian, or README.txt if you
prefer.

Give the complete path of the README.txt file.
 
 Template: quran-translations-en/present-Zekr-Quran-Trans-copyright
 Type: note
-_Description: NOT PERMITTED TO DISTRIBUTE FOR COMMERCIAL PURPOSES!
- Please be aware that It is NOT PERMITTED to distribute ANY OF THE
- TRANSLATIONS COME WITH THIS PACKAGE for commercial purposes. They
- only come in the hope that they will be helpful for those wanting to
- learn more about Islam.
+_Description: Commercial redistribution prohibited
+ The contents of this package should not be resistributed for
+ commercial purposes. It is only provided to help readers to learn
+ more about Islam.

Again, avoid shouting.

Just explain the point simply.
 
 Template: quran-translations-en/accepted-Zekr-Quran-Trans
 Type: boolean
 Default: false
-_Description: Do you agree with the terms?
- In order to install this package, you must agree to the terms.
+_Description: Do you agree with the license terms?
+ In order to install this package, please agree to the licensing terms,
+ particularly with the prohibition of commercial distribution.

Do you agree with the <what> terms..:-)

That template could indeed be merged with the former one, to display
the licensing terms *and* request the reader to agree.
 
 Template: quran-translations-en/error-Zekr-Quran-Trans
 Type: error
-_Description: Declined terms for the Qur'an translations
- If you do not agree to the terms you cannot install this package.
- .
- The installation of this package will be canceled.
+_Description: Declined Qur'an translations license terms
+ As you declined this package's license terms, its installation
+ will be aborted.

Rephrase

BTW, we should decide between "licensing terms" and "license terms"..:)


--- ../zekr-quran-translations-en.old/debian/control	2007-10-12 08:13:30.592122027 +0200
+++ debian/control	2007-10-13 10:01:32.900433324 +0200
@@ -4,25 +4,23 @@
 Maintainer: Mohammad Derakhshani <zekr.debian@gmail.com>
 Build-Depends: debhelper (>= 5), cdbs, po-debconf, unzip
 Standards-Version: 3.7.2
+Homepage: http://www.siahe.com/zekr/resources.html

Use new "Homepage:" field
 
 Package: zekr-quran-translations-en
 Architecture: all
 Pre-Depends: debconf (>= 0.5) | debconf-2.0
 Depends: zekr, ${misc:Depends}, ${shlibs:Depends}
 Recommends: ttf-freefont
-Description: Zekr Quran English Translations
- These translations can be used with Zekr, Quranic software.
- This package contains the following Quran translations:
+Description: Zekr Quran English translations
+ This package provides translations can be used with Zekr, Quranic software.
+ It contains the following Quran translations:

Uncapitalize "translations"

Use "this package provides" to make the long description autonomous
from the synopsis.

  .
- English - United States English
-  * M. H. Shakir (shakir.zip)
-  * Abdullah Yusufali (yusufali.zip)
-  * Mohammed Marmaduke William Pickthall (pickthall.zip)
+ English - United States English. Authors:
+  - M. H. Shakir (shakir.zip);
+  - Abdullah Yusufali (yusufali.zip);
+  - Mohammed Marmaduke William Pickthall (pickthall.zip).

Use our standard bulleting method.
  .
-  Homepage: http://www.siahe.com/zekr/resources.html
- .

Moved to the special field

- Disclaimer: There is no warranty of any kind for authenticity and/or
- correctness of the following translations. These are publicly
- available translations on the web. We just collected and debianized
- them into a single package. Use them at your own risk!
- (For more information see README.txt coming with this package.)
+ There is no authenticity or correctness warranty for these
+ translations. For more information please read the provided
+ /usr/share/doc/zekr-quran-translations-en/README.txt file.
+

Again, more factual description of the restrictions.

-- 


Template: quran-translations-en/present-Zekr-Quran-Trans-disclaimer
Type: note
_Description: No authenticity warranty
 Translations provided in this package are a colelction of publicly
 available translations on the web.
 .
 According to Islamic theology, perfectly translating the
 Qur'an is impossible. Most of the time, English translations are
 considered to be 'intepretations', side by side with the Arabic text,
 attempting to provide its best expression.
 .
 For more information, please read the
 /usr/share/doc/zekr-quran-translations-en/README.txt.gz file.

Template: quran-translations-en/present-Zekr-Quran-Trans-copyright
Type: note
_Description: Commercial redistribution prohibited
 The contents of this package should not be resistributed for
 commercial purposes. It is only provided to help readers to learn
 more about Islam.

Template: quran-translations-en/accepted-Zekr-Quran-Trans
Type: boolean
Default: false
_Description: Do you agree with the license terms?
 In order to install this package, please agree to the licensing terms,
 particularly with the prohibition of commercial distribution.

Template: quran-translations-en/error-Zekr-Quran-Trans
Type: error
_Description: Declined Qur'an translations license terms
 As you declined this package's license terms, its installation
 will be aborted.
--- zekr-quran-translations-en.old/debian/templates	2007-10-12 08:13:30.592122027 +0200
+++ zekr-quran-translations-en/debian/templates	2007-10-15 07:03:19.649653071 +0200
@@ -1,42 +1,33 @@
 Template: quran-translations-en/present-Zekr-Quran-Trans-disclaimer
 Type: note
-_Description: NO WARRANTY FOR AUTHENTICITY OF THE QUR'AN TRANSLATIONS!
- Disclaimer: The translations come with this package are publicly
- available on the web. We just collected and debianized them into a
- single package. So, THERE IS NO WARRANTY OF ANY KIND FOR AUTHENTICITY
- AND/OR CORRECTNESS OF THE PROVIDED QUR'AN TRANSLATIONS.
+_Description: No authenticity warranty
+ Translations provided in this package are a colelction of publicly
+ available translations on the web.
  .
- Besides, According to Islamic theology, perfectly translating the
- Qur'an is impossible. For instance, Abdullah Yusuf Ali, whose
- translation of the Qur'an ranks alongside the translation of
- Marmaduke Pickthall as the most widely-known and used in the world,
- wrote the following passage in the preface to his translation:
+ According to Islamic theology, perfectly translating the
+ Qur'an is impossible. Most of the time, English translations are
+ considered to be 'intepretations', side by side with the Arabic text,
+ attempting to provide its best expression.
  .
- "Gentle and discerning reader! what I wish to present to you is an
- English Interpretation, side by side with the Arabic Text. The
- English shall be, not a mere substitution of one word for another,
- but the best expression I can give to the fullest meaning which I can
- understand from the Arabic Text."
- .
- For more information see README.txt.
+ For more information, please read the
+ /usr/share/doc/zekr-quran-translations-en/README.txt.gz file.
 
 Template: quran-translations-en/present-Zekr-Quran-Trans-copyright
 Type: note
-_Description: NOT PERMITTED TO DISTRIBUTE FOR COMMERCIAL PURPOSES!
- Please be aware that It is NOT PERMITTED to distribute ANY OF THE
- TRANSLATIONS COME WITH THIS PACKAGE for commercial purposes. They
- only come in the hope that they will be helpful for those wanting to
- learn more about Islam.
+_Description: Commercial redistribution prohibited
+ The contents of this package should not be resistributed for
+ commercial purposes. It is only provided to help readers to learn
+ more about Islam.
 
 Template: quran-translations-en/accepted-Zekr-Quran-Trans
 Type: boolean
 Default: false
-_Description: Do you agree with the terms?
- In order to install this package, you must agree to the terms.
+_Description: Do you agree with the license terms?
+ In order to install this package, please agree to the licensing terms,
+ particularly with the prohibition of commercial distribution.
 
 Template: quran-translations-en/error-Zekr-Quran-Trans
 Type: error
-_Description: Declined terms for the Qur'an translations
- If you do not agree to the terms you cannot install this package.
- .
- The installation of this package will be canceled.
+_Description: Declined Qur'an translations license terms
+ As you declined this package's license terms, its installation
+ will be aborted.
--- zekr-quran-translations-en.old/debian/control	2007-10-12 08:13:30.592122027 +0200
+++ zekr-quran-translations-en/debian/control	2007-10-15 07:03:31.649049629 +0200
@@ -4,25 +4,23 @@
 Maintainer: Mohammad Derakhshani <zekr.debian@gmail.com>
 Build-Depends: debhelper (>= 5), cdbs, po-debconf, unzip
 Standards-Version: 3.7.2
+Homepage: http://www.siahe.com/zekr/resources.html
 
 Package: zekr-quran-translations-en
 Architecture: all
 Pre-Depends: debconf (>= 0.5) | debconf-2.0
 Depends: zekr, ${misc:Depends}, ${shlibs:Depends}
 Recommends: ttf-freefont
-Description: Zekr Quran English Translations
- These translations can be used with Zekr, Quranic software.
- This package contains the following Quran translations:
+Description: Zekr Quran English translations
+ This package provides translations can be used with Zekr, Quranic software.
+ It contains the following Quran translations:
  .
- English - United States English
-  * M. H. Shakir (shakir.zip)
-  * Abdullah Yusufali (yusufali.zip)
-  * Mohammed Marmaduke William Pickthall (pickthall.zip)
+ English - United States English. Authors:
+  - M. H. Shakir (shakir.zip);
+  - Abdullah Yusufali (yusufali.zip);
+  - Mohammed Marmaduke William Pickthall (pickthall.zip).
  .
-  Homepage: http://www.siahe.com/zekr/resources.html
- .
- Disclaimer: There is no warranty of any kind for authenticity and/or
- correctness of the following translations. These are publicly
- available translations on the web. We just collected and debianized
- them into a single package. Use them at your own risk!
- (For more information see README.txt coming with this package.)
+ There is no authenticity or correctness warranty for these
+ translations. For more information please read the provided
+ /usr/share/doc/zekr-quran-translations-en/README.txt file.
+
Source: zekr-quran-translations-en
Section: non-free/x11
Priority: optional
Maintainer: Mohammad Derakhshani <zekr.debian@gmail.com>
Build-Depends: debhelper (>= 5), cdbs, po-debconf, unzip
Standards-Version: 3.7.2
Homepage: http://www.siahe.com/zekr/resources.html

Package: zekr-quran-translations-en
Architecture: all
Pre-Depends: debconf (>= 0.5) | debconf-2.0
Depends: zekr, ${misc:Depends}, ${shlibs:Depends}
Recommends: ttf-freefont
Description: Zekr Quran English translations
 This package provides translations can be used with Zekr, Quranic software.
 It contains the following Quran translations:
 .
 English - United States English. Authors:
  - M. H. Shakir (shakir.zip);
  - Abdullah Yusufali (yusufali.zip);
  - Mohammed Marmaduke William Pickthall (pickthall.zip).
 .
 There is no authenticity or correctness warranty for these
 translations. For more information please read the provided
 /usr/share/doc/zekr-quran-translations-en/README.txt file.

Attachment: signature.asc
Description: Digital signature


Reply to: