added documentation about copy/reference behaviour

made explicit that different forms of indexing can in some circumstances
result in fields being references rather than copies.