Please find, for review, the debconf templates of mnogosearch. This review will last from Friday, April 06, 2007 to Monday, April 16, 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: Debconf templates ----------------- This is a complete rewrite. As usual with packages that interact with a database server without using the dbconfig-common package (which should be done but that is out of scope here because this is the maintainer's choice), common wording is essential to guarantee a good consistency among packages. One must also admit that the former wording was far from optimal, even after the recent changes that were intended to remove the lintian warnings. As a consequence, the diff file is mostly useless givne the number of changes and reformatting I introduced Please also note that the initial note is blatant debconf abuse and should indeed be removed. I sent a separate bug report for this but I reworded the template anyway in case some strong objection comes from the maintainer. (however, given the very low activity showed by the maintainer recently, I think that the package will indeed be NMU'ed) Control file ------------ The same stands for that file ; --
# 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 suers 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 explicitely 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
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.
--- ../mnogosearch.old/debian/templates 2007-04-02 07:38:49.412992961 +0200 +++ debian/templates 2007-04-06 06:00:55.809794410 +0200 @@ -1,34 +1,32 @@ 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 suers 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 explicitely 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 indexation 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 +35,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. --- ../mnogosearch.old/debian/control 2007-04-02 07:38:49.408992928 +0200 +++ debian/control 2007-04-06 06:07:19.988866455 +0200 @@ -11,36 +11,42 @@ Conflicts: udmsearch, udmsearch-common Provides: udmsearch-common Replaces: udmsearch, udmsearch-common -Description: A full-featured web search engine (common files) - MnogoSearch consists of two parts. The first part is indexing - mechanism (indexer). - Indexer walks over html hypertext references and stores found words and - new references into database. The second part is web front-end to - provide search using data collected by indexer. For more information, - look at http://search.mnogo.ru/ - . - This package contains common files for all database types, you will also - need to install a mnogosearch-<databasetype> package as well. You can - only have one databasetype installed. +Description: full-featured web search engine (common files) + MnogoSearch consists of two parts. + . + The first part is the indexing mechanism (indexer). + It crawls over HTML hypertext references and stores found words and + new references into a database. + . + The second part is a web front-end that provides search functions + using the data collected by the indexer. For more information, look at + http://search.mnogo.ru/ + . + This package contains common files for all database types. A + mnogosearch-<databasetype> package is also needed to use + mnogosearch. Only one database type package can be installed. Package: mnogosearch-doc Architecture: all Section: doc -Description: Documentation for mnogosearch - MnogoSearch consists of two parts. The first part is indexing - mechanism (indexer). - Indexer walks over html hypertext references and stores found words and - new references into database. The second part is web front-end to - provide search using data collected by indexer. For more information, - look at http://search.mnogo.ru/ +Description: documentation for mnogosearch + MnogoSearch consists of two parts. + . + The first part is the indexing mechanism (indexer). + It crawls over HTML hypertext references and stores found words and + new references into a database. + . + The second part is a web front-end that provides search functions + using the data collected by the indexer. For more information, look at + http://search.mnogo.ru/ . This is the documentation package for mnogosearch. Package: mnogosearch-dev Architecture: all -Description: MnoGoSearch: Development Libraries and Header Files - Contains the headers needed to compile and link programs which use - the mnoGoSearch library. +Description: development libraries and header files for mnogosearch + This package contains the headers needed to compile and link programs + which use the mnoGoSearch library. Package: mnogosearch-pgsql Architecture: any @@ -50,16 +56,18 @@ Conflicts: udmsearch, udmsearch-pgsql, udmsearch-dev, mnogosearch, m17n-lib-bin, m17n-lib-doc, mguesser Replaces: udmsearch, udmsearch-pgsql, mnogosearch Suggests: postgresql-8.1 | postgresql-7.4 | postgresql-8.2 -Description: A full-featured web search engine (postgresql) - MnogoSearch consists of two parts. The first part is indexing - mechanism (indexer). - Indexer walks over html hypertext references and stores found words and - new references into database. The second part is web front-end to - provide search using data collected by indexer. For more information, - look at http://search.mnogo.ru/ +Description: full-featured web search engine (PostgreSQL) + MnogoSearch consists of two parts. + . + The first part is the indexing mechanism (indexer). + It crawls over HTML hypertext references and stores found words and + new references into a database. . - This package contains postgresql specific files, you will also need - the mnogosearch-common package and access to the database. + The second part is a web front-end that provides search functions + using the data collected by the indexer. For more information, look at + http://search.mnogo.ru/ + . + This package contains PostgreSQL specific files. Package: mnogosearch-mysql Architecture: any @@ -68,16 +76,18 @@ Conflicts: udmsearch, udmsearch-mysql, udmsearch-dev, mnogosearch, m17n-lib-bin, m17n-lib-doc, mguesser Replaces: udmsearch, udmsearch-mysql, mnogosearch Suggests: mysql-client -Description: A full-featured web search engine (mysql) - MnogoSearch consists of two parts. The first part is indexing - mechanism (indexer). - Indexer walks over html hypertext references and stores found words and - new references into database. The second part is web front-end to - provide search using data collected by indexer. For more information, - look at http://search.mnogo.ru/ +Description: full-featured web search engine (MySQL) + MnogoSearch consists of two parts. + . + The first part is the indexing mechanism (indexer). + It crawls over HTML hypertext references and stores found words and + new references into a database. + . + The second part is a web front-end that provides search functions + using the data collected by the indexer. For more information, look at + http://search.mnogo.ru/ . - This package contains mysql specific files, you will also need - the mnogosearch-common package and access to the database. + This package contains MySQL specific files. Package: mnogosearch-sqlite Architecture: any @@ -85,13 +95,15 @@ Provides: mnogosearch, mnogosearch-builtin Conflicts: udmsearch, udmsearch-dev, mnogosearch, m17n-lib-bin, m17n-lib-doc, mguesser Replaces: udmsearch, mnogosearch -Description: A full-featured web search engine (SQLite) - MnogoSearch consists of two parts. The first part is indexing - mechanism (indexer). - Indexer walks over html hypertext references and stores found words and - new references into database. The second part is web front-end to - provide search using data collected by indexer. For more information, - look at http://search.mnogo.ru/ +Description: full-featured web search engine (SQLite) + MnogoSearch consists of two parts. . - This package replaces the old builtin database mode. - + The first part is the indexing mechanism (indexer). + It crawls over HTML hypertext references and stores found words and + new references into a database. + . + The second part is a web front-end that provides search functions + using the data collected by the indexer. For more information, look at + http://search.mnogo.ru/ + . + This package contains SQLite specific files.
Source: mnogosearch
Section: web
Priority: optional
Maintainer: Philipp Hug <debian@hug.cx>
Build-Depends: debhelper (>= 4.1.16), libpq-dev (>= 8.0.3), libssl-dev, libz-dev, libmysqlclient15-dev, libsqlite0-dev, openjade | jade, docbook, docbook-dsssl, po-debconf
Standards-Version: 3.7.2
Package: mnogosearch-common
Architecture: all
Depends: debconf|debconf-2.0, mnogosearch
Conflicts: udmsearch, udmsearch-common
Provides: udmsearch-common
Replaces: udmsearch, udmsearch-common
Description: full-featured web search engine (common files)
MnogoSearch consists of two parts.
.
The first part is the indexing mechanism (indexer).
It crawls over HTML hypertext references and stores found words and
new references into a database.
.
The second part is a web front-end that provides search functions
using the data collected by the indexer. For more information, look at
http://search.mnogo.ru/
.
This package contains common files for all database types. A
mnogosearch-<databasetype> package is also needed to use
mnogosearch. Only one database type package can be installed.
Package: mnogosearch-doc
Architecture: all
Section: doc
Description: documentation for mnogosearch
MnogoSearch consists of two parts.
.
The first part is the indexing mechanism (indexer).
It crawls over HTML hypertext references and stores found words and
new references into a database.
.
The second part is a web front-end that provides search functions
using the data collected by the indexer. For more information, look at
http://search.mnogo.ru/
.
This is the documentation package for mnogosearch.
Package: mnogosearch-dev
Architecture: all
Description: development libraries and header files for mnogosearch
This package contains the headers needed to compile and link programs
which use the mnoGoSearch library.
Package: mnogosearch-pgsql
Architecture: any
Depends: ${shlibs:Depends}, mnogosearch-common (= ${source:Version}),
postgresql-client-8.1 | postgresql-client-7.4 | postgresql-client-8.2
Provides: mnogosearch
Conflicts: udmsearch, udmsearch-pgsql, udmsearch-dev, mnogosearch, m17n-lib-bin, m17n-lib-doc, mguesser
Replaces: udmsearch, udmsearch-pgsql, mnogosearch
Suggests: postgresql-8.1 | postgresql-7.4 | postgresql-8.2
Description: full-featured web search engine (PostgreSQL)
MnogoSearch consists of two parts.
.
The first part is the indexing mechanism (indexer).
It crawls over HTML hypertext references and stores found words and
new references into a database.
.
The second part is a web front-end that provides search functions
using the data collected by the indexer. For more information, look at
http://search.mnogo.ru/
.
This package contains PostgreSQL specific files.
Package: mnogosearch-mysql
Architecture: any
Depends: ${shlibs:Depends}, mnogosearch-common (= ${source:Version})
Provides: mnogosearch
Conflicts: udmsearch, udmsearch-mysql, udmsearch-dev, mnogosearch, m17n-lib-bin, m17n-lib-doc, mguesser
Replaces: udmsearch, udmsearch-mysql, mnogosearch
Suggests: mysql-client
Description: full-featured web search engine (MySQL)
MnogoSearch consists of two parts.
.
The first part is the indexing mechanism (indexer).
It crawls over HTML hypertext references and stores found words and
new references into a database.
.
The second part is a web front-end that provides search functions
using the data collected by the indexer. For more information, look at
http://search.mnogo.ru/
.
This package contains MySQL specific files.
Package: mnogosearch-sqlite
Architecture: any
Depends: ${shlibs:Depends}, mnogosearch-common (= ${source:Version})
Provides: mnogosearch, mnogosearch-builtin
Conflicts: udmsearch, udmsearch-dev, mnogosearch, m17n-lib-bin, m17n-lib-doc, mguesser
Replaces: udmsearch, mnogosearch
Description: full-featured web search engine (SQLite)
MnogoSearch consists of two parts.
.
The first part is the indexing mechanism (indexer).
It crawls over HTML hypertext references and stores found words and
new references into a database.
.
The second part is a web front-end that provides search functions
using the data collected by the indexer. For more information, look at
http://search.mnogo.ru/
.
This package contains SQLite specific files.
Attachment:
signature.asc
Description: Digital signature