docs: Update ListView JavaDoc comments

 - Use more active and descriptive terms in first-line description
 - Recommend using RecyclerView
 - Add XML example code
 - Direct reader to set an adapter to populate list with views
 - Add pre tags to XML code snippet
 - Give example of displaying more complex views in list
 - Add aside about using convertView if provided
 - Link to guide on handling click events
 - Add cross-link to contextual action mode guide
 - Reframe link to list view guide
 - Advise reader to favor alternative approach to using ListActivity
 - Add paragraph tags
 - Escape @ symbol
 - Fix sentence fragment and change modern -> advanced
 - Fix title of cross-reference to layout guide
 - Remove reference to filename
 - Remove cross-link to contextual action mode
 - Fix malformed link tag
 - Add connecting word
 - Clean up links

Test: Docs change only. Tested with docs build.

Change-Id: Ideb5cc517a7bc08056bb2fe8025c7acea388128b