On 2022-11-01 08:57 +0500, Akbarkhon Variskhanov wrote: > On Mon, Oct 31, 2022 at 7:02 PM Wookey <woo...@wookware.org> wrote: > > The description could be more useful. > > "The plugin supports common mathematical operators (+, -, *, /, ^) with > > usual > > precedence rules, and some common functions such as abs(x), sqrt(x), sin(x) > > and cos(x)." > > If it were possible, I wouldn't even write a long description for this > package. I feel like repeating what's already there in the short > description is counter-productive,
You may feel that, but I disagree. Good descriptions, both long and short, are important. Imagine somone reading through a list of our thousands of packages (who maybe never have even _heard_ of XFCE) when writing descriptions. The description needs to tell them enough to decide whether or not they might want to install this thing. > and Xfce panel plugins are Xfce > panel plugins. They depend on having xfce4-panel and anyone who's ever > used Xfce knows where their panel is, what their panel has. Besides, > I'm completely lost as to what else I can say here (aka lacking > creativity). It is an Xfce panel plugin (determined by its name > already), provides a calculator functionality on the Xfce panel > (again, it's in the name). Hence, I've been using XFCE daily for 20 years and I'm still asking for a more useful description because I _don't_ know what this package is/does. What you've said above is pretty good, and I've now actually tried it, so I came up with this: "An XFCE desktop panel plugin, which provides a 'paper mode' style calculator as a box in the panel." The important distinction here is between something that launches a desktop calculator or something that provides a box in the panel that will do calculations. It sounds from what you have said that it is the latter (and I have just installed it to check that that is indeed the case). I was actually a lot more excited about it when I thought it was a quick way to keep something like galculator to hand. > > It needs to say what this _is_. Perhaps something like > > "Provides on-screen calculator from toolbar", then details as above. > > would be wrong, and even with corrections, pointless and/or duplicated info. That fact that I got it wrong after reading your ITP and examining the packaging illustrates the need for the description to clarify what the package actually is/does. > Let me contact upstream for their explanation and rationale for > including LGPL in the source tree. That'll be the best way to work out what was intended. Wookey -- Principal hats: Debian, Wookware, ARM http://wookware.org/
signature.asc
Description: PGP signature