Package: tcpquota
Version: 1.6.15-11
Severity: minor
X-Debbugs-Cc: [EMAIL PROTECTED]
Tags: patch

Minimally,
  /^Description:/s/\.$//
  s/monitors and debit user/monitors and debits users/
  s/depending on there/depending on their/
  s/as a Internet gateway/as an Internet gateway/
  s/debit each user/debits each user/
  s/have to do is run/has to do is run/

I have my qualms about the usage of the word "debit". At the very least,
the third-person singular present tense is "debits" with an s. I hope I
caught all occurrences above. Is it understandable? I gather that the
program actually performs some sort of billing (but then wouldn't "bill"
be a more user-friendly verb to use)?

I am unsure if I understand the second paragraph at all. Superficially,
without really understanding how this package works, I would suggest to
scrap the last two paragraphs and write a higher-level description
instead.

Here is an attempt, which is no doubt slightly clueless and probably
incorrect in the details, but at least it should give you an idea of
what I would like to suggest.

Description: Dialout/masquerading monitoring package
 TCPQuota monitors and bills users for their use of a network
 connection.
 You run it on your Internet gateway, where it monitors connections from
 your internal network (which it can optionally masquerade)
 and from the gateway machine itself.
 A report of per-user bandwidth consumption is periodically generated
 for
 e.g. billing.

What actually happens with the "debited" bandwidth, does the program
throttle or disable connections after you exceed some
administrator-controlled quota (as the name of the package would imply
to me) or is it just used for reporting?

As per the old description, does tcpquota actually manage the
connections in some fashion (i.e. you cannot call out without invoking
it?) and in that case, wouldn't that be a better high-level description
of what it does?

(I downloaded the source to look for more information, but I just found
more copies of the same text which is used in the description. Ideally,
they too should be changed, at least to fix the grammatical errors.)

Sorry for the apparent lack of proper homework here, I just stumbled
over the package description and thought maybe I should try to help. No
doubt this is another prime candidate for a bug which is too unimportant
to fix but too obvious to close with a WONTFIX ... (Have a look in the
BTS for my other bugs to see more, sigh.)

/* era */

-- 
If this were a real .signature, it would suck less.  Well, maybe not.



-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to