annotate code based on investigation of ARI-3745. strictly javadoc/comment change only.
annotate code more
  strictly javadoc/comment/import cleanup only.
add test case capturing ARI-3745: https: URLs do not get rewritten in proxy mode.
  NOTE: TEST FAILS.
document other findings related to ARI-3745.
  javadoc change only.
fix buggy assertions in StringTransformer tests (ARI-3745)
FIX https:// URLs in JavaScript/CSS/META-REFRESH are not rewritten in proxy mode, with StringTransformer based ReplayRenderer.