Bug #74504 for App-Prolix: prolix: under- and wrongly-documented, not working interactively at all

Sun Jan 29 09:25:34 2012 gregoa [...] cpan.org - Ticket created

From:	gregoa [...] cpan.org
Subject:	prolix: under- and wrongly-documented, not working interactively at all

This bug has been forwarded from http://bugs.debian.org/657746 Package: prolix Version: 0.01-1 Severity: serious * the manpage does not give a synopsis or explanation of options, only example uses not directly usable on standard files. No proper documentation of interactive mode either. * trying a simple thing like: strings /usr/bin/gdmflexiserver|prolix -r '[a-z]' ... does filter, but I'm back to the shell without any possibility of interactive use * "prolix -h" tells that "-v" is --verbose, but attempting to use it makes it obvious that it is an alias to (undocumented) --version flag instead, and it does not even give prolix' version * "-l" says "Option log requires an argument", which -h does not tell about well... that makes it *far* less useful than "grep -v" in its current state - looking forward to see it in better shape... Thanks in advance, gregor herrmann, Debian Perl Group

Sun Jan 29 09:40:54 2012 GAAL [...] cpan.org - Taken

Fri Feb 03 14:35:50 2012 GAAL [...] cpan.org - Correspondence added

Thanks for the report. I've just uploaded v0.02 to PAUSE which improves the documentation and addresses most of these issues. More comments inline: On Sun Jan 29 09:25:34 2012, GREGOA wrote: Show quoted text

> * the manpage does not give a synopsis or explanation of options, only > example uses not directly usable on standard files. No proper > documentation of interactive mode either.

In my own use, I run a proprietary server that has very spammy logs. It happens to be Java and huge enough that a log4j config doesn't cut it. But I'm not sure it's a good example because it's not widely known. If you have a favorite overly-verbose command you think would be familiar here, please suggest! Show quoted text

> * trying a simple thing like: > strings /usr/bin/gdmflexiserver|prolix -r '[a-z]' > ... does filter, but I'm back to the shell without any possibility > of interactive use

Clarified the doc. Pipe mode is not intended to ever be interactive (that would be strange abuse of the tty if it could be). I guess one use of this mode is if you have a log dump from a server that already completed and you have a filter pattern saved. Show quoted text

> * "prolix -h" tells that "-v" is --verbose, but attempting to use it > makes it obvious that it is an alias to (undocumented) --version > flag instead, and it does not even give prolix' version

This is a bug in the libraries used by prolix. I've tracked it down and proposed a fix here: https://github.com/gaal/moosex- getopt/commit/292c616795b4cc81ddf05581f09eba0e296a03cc I think the bug can be closed; feel free to reopen (or file a new one) if there are still issues.

Fri Feb 03 14:35:51 2012 The RT System itself - Status changed from 'new' to 'open'

Fri Feb 03 14:35:52 2012 GAAL [...] cpan.org - Status changed from 'open' to 'resolved'