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

Re: [RFR] templates://mnogosearch/{templates}



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

The control file looks good, the template has a couple of
misspellings (suers, explicitely), plus a word-choice fix
(indexation).  Attached are a diff against the currently-packaged
version and a revised version incorporating my corrections; inline
below is a diff against the RFR version.

--- templates~	2007-04-06 18:18:01.000000000 +0100
+++ templates	2007-04-06 18:17:16.000000000 +0100
@@ -13,7 +13,7 @@
  The configuration script needs the ability to remotely connect to the
  database server, create databases, add users and create tables. The
  /usr/share/doc/mnogosearch/INSTALL.gz documentation file provides
- information about the setup of these databases for suers who don't
+ information about the setup of these databases for users who don't
  want to run this configuration process automatically.
 
 Template: mnogosearch-common/overwrite_config
@@ -21,14 +21,14 @@
 Default: false
 _Description: Overwrite mnogosearch configuration files?
  Existing mnogosearch configuration files will not be overwritten
- unless explicitely accepted.
+ unless explicitly accepted.
 
 Template: mnogosearch-common/database_mode
 Type: select
 __Choices: single, multi
 Default: multi
 _Description: Layout mode for the index database:
- You can choose among different indexation modes for the mnogosearch
+ You can choose among different indexing modes for the mnogosearch
  database:
   - single: words are stored in a single table;
   - multi:  words are spread over 13 tables sorted on word length. This
--- templates~	2007-04-06 18:28:51.000000000 +0100
+++ templates	2007-04-06 18:17:16.000000000 +0100
@@ -1,34 +1,38 @@
+# These debconf templates have been proofread by the debian-l10n-english
+# team.
+#
+# Please consider interacting with the team if you intend
+# to modify the templates or add new templates
+
 Template: mnogosearch-common/welcome
 Type: note
-_Description: Welcome to the mnogosearch setup program
- Please note that these options will only be asked of you the first time
- around and only new options will show during future upgrades.
+_Description: Mnogosearch setup program
+ Please note that questions about the mnogosearch settings will only
+ be asked once for each option.
  .
- For this install script to be able to do its job you will need to allow it
- to remotely connect to the database server, create databases, add users
- and make tables.  If you don't want this script to do it automatically,
- then read /usr/share/doc/mnogosearch/INSTALL.gz
+ The configuration script needs the ability to remotely connect to the
+ database server, create databases, add users and create tables. The
+ /usr/share/doc/mnogosearch/INSTALL.gz documentation file provides
+ information about the setup of these databases for users who don't
+ want to run this configuration process automatically.
 
 Template: mnogosearch-common/overwrite_config
 Type: boolean
 Default: false
 _Description: Overwrite mnogosearch configuration files?
- By default if you already have mnogosearch configuration files then this
- process will not overwrite those files. However, you can elect to
- have these files overwritten here.
+ Existing mnogosearch configuration files will not be overwritten
+ unless explicitly accepted.
 
 Template: mnogosearch-common/database_mode
 Type: select
-Choices: single, multi
+__Choices: single, multi
 Default: multi
-_Description: Layout (mode) of the index database:
- The database can index in four different modes.  Each mode gets
- progressively more complex but you win on search speed and indexing.
- .
- 'Single' is where words are stored in a single table. Simple stuff.
- .
- 'Multi' spreads the words over 13 tables sorted on word length.  It means
- you can have fixed width tables which are usually faster.
+_Description: Layout mode for the index database:
+ You can choose among different indexing modes for the mnogosearch
+ database:
+  - single: words are stored in a single table;
+  - multi:  words are spread over 13 tables sorted on word length. This
+            results in faster fixed width tables.
  .
  For more information about these modes, read
  /usr/share/doc/mnogosearch/storage.txt
@@ -37,73 +41,73 @@
 Type: select
 Choices: sqlite, mysql, pgsql
 Default: sqlite
-_Description: Type of database:
- You choose here what sort of database you are going to run to use the
- indexer. SQLite (embedded), PostgreSQL and MySQL are currently supported.
+_Description: Database server type for mnogosearch:
+ Please choose the type of the database server that will store
+ the indexer data for mnogosearch.
 
 Template: mnogosearch-common/database_admin_user
 Type: string
 Default: root
-_Description: Name of the database superuser:
- The superuser name is required so this script can connect to your database
- and add users, databases and tables.  This user needs administrator
- privledges on the database.  It is most often not the superuser for the
- Unix account (eg root).
+_Description: Database server administrative user:
+ Please mention the name of the database server administrative
+ account. This account must have privileges to add users, databases
+ and tables.
 
 Template: mnogosearch-common/database_admin_pass
 Type: password
-_Description: Password of the database superuser:
- The superuser password is required so this script can connect to your database
- and add users, databases and tables.
+_Description: Database server administrative user password:
 
 Template: mnogosearch-common/database_host
 Type: string
 Default: localhost
-_Description: Hostname where your database is running:
- If your database is on another machine besides the one that mnogosearch is
- running on then you need to change this value to the fully qualified
- domain name for that system.
+_Description: Database server host name:
+ Please provide the hostname of the server that will host mnogosearch
+ databases.
 
 Template: mnogosearch-common/database_port
 Type: string
