message: Changed style of function doc comments to jsdoc style in url-utils.
diff: @@ -32,25 +32,30 @@ const sharedRelativeUrlProperties =
  */
  export type UrlString = string;
  -// Returns true if the href is an absolute path.
  +/**
  + * Returns true if the href is an absolute path.
  + */
  export function isAbsolutePath(href: string): boolean {
  return constants.ABS_URL.test(href);
  }
  -// Returns true if the href is a templated value, i.e. `{{...}}` or `[[...]]`
  +/**
  + * Returns true if the href is a templated value, i.e. `{{...}}` or `[[...]]`
  + */
  export function isTemplatedUrl(href: string): boolean {
  return href.search(constants.URL_TEMPLATE) >= 0;
  }
  -// Computes the most succinct form of a relative URL representing the path from
  -// the `fromUri` to the `toUri`. Function is URL aware, not path-aware, so
  -// `/a/` is correctly treated as a folder path where `/a` is not.
  +/**
  + * Computes the most succinct form of a relative URL representing the path from
  + * the `fromUri` to the `toUri`. Function is URL aware, not path-aware, so
  + * `/a/` is correctly treated as a folder path where `/a` is not.
  + */
  export function relativeUrl(fromUri: string, toUri: string): string {
  const fromUrl = url.parse(fromUri)!;
  const toUrl = url.parse(toUri)!;
  // Return the toUri as-is if there are conflicting components which
  - // prohibit
  - // calculating a relative form.
  + // prohibit calculating a relative form.
  if (sharedRelativeUrlProperties.some(
  p => toUrl[p] !== null && fromUrl[p] !== toUrl[p])) {
  return toUri;
  @@ -68,10 +73,12 @@ export function relativeUrl(fromUri: string, toUri: string): string {
  return url.format(toUrl);
  }
  -// Modifies an href by the relative difference between the `mainDocUrl` and
  -// `importUrl` which is the location of the imported document containing the
  -// href. If `basePath` is defined, it rewrites the path as an absolute path
  -// using `basePath` as its root.
  +/**
  + * Modifies an href by the relative difference between the `mainDocUrl` and
  + * `importUrl` which is the location of the imported document containing the
  + * href. If `basePath` is defined, it rewrites the path as an absolute path
  + * using `basePath` as its root.
  + */
  export function rewriteImportedRelPath(
  basePath: string|undefined,
  importUrl: string,
  