Update the doc strings of deprecated svn_path_* functions to suggest the svn_fspath__* replacement option where appropriate.  Also in that part of the doc strings, stop saying what kind of paths each replacement function is suitable for, since the reader must investigate them anyway, and make a few other clarifications.
Update the doc strings of deprecated svn_path_* functions to suggest the
svn_fspath__* replacement option where appropriate.  Also in that part of
the doc strings, stop saying what kind of paths each replacement function is
suitable for, since the reader must investigate them anyway, and make a few
other clarifications.

* subversion/include/svn_path.h
  (*): As above.
  (svn_path_join_many): Note the option of a sequence of *_join() calls.
  (svn_path_get_absolute): Note that svn_dirent_get_absolute() is only
    suitable for a non-URL input.
  (svn_path_split_if_file): Note that no direct replacement is provided.


git-svn-id: f8a4e5e023278da1e04e203c7fe051e3c4285d88@1043007 13f79535-47bb-0310-9956-ffa450edef68

wbond/subversion,wbond/subversion,YueLinHo/Subversion,wbond/subversion,YueLinHo/Subversion,YueLinHo/Subversion,wbond/subversion,YueLinHo/Subversion,YueLinHo/Subversion,YueLinHo/Subversion,wbond/subversion,wbond/subversion,YueLinHo/Subversion,YueLinHo/Subversion,wbond/subversion