fix(std): Don't use JSDoc syntax for browser-compatibility headers (#8960)

docs/contributing/style_guide.md

@@ -355,7 +355,7 @@ If a module is browser compatible, include the following in the JSDoc at the top
 of the module:
 
 ```ts
-/** This module is browser compatible. */
+// This module is browser compatible.
 ```
 
 Maintain browser compatibility for such a module by either not using the global

std/encoding/ascii85.ts

@@ -1,5 +1,5 @@
 // Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
-/** This module is browser compatible. */
+// This module is browser compatible.
 
 export type Ascii85Standard = "Adobe" | "btoa" | "RFC 1924" | "Z85";
 /**

std/encoding/csv_stringify.ts

@@ -1,7 +1,7 @@
 // Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
 // Implements the CSV spec at https://tools.ietf.org/html/rfc4180
 
-/** This module is browser compatible. */
+// This module is browser compatible.
 
 const QUOTE = '"';
 export const NEWLINE = "\r\n";

std/fmt/colors.ts

@@ -1,16 +1,16 @@
 // Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
-/** A module to print ANSI terminal colors. Inspired by chalk, kleur, and colors
- * on npm.
- *
- * ```
- * import { bgBlue, red, bold } from "https://deno.land/std/fmt/colors.ts";
- * console.log(bgBlue(red(bold("Hello world!"))));
- * ```
- *
- * This module supports `NO_COLOR` environmental variable disabling any coloring
- * if `NO_COLOR` is set.
- *
- * This module is browser compatible. */
+// A module to print ANSI terminal colors. Inspired by chalk, kleur, and colors
+// on npm.
+//
+// ```
+// import { bgBlue, red, bold } from "https://deno.land/std/fmt/colors.ts";
+// console.log(bgBlue(red(bold("Hello world!"))));
+// ```
+//
+// This module supports `NO_COLOR` environmental variable disabling any coloring
+// if `NO_COLOR` is set.
+//
+// This module is browser compatible.
 
 const noColor = globalThis.Deno?.noColor ?? true;
 

std/path/_constants.ts

@@ -1,6 +1,6 @@
 // Copyright the Browserify authors. MIT License.
 // Ported from https://github.com/browserify/path-browserify/
-/** This module is browser compatible. */
+// This module is browser compatible.
 
 // Alphabet chars.
 export const CHAR_UPPERCASE_A = 65; /* A */

std/path/_interface.ts

@@ -1,5 +1,5 @@
 // Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
-/** This module is browser compatible. */
+// This module is browser compatible.
 
 /**
  * A parsed path object generated by path.parse() or consumed by path.format().

std/path/_util.ts

@@ -1,6 +1,6 @@
 // Copyright the Browserify authors. MIT License.
 // Ported from https://github.com/browserify/path-browserify/
-/** This module is browser compatible. */
+// This module is browser compatible.
 
 import type { FormatInputPathObject } from "./_interface.ts";
 import {

std/path/common.ts

@@ -1,5 +1,5 @@
 // Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
-/** This module is browser compatible. */
+// This module is browser compatible.
 
 import { SEP } from "./separator.ts";
 

std/path/mod.ts

@@ -1,6 +1,6 @@
 // Copyright the Browserify authors. MIT License.
 // Ported mostly from https://github.com/browserify/path-browserify/
-/** This module is browser compatible. */
+// This module is browser compatible.
 
 import { isWindows } from "../_util/os.ts";
 import * as _win32 from "./win32.ts";

std/path/posix.ts

@@ -1,6 +1,6 @@
 // Copyright the Browserify authors. MIT License.
 // Ported from https://github.com/browserify/path-browserify/
-/** This module is browser compatible. */
+// This module is browser compatible.
 
 import type { FormatInputPathObject, ParsedPath } from "./_interface.ts";
 import { CHAR_DOT, CHAR_FORWARD_SLASH } from "./_constants.ts";

std/path/separator.ts

@@ -1,5 +1,5 @@
 // Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
-/** This module is browser compatible. */
+// This module is browser compatible.
 
 import { isWindows } from "../_util/os.ts";
 

std/path/win32.ts

@@ -1,6 +1,7 @@
 // Copyright the Browserify authors. MIT License.
 // Ported from https://github.com/browserify/path-browserify/
-/** This module is browser compatible. */
+// This module is browser compatible.
+
 import type { FormatInputPathObject, ParsedPath } from "./_interface.ts";
 import {
   CHAR_BACKWARD_SLASH,

std/testing/_diff.ts

@@ -1,5 +1,5 @@
 // Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
-/** This module is browser compatible. */
+// This module is browser compatible.
 
 interface FarthestPoint {
   y: number;

std/testing/asserts.ts

@@ -1,6 +1,6 @@
 // Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.
-/** This module is browser compatible. Do not rely on good formatting of values
- * for AssertionError messages in browsers. */
+// This module is browser compatible. Do not rely on good formatting of values
+// for AssertionError messages in browsers.
 
 import { bold, gray, green, red, stripColor, white } from "../fmt/colors.ts";
 import { diff, DiffResult, DiffType } from "./_diff.ts";