Bug#927476: lintian: Please add --onlyrun examples

[Niels Thykier <niels@thykier.net>]

Chris Lamb:
> Package: lintian
> Version: 2.12.0
> Severity: wishlist
> X-Debbugs-CC: Felix Lechner <felix.lechner@lease-up.com>
> 
> Hi,
> 
> I'm currently really failing to understand how --onlyrun works. For
> example:
> 
>   $ t/bin/runtests --onlyrun=test:control-file-rules-requires-root-binary-targets
> 
> ... does not run any tests.
> 
> I'm sure I'm just calling it wrong and, to be clear, this bug report
> is not about this issue but rather could you please add some concrete
> examples to the manual page for each selector type (script, tag, etc.)
> 
> 
> Best wishes,
> 

We already examples in Lintian::Tutorial::TestSuite
(doc/tutorial/Lintian/Tutorial/TestSuite.pod).  However, I suspect they
have not been updated to reflect the "recent" changes to the test suite
and its runner.  I guess Lintian::Tutorial::WritingTests is equally out
of date.

Note: I am fine with removing those POD documents if we now prefer to
keep this documentation elsewhere.  However, if they remain, they should
be updated to reflect the reality.

Thanks,
~Niels