<p>I want to try to retain the "reference manual" spirit, and leave the first sentence intact. Please see if this formatting remains readable from your PoV:</p>

<pre><code>...
This attribute is a shorthand for specifying a L&lt;/join&gt; spec, adding all
columns from the joined related sources as L&lt;/+columns&gt; and setting
L&lt;/collapse&gt; to a true value. It can be thought of as a rough B&lt;superset&gt;
of the L&lt;/join&gt; attribute.

For example, the following two queries are equivalent:
...
</code></pre>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">&mdash;<br>Reply to this email directly or <a href="https://github.com/dbsrgits/dbix-class/pull/53#issuecomment-51200301">view it on GitHub</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/302594__eyJzY29wZSI6Ik5ld3NpZXM6QmVhY29uIiwiZXhwaXJlcyI6MTcyMjg2NjE4MSwiZGF0YSI6eyJpZCI6Mzc5NjM1NDN9fQ==--df5b318667ab18c5854c1afd76cfe20890eb7d4e.gif" width="1" /></p>