[DOC] pt-table-checksum --where has badly formatted example

[Michael Coburn]

[In:Percona Toolkit Documentation]

on http://www.percona.com/doc/percona-toolkit/2.2/pt-table-checksum.html#cmdoption-pt-table-checksum--where

it shows:

:program:`pt-table-checksum` --where "ts > CURRENT_DATE - INTERVAL 1 DAY"

It should probably show:

pt-table-checksum --where "ts > CURRENT_DATE - INTERVAL 1 DAY"

the back ticks and :program: pieces don't make sense when you want to understand the example.

[Hrvoje Matijakovic (hrvojem)]

I think this is caused by code in util/pod2rst-fixed line 78:

$para =~ s/([^\/])$tool/$1:program:`$tool`/g unless $in_code_block;

which doesn't correctly detect a code-block if it's inside the options.

Other tools are affected as well, check:
http://www.percona.com/doc/percona-toolkit/2.2/pt-heartbeat.html#cmdoption-pt-heartbeat--stop

inside the crontab:
0 * * * * :program:`pt-heartbeat` ...

[Frank Cizmich (frank-cizmich)]

Thanks Hrvoje!

For the record: Fixed by adding a perl oneliner that cleans up the html's. It is placed inside the jenkins job that generates them.

[Shahriyar Rzayev (rzayev-sehriyar)]

Percona now uses JIRA for bug reports so this bug report is migrated to: https://jira.percona.com/browse/PT-821