Re: request for review ITP for guidata and guiqwt
PICCA Frédéric-Emmanuel wrote:
> http://packages.python.org/guidata/
> http://packages.python.org/guiqwt/
(I imagine the Debian binary packages these descriptions are
attached to will have names like "python-guidata".)
> guidata:
>
> Description: Python library providing auto-generated GUIs for data set edition/display
Well, you want "editing", not "edition", here and in the long
description. But this is also a bit long, and wastes some time
explaining that it's a Python library, which should already be
obvious from the name and the fact it's in Section: python.
When it talks about providing auto-generated GUIs, I assume it isn't
just an archive of GUI-specifications that upstream has
auto-generated so that guidata can hand them out at random - it's
this library that does the generating, right? So we could cut it
right down to:
Description: dataset manipulation GUI generator
(If it was an end-user app I'd say "data set", but programmers
probably expect to see it written as one word.)
> Based on the Qt Python binding module PyQt4, guidata is a Python library
> for easy data set edition (and display) thanks to automatically generated
> graphical user interfaces - it also provides helpers and application development
> tools for PyQt4.
The "thanks to" is intelligible but strange (it's a Python
library... thanks to some GUIs!) and it still doesn't state whether
(as I would imagine) it's this library that *does* the
GUI-generating. So I would suggest
Description: dataset manipulation GUI generator
Based on the Qt Python binding module PyQt4, guidata is a Python library
generating graphical user interfaces for easy dataset editing and display.
It also provides helpers and application development tools for PyQt4.
> guiqwt:
>
> Description: Python library for efficient 2-D data plotting
No need for a hyphen in 2-D.
This is harder to get the python-pylibpython-mcpython references out
of; I'll at least need to leave in the L-word.
Description: efficient 2D data-plotting library
> Based on PyQwt (plot widgets for PyQt4 graphical user interfaces)
> and on scientific modules NumPy and SciPy, guiqwt is a Python library for
> efficient 2-D data plotting (curves, 1-D and 2-D histograms, images) and
> signal/image processing application development.
"Plot widgets" sound like something out of TVTropes. Should it be
"plotting widgets"?
If "curves, 1-D and 2-D histograms, images" are things that guiqwt
produces, is that an exhaustive list or just a sample?
The "application development" is at the end of a noun-pile with a
slightly unclear structure. Is it "efficient data-plotting
application development and signal/image processing application
development" or is it "signal/image processing application
development and efficient data-plotting"? I suspect the former, and
that it's a bit redundant given that this is a programming library -
you could just say:
Description: efficient 2D data-plotting library
Based on PyQwt (plotting widgets for PyQt4 graphical user interfaces)
and on the scientific modules NumPy and SciPy, guiqwt is a Python library
for signal/image processing and efficient 2D data-plotting, producing
curves, images, and 1D or 2D histograms.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
Reply to: