The testwatcher feature is currently documented only as part of rlCleanup*, which makes it a bit confusing and not overly helpful when one wants to understand the distinction between rlCleanup* bash functions and testwatcher.py. The apparent best place for such more extensive documentation would be /usr/share/doc and to avoid introducing further hack-like paths in the SRPM, depend on bz1206173.
Created attachment 1031258 [details] 0001-move-examples-into-new-subdir-extradocs
Created attachment 1031259 [details] 0002-extradocs-add-testwatcher-design-docs
This bug appears to have been reported against 'rawhide' during the Fedora 23 development cycle. Changing version to '23'. (As we did not run this process for some time, it could affect also pre-Fedora 23 development cycle bugs. We are very sorry. It will help us with cleanup during Fedora 23 End Of Life. Thank you.) More information and reason for this action is here: https://fedoraproject.org/wiki/BugZappers/HouseKeeping/Fedora23
fixed by https://git.fedorahosted.org/cgit/beakerlib.git/commit/?id=40f8a562a08557f09a5845fa754c4a245f8a9018
and fixed by https://git.fedorahosted.org/cgit/beakerlib.git/commit/?id=a8097cc72eac856940330eedbfaf7a1f01bf90bf
This message is a reminder that Fedora 23 is nearing its end of life. Approximately 4 (four) weeks from now Fedora will stop maintaining and issuing updates for Fedora 23. It is Fedora's policy to close all bug reports from releases that are no longer maintained. At that time this bug will be closed as EOL if it remains open with a Fedora 'version' of '23'. Package Maintainer: If you wish for this bug to remain open because you plan to fix it in a currently maintained version, simply change the 'version' to a later Fedora version. Thank you for reporting this issue and we are sorry that we were not able to fix it before Fedora 23 is end of life. If you would still like to see this bug fixed and are able to reproduce it against a later version of Fedora, you are encouraged change the 'version' to a later Fedora version prior this bug is closed as described in the policy above. Although we aim to fix as many bugs as possible during every release's lifetime, sometimes those efforts are overtaken by events. Often a more recent Fedora release includes newer upstream software that fixes bugs or makes them obsolete.
Fedora 23 changed to end-of-life (EOL) status on 2016-12-20. Fedora 23 is no longer maintained, which means that it will not receive any further security or bug fix updates. As a result we are closing this bug. If you can reproduce this bug against a currently maintained version of Fedora please feel free to reopen this bug against that version. If you are unable to reopen this bug, please file a new report against the current release. If you experience problems, please add a comment to this bug. Thank you for reporting this bug and we are sorry it could not be fixed.