-_Description: Port to connect to the database:
- The database will be listening to a port.  Usually you can
- leave this as the default.
+_Description: Port number for the database service:
+ Please specify the database server connection port.
 
 Template: mnogosearch-common/database_name
 Type: string
 Default: mnogosearch
-_Description: Name of your mnogosearch database:
- By default this will be "mnogosearch".  This is where all the mnogosearch
- related database items will be setup and stored.
+_Description: Database name for mnogosearch:
+ Please provide a name for the database to be used by mnogosearch.
 
 Template: mnogosearch-common/local_database
 Type: boolean
 Default: true
-_Description: Are you running the database locally?
- If you are running the database on the same machine as mnogosearch, then
+_Description: Is the database server local on this host?
+ If the database server runs on the same machine as mnogosearch,
  mnogosearch can connect to the database using a Unix socket rather than a
- TCP/IP one, which is often better.  Answering false here means you have
- enabled the database to listen on the TCP/IP socket.
+ TCP/IP one.
+ .
+ If you do not choose this option, the local database server must
+ allow TCP/IP socket connections.
 
 Template: mnogosearch-common/database_user
 Type: string
 Default: mnogosearch
-_Description: Username for your database:
-  What username will access the database for mnogosearch?  By default this
- is
-  it's own user "mnogosearch" so that permissions can be tightened down.
+_Description: Database user name:
+ Please provide a user name for mnogosearch to register with the
+ database server. This database user is not necessarily the same as a
+ system login, especially if the database is on a remote server.
+ .
+ This is the user which will own the database, tables and other
+ objects to be created by this installation. This user will have
+ complete freedom to insert, change or delete data in the database.
 
 Template: mnogosearch-common/database_pass
 Type: password
-_Description: Password for your database:
-  What password will access the database for mnogosearch? 
+_Description: Database user password:
 
 Template: mnogosearch-common/configure_database
 Type: boolean
 Default: false
-_Description: Configure the database?
- This script can create database users, create a database and setup the tables
- for you automatically. NOTE: the current database content will be destroyed
- if you choose this option.
+_Description: Automatically configure the database for mnogosearch?
+ The database, its tables and users can be automatically created.
+ .
+ Please note that the existing database content will be removed if you
+ choose this option.
 
# These debconf templates have been proofread by the debian-l10n-english
# team.
#
# Please consider interacting with the team if you intend
# to modify the templates or add new templates

Template: mnogosearch-common/welcome
Type: note
_Description: Mnogosearch setup program
 Please note that questions about the mnogosearch settings will only
 be asked once for each option.
 .
 The configuration script needs the ability to remotely connect to the
 database server, create databases, add users and create tables. The
 /usr/share/doc/mnogosearch/INSTALL.gz documentation file provides
 information about the setup of these databases for users who don't
 want to run this configuration process automatically.

Template: mnogosearch-common/overwrite_config
Type: boolean
Default: false
_Description: Overwrite mnogosearch configuration files?
 Existing mnogosearch configuration files will not be overwritten
 unless explicitly accepted.

Template: mnogosearch-common/database_mode
Type: select
__Choices: single, multi
Default: multi
_Description: Layout mode for the index database:
 You can choose among different indexing modes for the mnogosearch
 database:
  - single: words are stored in a single table;
  - multi:  words are spread over 13 tables sorted on word length. This
            results in faster fixed width tables.
 .
 For more information about these modes, read
 /usr/share/doc/mnogosearch/storage.txt

Template: mnogosearch-common/database_type
Type: select
Choices: sqlite, mysql, pgsql
Default: sqlite
_Description: Database server type for mnogosearch:
 Please choose the type of the database server that will store
 the indexer data for mnogosearch.

Template: mnogosearch-common/database_admin_user
Type: string
Default: root
_Description: Database server administrative user:
 Please mention the name of the database server administrative
 account. This account must have privileges to add users, databases
 and tables.

Template: mnogosearch-common/database_admin_pass
Type: password
_Description: Database server administrative user password:

Template: mnogosearch-common/database_host
Type: string
Default: localhost
_Description: Database server host name:
 Please provide the hostname of the server that will host mnogosearch
 databases.

Template: mnogosearch-common/database_port
Type: string
_Description: Port number for the database service:
 Please specify the database server connection port.

Template: mnogosearch-common/database_name
Type: string
Default: mnogosearch
_Description: Database name for mnogosearch:
 Please provide a name for the database to be used by mnogosearch.

Template: mnogosearch-common/local_database
Type: boolean
Default: true
_Description: Is the database server local on this host?
 If the database server runs on the same machine as mnogosearch,
 mnogosearch can connect to the database using a Unix socket rather than a
 TCP/IP one.
 .
 If you do not choose this option, the local database server must
 allow TCP/IP socket connections.

Template: mnogosearch-common/database_user
Type: string
Default: mnogosearch
_Description: Database user name:
 Please provide a user name for mnogosearch to register with the
 database server. This database user is not necessarily the same as a
 system login, especially if the database is on a remote server.
 .
 This is the user which will own the database, tables and other
 objects to be created by this installation. This user will have
 complete freedom to insert, change or delete data in the database.

Template: mnogosearch-common/database_pass
Type: password
_Description: Database user password:

Template: mnogosearch-common/configure_database
Type: boolean
Default: false
_Description: Automatically configure the database for mnogosearch?
 The database, its tables and users can be automatically created.
 .
 Please note that the existing database content will be removed if you
 choose this option.


Reply to: