Switch to rustdoc

Author: martindisch

swc/src/hash.rs

@@ -1,14 +1,13 @@
 use base64::encode_config;
 use sha3::{Digest, Sha3_256};
 
-/**
- * Creates a CSS identifier of the given length using SHA3
- *
- * In CSS, identifiers (including element names, classes, and IDs in selectors)
- * can contain only the characters [a-zA-Z0-9] and ISO 10646 characters U+00A0 and higher,
- * plus the hyphen (-) and the underscore (_); they cannot start with a digit, two hyphens,
- * or a hyphen followed by a digit.
-*/
+/// Creates a CSS identifier of the given length using SHA3.
+///
+/// In CSS, identifiers (including element names, classes, and IDs in
+/// selectors) can contain only the characters \[a-zA-Z0-9\] and ISO 10646
+/// characters U+00A0 and higher, plus the hyphen (-) and the underscore (_);
+/// they cannot start with a digit, two hyphens, or a hyphen followed by a
+/// digit.
 pub fn hash(data: impl AsRef<[u8]>, length: usize) -> String {
     let mut hasher = Sha3_256::new();
     hasher.update(data);

swc/src/lib.rs

@@ -52,13 +52,14 @@ impl TransformVisitor {
 impl VisitMut for TransformVisitor {
     noop_visit_mut_type!();
 
-    /**
-     * Search for all local names for createVar
-     * E.g.:
-     *  import { createVar } from "css-variable";
-     *  import { createVar as x} from "css-variable";
-     *  import { foo as x, createVar as y } from "css-variable";
-     */
+    /// Searches all local names for `createVar`.
+    ///
+    /// For example:
+    /// ```javascript
+    ///  import { createVar } from "css-variable";
+    ///  import { createVar as x} from "css-variable";
+    ///  import { foo as x, createVar as y } from "css-variable";
+    /// ```
     fn visit_mut_import_decl(&mut self, import_decl: &mut ImportDecl) {
         if &import_decl.src.value != "css-variable" {
             return;