-C<objects> and displays the object's properties in a table. It also
-displays a list of other objects related to the first one via
-C<has_many> style relationships.
+C<objects> and displays the object's properties in a table. It gets
+the displayable form of a column's name from the hash returned from
+the C<column_names> method:
+
+ <TR>
+ <TD class="field"> [% classmetadata.colnames.$col; %] </TD>
+
+One interesting macro used in this template is C<maybe_link_view>:
+
+ maybe_link_view(item.$col);
+
+This tests whether or not the returned value is an object, and if so,
+creates a link to a page viewing that object; if not, it just displays
+the text as normal. The object is linked using its stringified name;
+by default this calls the C<name> method, or returns the object's ID
+if there is no C<name> method or other stringification method defined.
+
+The C<view> template also displays a list of other objects related to the first
+one via C<has_many> style relationships; this is done by calling the
+C<related_accessors> method - see L<Model/related_accessors> - to return
+a list of has-many accessors. Next it calls each of those accessors, and
+displays the results in a table.