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
1 file changed