Documentation cleanups: Fix formatting and phrasing for consistency, and always describe deprecated interfaces in terms of their latest antecedents.
Documentation cleanups: Fix formatting and phrasing for consistency,
and always describe deprecated interfaces in terms of their latest
antecedents.

* subversion/include/svn_client.h
  (svn_client_checkout2): Fix formatting of doc string.
  (svn_client_checkout): Rewrite doc string against svn_client_checkout3,
    and fix formatting.
  (svn_client_update2): Fix formatting of doc string.
  (svn_client_update): Rewrite doc string against svn_client_update3,
    and fix formatting.
  (svn_client_switch): Fix formatting of doc string.
  (svn_client_add2): Fix formatting of doc string.
  (svn_client_add): Rewrite doc string against svn_client_add3,
    and fix formatting.
  (svn_client_mkdir, svn_client_delete): Fix formatting, and add a
    word to help clarify the deprecation.
  (svn_client_import): Same, plus consistency changes.
  (svn_client_commit3): Fix formatting and phrasing.
  (svn_client_commit2, svn_client_commit): Rewrite doc string
    against svn_client_commit4. 
  (svn_client_status): 
  (svn_client_log2): Fix phrasing.
  (svn_client_log): Rewrite doc string against svn_client_log3.
  (svn_client_blame2): Fix formatting.
  (svn_client_blame): Rewrite doc string against svn_client_blame3.
  (svn_client_diff): Rewrite doc string against svn_client_diff3.
  (svn_client_diff_peg): Rewrite doc string against svn_client_peg3.
  (svn_client_copy2): Fix formatting.
  (svn_client_copy): Rewrite doc string against svn_client_copy3.
  (svn_client_move, svn_client_move2): Rewrite doc strings against
    svn_client_move4.
  (svn_client_propget): Rephrase.
  (svn_client_proplist): Rephrase.
  (svn_client_export2): Rephrase.
  (svn_client_export): Rewrite doc string against svn_client_export3.
  (svn_client_ls): Rewrite doc string against svn_client_ls3.
  (svn_client_add3, svn_client_list, svn_client_lock, svn_client_diff3,
   svn_client_merge2, svn_client_blame3, svn_client_blame2,
   svn_client_import2, svn_client_import2, svn_client_export3): Fix
    doc string formatting for consistency.

jmckaskill/subversion,jmckaskill/subversion,jmckaskill/subversion,jmckaskill/subversion,jmckaskill/subversion,jmckaskill/subversion,jmckaskill/subversion,jmckaskill/subversion