Follow up from #4453

Currently, documentation for <b-table> really only discusses and provides examples for the row-selected event:
https://bootstrap-vue.org/docs/components/table/#row-select-support

The only places the row-clicked event is mentioned are:
https://bootstrap-vue.org/docs/components/table/#data-row-accessibility
https://bootstrap-vue.org/docs/components/table/#comp-ref-b-table-events
https://bootstrap-vue.org/docs/components/table/#comp-ref-b-table-lite-events

This event can easily be overlooked and can cause confusion as to how to implement proper "click" support.

There needs to be documentation and examples regarding the difference between a "selected" row and a "clicked" row, which have completely different use cases.