code: public String substituteLink(CmsObject cms, String link) {
  
          return substituteLink(cms, link, null, false);
      }
docs: Returns a link <i>from</i> the URI stored in the provided OpenCms user context
  <i>to</i> the VFS resource indicated by the given <code>link</code> in the current site,
  for use on web pages.<p>
  
  The provided <code>link</code> is assumed to be the contained in the site currently
  set in the provided OpenCms user context <code>cms</code>.<p>
  
  The result will be an absolute link that contains the configured context path and
  servlet name, and in the case of the "online" project it will also be rewritten according to
  to the configured static export settings.<p>
  
  In case <code>link</code> is a relative URI, the current URI contained in the provided
  OpenCms user context <code>cms</code> is used to make the relative <code>link</code> absolute.<p>
  
  Please note the above text describes the default behavior as implemented by
  {@link CmsDefaultLinkSubstitutionHandler}, which can be fully customized using the
  {@link I_CmsLinkSubstitutionHandler} interface.<p>
  
  @param cms the current OpenCms user context
  @param link the link to process which is assumed to point to a VFS resource, with optional parameters
  
  @return a link <i>from</i> the URI stored in the provided OpenCms user context
  <i>to</i> the VFS resource indicated by the given <code>link</code> in the current site