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

Re: Review of description for initial packaging: rgbpaint



Mats Erik Andersson wrote:
> All good points, but I am not fully content yet.

Well, if I thought I'd got it finished I wouldn't have stuck in so
many question marks.

>>    This package provides the simplified painting program rgbPaint,
>>    successor to mtPaint by the same authors. Light on dependencies, it
>>    can edit and save images in ICO, JPEG, or PNG format only, though
>>    it can also read GIF, PCX, SVG, TGA, and TIFF formats.
> 
> I am not fond of `successor to mtPaint', since mtPaint is made neither
> obsolete, nor redundant. Is `spin-off from' ideomatic? Would `offspring of'
> be preferable? Line breaks have also been improved here!
> 
>     This package provides the simplified painting program rgbPaint,
>     a spin-off from mtPaint by the same authors. Light on dependencies,
>     it can edit and save images in ICO, JPEG, or PNG format only,
>     though it can also read GIF, PCX, SVG, TGA, and TIFF formats.

Yes, that looks good.

>> Is it really necessary to point out that brushes are used for
>> painting, and that only one brush is used at a time?  Is it
>> compulsory to "mix anew" the replaced colour?  I'd like to simplify
>> this down to:
>> 
>>    The user interface is intentionally simple, without drop-down
>>    menus. Ten brushes are provided, and a palette of twenty colors,
>>    each of which can be replaced from a color blender.
> 
> I repeatedly get the the impression that `intentionally simple' is an
> ellipse. Could one insert a neutral `kept'?

In fact I changed it from "simplified" to "simple" here partly
because "simplified" had already been used, but mainly on the
grounds that we should be trying to describe the UI itself (which 
"is simple"; no ellipsis) rather than the development process.  But
"kept" wouldn't do any harm...

> Is `replaced from' ideomatic
> in the present context? Could we use `replaced using a color blender'?

If the colour blender is a source of replacement colours, then
"from" seems natural.  Of course we do have to avoid "replaced by".
 
>    The user interface is intentionally kept simple, without drop-down
>    menus. Ten brushes are provided, and a palette of twenty colors,
>    each of which can be replaced from a color blender. The available
[...]
>>  And it's not obvious to me why I'd want a
>> snapshot of a GTK window getting opened... can it not do snapshots
>> *after* I've drawn something?  Or is the idea that it takes a
>> snapshot before opening and then lets you edit that?
>> 
>>    The available actions are painting, filling, and area selection.
>>    The program can also produce screen snapshots during launch.
> 
> The program can use a command line switch to produce a single screen
> snapshot of the screen content prior to executing rgbPaint. The resulting
> image is immediately loaded by the program as a new image. It can be
> edited or discarded, but no further snapshot can be generated by a
> running program. Is the following wording satisfactory?
> 
>    actions are painting, filling, and area selection. The program can
>    also take a screen snapshot before starting, and use it as its first
>    image.

A program that can do things before starting!

     The program can also start by taking a screen snapshot to use as the
     initial image.
-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
Source: rgbpaint
Section: graphics
Priority: optional
Maintainer: Mats Erik Andersson <mats.andersson@gisladisker.se>
Build-depends: debhelper (>= 7.0.50~), gettext, pkg-config,
 libx11-dev, libglib2.0-dev, libgtk2.0-dev, libpango1.0-dev
Standards-Version: 3.9.1
Homepage: http://mtpaint.sourceforge.net/rgbpaint.html
Vcs-Svn: svn://svn.debian.org/svn/collab-maint/deb-maint/rgbpaint/trunk/
Vcs-Browser: http://svn.debian.org/viewsvn/collab-maint/deb-maint/rgbpaint/trunk/

Package: rgbpaint
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: simple pixel-based painting program
 This package provides the simplified painting program rgbPaint,
 a spin-off from mtPaint by the same authors. Light on dependencies,
 it can edit and save images in ICO, JPEG, or PNG format only,
 though it can also read GIF, PCX, SVG, TGA, and TIFF formats.
 .
 The user interface is intentionally kept simple, without drop-down
 menus. Ten brushes are provided, and a palette of twenty colors,
 each of which can be replaced from a color blender. The available
 actions are painting, filling, and area selection. The program can
 also start by taking a screen snapshot to use as the initial image.
 .
 Originally aimed at the OLPC initiative, rgbPaint works well with
 the Sugar desktop environment - especially with a graphics tablet;
 even young children can quickly master it to produce true brushwork!
--- control.orig	2010-11-17 11:32:16.000000000 +0000
+++ control	2010-11-17 15:40:59.000000000 +0000
@@ -12,25 +12,18 @@
 Package: rgbpaint
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: simple, pixel based painting program
- Rgbpaint is a simplified painting program, derived from its
- ancestor Mtpaint by the very same authors.  It edits and saves
- images of the formats PNG, JPEG, and ICO only.  Some additional
- formats can be read, though: TIFF, GIF, TGA, PCX, and SVG.
+Description: simple pixel-based painting program
+ This package provides the simplified painting program rgbPaint,
+ a spin-off from mtPaint by the same authors. Light on dependencies,
+ it can edit and save images in ICO, JPEG, or PNG format only,
+ though it can also read GIF, PCX, SVG, TGA, and TIFF formats.
  .
- Rgbpaint has by intention a simplified user interface without
- drop down menus.  Painting is done using one out of ten brushes,
- and the palette is made up of twenty colours.  Each of these
- colours may be replaced and mixed anew in a colour blender.
+ The user interface is intentionally kept simple, without drop-down
+ menus. Ten brushes are provided, and a palette of twenty colors,
+ each of which can be replaced from a color blender. The available
+ actions are painting, filling, and area selection. The program can
+ also start by taking a screen snapshot to use as the initial image.
  .
- Painting, filling, and area selection are the available actions.
- The program can make a screen snapshot immediately when starting.
- .
- Rgbpaint was originally aimed at the OLPC initiative, and it
- works well with the Sugar desktop environment. Like its larger
- relative, Mtpaint, a tablet is a true enhancement to Rgbpaint,
- and as such it is quickly mastered also by younger children,
- using true brushwork!
- .
- Rgbpaint needs GTK+2, but the use of GtkPixbuf facilities reduces
- explicit dependency on image handling libraries.
+ Originally aimed at the OLPC initiative, rgbPaint works well with
+ the Sugar desktop environment - especially with a graphics tablet;
+ even young children can quickly master it to produce true brushwork!

Reply to: