Re: [RFR] templates://mapserver/{php5-mapscript.templates}
Kevin Coyner wrote:
> My comments, which are purely stylistic, are appended below. Use
> them if it sounds better to you.
I'd go for the even simpler formula
$LANG MapScript provides MapServer functions for $LANG scripts.
but "brief documentation" (in place of "short") is perfect.
Also, I'd suggest changing pretty much everything else...
> Template: php5-mapscript/add_extension
...
> _Description: Should ${extname} be added to /etc/php5/${sapiconfig}/php.ini?
> You are installing ${extname} support for php5 and it is not yet
> enabled in the configuration for the ${sapiconfig} SAPI. Enabling
> this extension will allow php5 scripts to use it.
Drop the S(erver)A(pplication)P(rogramming)I(nterface), capitalise
PHP5 and switch it around:
_Description: Should ${extname} support be added for ${sapiconfig}?
You are installing ${extname} support for PHP5, but it is not yet
enabled in /etc/php5/${sapiconfig}/php.ini. Enabling this extension
will allow PHP5 scripts to use it.
Likewise in php5-mapscript/remove_extension.
Then there's the control file...
> Package: php5-mapscript
...
> This module currently works only with PHP as an Apache DSO.
I'm not fluent in PHP-speak, but this *seems* to mean
This module requires PHP to be loaded as an Apache module.
But what's the alternative that it's saying isn't available?
Compiling PHP statically into the Apache binary? That isn't even
supported in Debian as far as I know; just leave this line out.
> Package: perl-mapscript
> Description: perl mapserver library
This *should* be:
Package: libmapscript-perl
Description: Perl Mapserver library
Debian Perl Policy 4.2 is quite clear that a package that exists to
provide mapscript.pm should be called libmapscript-perl. But I'll
assume that's unfixable here.
> Package: cgi-mapserver
...
> Description: cgi module of mapserver
/usr/lib/apache2/modules/mod_cgi.so is a "cgi module";
/usr/lib/cgi-bin/mapserv isn't.
Description: CGI executable for MapServer
> This package contains the cgi binary file. It provides the MapServer
> template language as well as WFS, WMS and WCS server and client
> capabilities.
WMS seems to cover WFS and WCS anyway:
This package contains the mapserv CGI program. It provides the
MapServer template language, and can be used to implement Web Map
Service applications.
If that's really what it's saying...
There's no particular clue either in the dependencies or the
descriptions to the fact that cgi-mapserver is the most important
package in the family (assuming I'm correct in thinking that it is).
Shouldn't it at least carry a what-MapServer-is blurb?
> Package: python-mapscript
> Description: python mapserver lib
Description: Python Mapserver library
> Package: mapserver-bin
..
> Description: mapserver binary utilities
> Binary utilities for using MapServer with the command line.
This is that counterintuitive use of "binaries" in place of
"executables" I've complained about before. Indeed, one of these
"binary utilities" is an ASCII-text Perl script! Make it:
Description: MapServer utilities
Commandline utilities for MapServer.
Then the rest of this blurb (repeated for mapserver-doc, but not the
other packages in the family) is copied from the homepage:
> MapServer is an OpenSource development environment for building spatially
> enabled Internet applications.
Surely a "development environment" would only need to be installed
on the PHP developer's workstation? Instead, MapServer apparently
needs components installed on the production webserver. Then
"spatially enabled" sounds like it ought to mean "interplanetary",
and of course "Open Source" is redundant here.
> The MapServer system includes MapScript that allows popular
> scripting languages such as :
> .
> * PHP provided by php5-mapscript.
> * Python provided by python-mapscript.
> * Perl provided by perl-mapscript.
All a bit redundant, especially in the package description for
mapserver-bin.
> * Java is not supported by any package.
Then why mention it (and not, for instance, Ruby and C#)? And since
when was Java a scripting language, anyhow?
> Mapserver template language, WFS, WMS, WCS are provided by cgi-mapserver.
The WTF TLAs were bad enough in the package description for the
relevant package; we don't want them here too.
All in all I'd replace that whole blurb with this (scraped together
from Wikipedia entries):
MapServer is a CGI-based framework for Internet map services which
supports Open Geospatial Consortium (OGC) standards. Scripting
functionality in MapScript is provided by the suggested mapscript
library packages.
.
Homepage: http://mapserver.gis.umn.edu
(or Homepage: http://mapserver.gis.umn.edu/doc for mapserver-doc)
--
JBR
Ankh kak! (Ancient Egyptian blessing)
--- ../mapserver.old/debian/php5-mapscript.templates 2007-07-04 23:29:25.000000000 +0100
+++ debian/php5-mapscript.templates 2007-07-05 11:53:13.000000000 +0100
@@ -1,15 +1,15 @@
Template: php5-mapscript/add_extension
Type: boolean
Default: true
-_Description: Should ${extname} be added to /etc/php5/${sapiconfig}/php.ini?
- You are installing ${extname} support for php5 and it is not yet
- enabled in the configuration for the ${sapiconfig} SAPI. Enabling
- this extension will allow php5 scripts to use it.
+_Description: Should ${extname} support be added for ${sapiconfig}?
+ You are installing ${extname} support for PHP5, but it is not yet
+ enabled in /etc/php5/${sapiconfig}/php.ini. Enabling this extension
+ will allow PHP5 scripts to use it.
Template: php5-mapscript/remove_extension
Type: boolean
Default: true
-_Description: Should ${extname} be removed from /etc/php5/${sapiconfig}/php.ini?
- You are removing ${extname} support for php5, but it is still enabled
- in the configuration for the ${sapiconfig} SAPI. Leaving this in place
- will probably cause problems when trying to use PHP.
+_Description: Should ${extname} support be removed for ${sapiconfig}?
+ You are removing ${extname} support for PHP5, but it is still enabled
+ in /etc/php5/${sapiconfig}/php.ini. Leaving this in place will
+ probably cause problems when trying to use PHP.
--- ../mapserver.old/debian/control 2007-07-04 23:29:27.000000000 +0100
+++ debian/control 2007-07-05 11:54:52.000000000 +0100
@@ -17,30 +17,33 @@
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Suggests: mapserver-bin, mapserver-doc
-Description: module for php5-cgi to use mapserver
- PHP MapScript allows you to use the MapServer functionalities with PHP web
- scripting language.
- .
- This module currently works only with PHP as an Apache DSO.
+Description: PHP5 MapServer library
+ PHP5 MapScript provides MapServer functions for PHP5 scripts.
Package: perl-mapscript
Section: perl
Architecture: any
Depends: ${perl:Depends}, ${shlibs:Depends}
Suggests: mapserver-bin, mapserver-doc
-Description: perl mapserver library
- perl mapscript allows you to use the MapServer functionalities
- with perl scripting language.
+Description: Perl MapServer library
+ Perl MapScript provides MapServer functions for Perl scripts.
Package: cgi-mapserver
Section: web
Architecture: any
Depends: ${shlibs:Depends}
Suggests: mapserver-bin, mapserver-doc
-Description: cgi module of mapserver
- This package contains the cgi binary file. It provides the MapServer
- template language as well as WFS, WMS and WCS server and client
- capabilities.
+Description: CGI executable for MapServer
+ This package contains the mapserv CGI program. It provides the
+ MapServer template language, and can be used to implement Web Map
+ Service applications.
+ .
+ MapServer is a CGI-based framework for Internet map services which
+ supports Open Geospatial Consortium (OGC) standards. Scripting
+ functionality in MapScript is provided by the suggested mapscript
+ library packages.
+ .
+ Homepage: http://mapserver.gis.umn.edu
Package: python-mapscript
Section: python
@@ -49,30 +52,21 @@
Suggests: mapserver-bin, mapserver-doc
Provides: ${python:Provides}
XB-Python-Version: ${python:Versions}
-Description: python mapserver lib
- Python mapscript allows you to use the MapServer functionalities
- with the Python scripting language.
+Description: Python MapServer library
+ Python MapScript provides MapServer functions for Python scripts.
Package: mapserver-bin
Section: misc
Architecture: any
Depends: ${shlibs:Depends}, ${perl:Depends}
Suggests: libdbi-perl, perl-mapscript, python-mapscript, cgi-mapserver, mapserver-doc, php5-mapscript
-Description: mapserver binary utilities
- Binary utilities for using MapServer with the command line.
- .
- MapServer is an OpenSource development environment for building spatially
- enabled Internet applications.
- .
- The MapServer system includes MapScript that allows popular
- scripting languages such as :
+Description: MapServer utilities
+ Commandline utilities for MapServer.
.
- * PHP provided by php5-mapscript.
- * Python provided by python-mapscript.
- * Perl provided by perl-mapscript.
- * Java is not supported by any package.
- .
- Mapserver template language, WFS, WMS, WCS are provided by cgi-mapserver.
+ MapServer is a CGI-based framework for Internet map services which
+ supports Open Geospatial Consortium (OGC) standards. Scripting
+ functionality in MapScript is provided by the suggested mapscript
+ library packages.
.
Homepage: http://mapserver.gis.umn.edu
@@ -81,20 +75,12 @@
Architecture: all
Depends: ${shlibs:Depends}
Suggests: perl-mapscript, python-mapscript, php5-mapscript, cgi-mapserver
-Description: documentation for mapserver
- Some short documentation and examples for MapServer.
- .
- MapServer is an OpenSource development environment for building spatially
- enabled Internet applications.
- .
- The MapServer system includes MapScript that allows using popular
- scripting languages such as :
- .
- * PHP provided by php5-mapscript.
- * Python provided by python-mapscript.
- * Perl provided by perl-mapscript.
- * Java is not supported by any package.
+Description: documentation for MapServer
+ Some brief documentation and examples for MapServer.
.
- Mapserver template language, WFS, WMS, WCS are provided by cgi-mapserver.
+ MapServer is a CGI-based framework for Internet map services which
+ supports Open Geospatial Consortium (OGC) standards. Scripting
+ functionality in MapScript is provided by the suggested mapscript
+ library packages.
.
Homepage: http://mapserver.gis.umn.edu/docs
Template: php5-mapscript/add_extension
Type: boolean
Default: true
_Description: Should ${extname} support be added for ${sapiconfig}?
You are installing ${extname} support for PHP5, but it is not yet
enabled in /etc/php5/${sapiconfig}/php.ini. Enabling this extension
will allow PHP5 scripts to use it.
Template: php5-mapscript/remove_extension
Type: boolean
Default: true
_Description: Should ${extname} support be removed for ${sapiconfig}?
You are removing ${extname} support for PHP5, but it is still enabled
in /etc/php5/${sapiconfig}/php.ini. Leaving this in place will
probably cause problems when trying to use PHP.
Source: mapserver
Section: devel
Priority: optional
Maintainer: Debian GIS Project <pkg-grass-devel@lists.alioth.debian.org>
Uploaders: Schuyler Erle <schuyler@nocat.net>, Petter Reinholdtsen <pere@debian.org>, Paul Wise <pabs@debian.org>, Fabio Tranchitella <kobold@debian.org>, Francesco Paolo Lovergine <frankie@debian.org>
Standards-Version: 3.7.2
Build-Depends: debhelper (>= 5.0.37.2), dpatch, libcurl4-gnutls-dev, libpng12-dev,
zlib1g-dev (>= 1.1.4), libgd2-xpm-dev (>= 2.0.1-10), libfreetype6-dev (>= 2.0.9),
libjpeg62-dev, libgdal1-dev (>=1.4.0), proj, libwww-dev, libpq-dev, php5-dev, swig,
python-all, python-all-dev, python-central (>= 0.5), libgeos-dev (>= 2.2.3-2)
Build-Depends-Indep: python-docutils
Build-Conflicts: libcurl3-openssl-dev
XS-Python-Version: all
Package: php5-mapscript
Section: web
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Suggests: mapserver-bin, mapserver-doc
Description: PHP5 MapServer library
PHP5 MapScript provides MapServer functions for PHP5 scripts.
Package: perl-mapscript
Section: perl
Architecture: any
Depends: ${perl:Depends}, ${shlibs:Depends}
Suggests: mapserver-bin, mapserver-doc
Description: Perl MapServer library
Perl MapScript provides MapServer functions for Perl scripts.
Package: cgi-mapserver
Section: web
Architecture: any
Depends: ${shlibs:Depends}
Suggests: mapserver-bin, mapserver-doc
Description: CGI executable for MapServer
This package contains the mapserv CGI program. It provides the
MapServer template language, and can be used to implement Web Map
Service applications.
.
MapServer is a CGI-based framework for Internet map services which
supports Open Geospatial Consortium (OGC) standards. Scripting
functionality in MapScript is provided by the suggested mapscript
library packages.
.
Homepage: http://mapserver.gis.umn.edu
Package: python-mapscript
Section: python
Architecture: any
Depends: ${python:Depends}, ${shlibs:Depends}
Suggests: mapserver-bin, mapserver-doc
Provides: ${python:Provides}
XB-Python-Version: ${python:Versions}
Description: Python MapServer library
Python MapScript provides MapServer functions for Python scripts.
Package: mapserver-bin
Section: misc
Architecture: any
Depends: ${shlibs:Depends}, ${perl:Depends}
Suggests: libdbi-perl, perl-mapscript, python-mapscript, cgi-mapserver, mapserver-doc, php5-mapscript
Description: MapServer utilities
Commandline utilities for MapServer.
.
MapServer is a CGI-based framework for Internet map services which
supports Open Geospatial Consortium (OGC) standards. Scripting
functionality in MapScript is provided by the suggested mapscript
library packages.
.
Homepage: http://mapserver.gis.umn.edu
Package: mapserver-doc
Section: doc
Architecture: all
Depends: ${shlibs:Depends}
Suggests: perl-mapscript, python-mapscript, php5-mapscript, cgi-mapserver
Description: documentation for MapServer
Some brief documentation and examples for MapServer.
.
MapServer is a CGI-based framework for Internet map services which
supports Open Geospatial Consortium (OGC) standards. Scripting
functionality in MapScript is provided by the suggested mapscript
library packages.
.
Homepage: http://mapserver.gis.umn.edu/docs
Reply to: