Alternatively, we could explicitly explain the object display mechanism in the command's help documentation, or there are other ways to avoid this.
There is no bug here. Discussions on how to improve the documentation do not belong on this mailing list.
If you have a concrete improvement to propose we have a -docs list for such things. But the system is complex and sometimes requires reading multiple areas to understand how something works.
