Remove the remaining @bs. annotations

chenglou · chenglou · commit 119edf3e80c7 · 2021-05-07T00:13:21.000-07:00
diff --git a/misc_docs/syntax/decorator_get.mdx b/misc_docs/syntax/decorator_get.mdx
@@ -14,8 +14,8 @@ The `@get` decorator is used to bind to a property of an object.
 
 ```res
 type window
-@bs.val external window: window = "window"
-@bs.get external getName: window => string = "name"
+@val external window: window = "window"
+@get external getName: window => string = "name"
 
 let name = getName(window)
 ```
diff --git a/misc_docs/syntax/decorator_obj.mdx b/misc_docs/syntax/decorator_obj.mdx
@@ -14,7 +14,7 @@ with properties that match the function's parameter labels.
 <CodeTab labels={["ReScript", "JS Output"]}>
 
 ```res
-@bs.obj
+@obj
 external action: (~name: string, unit) => _ = ""
 
 let helloAction = action(~name="Hello")
@@ -32,4 +32,4 @@ function helloAction(param) {
 
 ### References
 
-* [Convert External into JS Object Creation Function](/docs/manual/latest/generate-converters-accessors#convert-external-into-js-object-creation-function)
+* [Convert External into JS Object Creation Function](/docs/manual/latest/generate-converters-accessors#convert-external-into-js-object-creation-function)
diff --git a/misc_docs/syntax/decorator_send.mdx b/misc_docs/syntax/decorator_send.mdx
@@ -14,8 +14,8 @@ The `@send` decorator is used to bind to a method on an object.
 
 ```res
 type document
-@bs.send external getElementById: (document, string) => Dom.element = "getElementById"
-@bs.val external doc: document = "document"
+@send external getElementById: (document, string) => Dom.element = "getElementById"
+@val external doc: document = "document"
 
 let el = getElementById(doc, "myId")
 ```
@@ -28,4 +28,4 @@ var el = document.getElementById("myId");
 
 ### References
 
-* [Bind to JS Function](/docs/manual/latest/bind-to-js-function)
+* [Bind to JS Function](/docs/manual/latest/bind-to-js-function)
diff --git a/misc_docs/syntax/decorator_set.mdx b/misc_docs/syntax/decorator_set.mdx
@@ -14,8 +14,8 @@ The `@set` decorator is used to set a property of an object.
 
 ```res
 type window
-@bs.val external window: window = "window"
-@bs.set external setName: (window, string) => unit = "name"
+@val external window: window = "window"
+@set external setName: (window, string) => unit = "name"
 
 setName(window, "MyWindow")
 ```
diff --git a/misc_docs/syntax/decorator_uncurry.mdx b/misc_docs/syntax/decorator_uncurry.mdx
@@ -15,7 +15,7 @@ In the following example we are binding to a function `map(arr, callback)` and u
 <CodeTab labels={["ReScript", "JS Output"]}>
 
 ```res
-@bs.send
+@send
 external map: (array<'a>, @uncurry ('a => 'b)) => array<'b> = "map"
 
 let result = map([1, 2, 3], x => x + 1)
diff --git a/pages/docs/gentype/latest/supported-types.mdx b/pages/docs/gentype/latest/supported-types.mdx
@@ -51,7 +51,7 @@ If one field of the ReScript record has option type, this is exported to an opti
 ReScript object values of type e.g. `{. "x":int}` such as `{"x": 0}`, `{"x": 1}`, `{"x": 2}`, are exported as identical JS object values `{x:0}`, `{x:1}`, `{x:2}`. This requires no conversion. So they are exported to JS values of type `{x:number}`.
 A conversion is required only when the type of some field requires conversions.
 
-Since objects are immutable by default, their fields will be exported to readonly property types in Flow/TS. Mutable fields are specified in ReScript by e.g. `{. [@bs.set] "mutableField": string }`.
+Since objects are immutable by default, their fields will be exported to readonly property types in Flow/TS. Mutable fields are specified in ReScript by e.g. `{ @set "mutableField": string }`.
 
 It is possible to mix object and option types, so for example the ReScript type `{. "x":int, "y":option(string)}` exports to JS type `{x:number, ?y: string}`, requires no conversion, and allows option pattern matching on the ReScript side.
 
diff --git a/pages/docs/manual/latest/api/dom/storage.mdx b/pages/docs/manual/latest/api/dom/storage.mdx
@@ -45,11 +45,11 @@ external length: t => int = "length"
 ## localStorage
 
 ```res sig
-@bs.val external localStorage: t = "localStorage"
+@val external localStorage: t = "localStorage"
 ```
 
 ## sessionStorage
 
 ```res sig
-@bs.val external sessionStorage: t = "sessionStorage"
+@val external sessionStorage: t = "sessionStorage"
 ```
diff --git a/pages/docs/manual/latest/api/dom/storage2.mdx b/pages/docs/manual/latest/api/dom/storage2.mdx
@@ -51,11 +51,11 @@ external length: t => int = "length"
 ## localStorage
 
 ```res sig
-@bs.val external localStorage: t = "localStorage"
+@val external localStorage: t = "localStorage"
 ```
 
 ## sessionStorage
 
 ```res sig
-@bs.val external sessionStorage: t = "sessionStorage"
+@val external sessionStorage: t = "sessionStorage"
 ```
diff --git a/pages/docs/manual/latest/converting-from-js.mdx b/pages/docs/manual/latest/converting-from-js.mdx
@@ -188,7 +188,7 @@ Now this triggers the next type error, that `school` isn't found. Let's use [`ex
 <CodeTab labels={["ReScript", "JS Output"]}>
 
 ```res example
-@bs.module external school: 'whatever = "school"
+@module external school: 'whatever = "school"
 
 let defaultId = 10
 
@@ -242,8 +242,8 @@ type payload = {
   student: student
 }
 
-@bs.module external school: school = "school"
-@bs.send external getStudentById: (school, int) => student = "getStudentById"
+@module external school: school = "school"
+@send external getStudentById: (school, int) => student = "getStudentById"
 
 let defaultId = 10
 
diff --git a/pages/docs/manual/latest/external.mdx b/pages/docs/manual/latest/external.mdx
@@ -24,12 +24,16 @@ canonical: "/docs/manual/latest/external"
 
 </CodeTab>
 
-There are several kinds of `external`s, differentiated and/or augmented through the `@bs` notation they carry. This page deals with the general, shared mechanism behind most `external`s. The different `@bs` annotations are documented in their respective pages later. A few notable ones:
+There are several kinds of `external`s, differentiated and/or augmented through the [attribute](attribute.md) they carry. This page deals with the general, shared mechanism behind most `external`s. The different are documented in their respective pages later. A few notable ones:
 
 - `@val`, `@scope`: [bind to global JS values](bind-to-global-js-values).
 - `@module`: [bind to JS imported/exported values](import-from-export-to-js).
 - `@send`: [bind to JS methods](bind-to-js-function).
 
+You can also use our [Syntax Lookup](/syntax-lookup) tool to find them.
+
+Related: see also our [list of external decorators](interop-cheatsheet#list-of-decorators).
+
 ## Usage
 
 Once declared, you can use an `external` as a normal value, just like a let binding.
diff --git a/pages/docs/manual/latest/interop-cheatsheet.mdx b/pages/docs/manual/latest/interop-cheatsheet.mdx
@@ -10,7 +10,7 @@ This is a glossary with examples. All the features are described by later pages.
 
 ## List of Decorators
 
-> **Note:** In previous versions (< 8.3) all our attributes started with a `bs.` prefix. Our formatter will automatically drop them in newer ReScript versions.
+> **Note:** In ReScript <8.3, all our attributes started with the `bs.` prefix. This is no longer needed and our formatter automatically removes them in newer ReScript versions.
 
 <!-- Synced from https://github.com/rescript-lang/syntax/blob/123760c5a264da5288eeee5213ddd25eb86d62fe/src/res_printer.ml#L19-L51 -->
 
diff --git a/pages/docs/manual/latest/migrate-from-bucklescript-reason.mdx b/pages/docs/manual/latest/migrate-from-bucklescript-reason.mdx
@@ -57,7 +57,7 @@ npx rescript convert -all
 - No custom infix operator for now (including `mod`).
 - Object access: from `settings##visible #= true` to `settings["visible"] = true`. Rejoice!
 - Object: from `Js.t({"age": int})` to just `{"age": int}`. The `Js.t` part is now implicit.
-- Attribute: from `[@bs.deriving accessors]` to `@bs.deriving(accessors)`. From `[%re bla]` to `%re(bla)`.
+- Attribute: from `[@myAttribute "hello"]` to `@myAttribute("hello")`. From `[%re bla]` to `%re(bla)`.
 - Removed dereference syntax `result^`. Just use `result.contents`.
 - `fun` pattern matching syntax removed.
 - Type declaration is non-recursive by default, consistent with let bindings. To have recursive types, use `type rec myList<'a> = Nil | Cons('a, myList<'a>)`.
diff --git a/pages/docs/manual/latest/pipe.mdx b/pages/docs/manual/latest/pipe.mdx
@@ -92,13 +92,13 @@ Assuming we don't need the chaining behavior above, we'd bind to each case this
 <CodeTab labels={["ReScript", "JS Output"]}>
 
 ```res prelude
-@bs.send external map: (array<'a>, 'a => 'b) => array<'b> = "map"
-@bs.send external filter: (array<'a>, 'a => bool) => array<'a> = "filter"
+@send external map: (array<'a>, 'a => 'b) => array<'b> = "map"
+@send external filter: (array<'a>, 'a => bool) => array<'a> = "filter"
 
 type request
-@bs.val external asyncRequest: unit => request = "asyncRequest"
-@bs.send external setWaitDuration: (request, int) => request = "setWaitDuration"
-@bs.send external send: request => unit = "send"
+@val external asyncRequest: unit => request = "asyncRequest"
+@send external setWaitDuration: (request, int) => request = "setWaitDuration"
+@send external send: request => unit = "send"
 ```
 ```js
 // Empty output
diff --git a/pages/docs/manual/latest/type.mdx b/pages/docs/manual/latest/type.mdx
@@ -275,4 +275,4 @@ Obviously, do **not** abuse this feature. Use it tastefully when you're working
 
 More on externals [here](external.md).
 
-**Note**: this particular `external` is the only one that isn't preceded by a `@bs` annotation.
+**Note**: this particular `external` is the only one that isn't preceded by a `@` [attribute](attribute.md).
diff --git a/pages/docs/manual/latest/variant.mdx b/pages/docs/manual/latest/variant.mdx
@@ -263,7 +263,7 @@ Quite a few JS libraries use functions that can accept many types of arguments.
 
 ```res example
 // reserved for internal usage
-@bs.module("myLibrary") external draw : 'a => unit = "draw"
+@module("myLibrary") external draw : 'a => unit = "draw"
 
 type animal =
   | MyFloat(float)
@@ -297,8 +297,8 @@ betterDraw({
 <CodeTab labels={["ReScript", "JS Output"]}>
 
 ```res example
-@bs.module("myLibrary") external drawFloat: float => unit = "draw"
-@bs.module("myLibrary") external drawString: string => unit = "draw"
+@module("myLibrary") external drawFloat: float => unit = "draw"
+@module("myLibrary") external drawString: string => unit = "draw"
 ```
 ```js
 // Empty output
diff --git a/pages/docs/manual/v9.0.0/migrate-from-bucklescript-reason.mdx b/pages/docs/manual/v9.0.0/migrate-from-bucklescript-reason.mdx
@@ -54,7 +54,7 @@ If you are confident enough, you can add `-f` option to the `rm` command to avoi
 - No custom infix operator for now (including `mod`).
 - Object access: from `settings##visible #= true` to `settings["visible"] = true`. Rejoice!
 - Object: from `Js.t({"age": int})` to just `{"age": int}`. The `Js.t` part is now implicit.
-- Attribute: from `[@bs.deriving accessors]` to `@bs.deriving(accessors)`. From `[%re bla]` to `%re(bla)`.
+- Attribute: from `[@myAttribute "hello"]` to `@myAttribute("hello")`. From `[%re bla]` to `%re(bla)`.
 - Removed dereference syntax `result^`. Just use `result.contents`.
 - `fun` pattern matching syntax removed.
 - Type declaration is non-recursive by default, consistent with let bindings. To have recursive types, use `type rec myList<'a> = Nil | Cons('a, myList<'a>)`.
diff --git a/pages/docs/react/latest/forwarding-refs.mdx b/pages/docs/react/latest/forwarding-refs.mdx
@@ -1,5 +1,5 @@
 ---
-title: Forwarding Refs 
+title: Forwarding Refs
 description: "Forwarding Ref values in ReScript and React"
 canonical: "/docs/react/latest/forwarding-refs"
 ---
@@ -52,7 +52,7 @@ module FancyInput = {
     <div> <input type_="text" ref=inputRef /> children </div>
 }
 
-@bs.send external focus: Dom.element => unit = "focus"
+@send external focus: Dom.element => unit = "focus"
 
 @react.component
 let make = () => {
@@ -105,7 +105,7 @@ module FancyInput = {
   )
 }
 
-@bs.send external focus: Dom.element => unit = "focus"
+@send external focus: Dom.element => unit = "focus"
 
 @react.component
 let make = () => {
@@ -158,7 +158,7 @@ function App(Props) {
   var onClick = function (param) {
     return Belt_Option.forEach(Caml_option.nullable_to_opt(input.current), (function (input) {
                   input.focus();
-                  
+
                 }));
   };
   return React.createElement("div", undefined, React.createElement(make, {
diff --git a/pages/docs/react/latest/hooks-custom.mdx b/pages/docs/react/latest/hooks-custom.mdx
@@ -26,8 +26,8 @@ Let's go back to a previous example from our [React.useEffect section](./hooks-e
 module ChatAPI = {
   // Imaginary globally available ChatAPI for demo purposes
   type status = { isOnline: bool };
-  @bs.val external subscribeToFriendStatus: (string, status => unit) => unit = "subscribeToFriendStatus";
-  @bs.val external unsubscribeFromFriendStatus: (string, status => unit) => unit = "unsubscribeFromFriendStatus";
+  @val external subscribeToFriendStatus: (string, status => unit) => unit = "subscribeToFriendStatus";
+  @val external unsubscribeFromFriendStatus: (string, status => unit) => unit = "unsubscribeFromFriendStatus";
 }
 
 type state = Offline | Loading | Online;
@@ -43,7 +43,7 @@ let make = (~friendId: string) => {
       })
     }
 
-    ChatAPI.subscribeToFriendStatus(friendId, handleStatusChange); 
+    ChatAPI.subscribeToFriendStatus(friendId, handleStatusChange);
     setState(_ => Loading);
 
     let cleanup = () => {
@@ -52,13 +52,13 @@ let make = (~friendId: string) => {
 
     Some(cleanup)
   })
-  
+
   let text = switch(state) {
     | Offline => friendId ++ " is offline"
     | Online => friendId ++ " is online"
     | Loading => "loading..."
   }
-  
+
   <div>
   	{React.string(text)}
   </div>
@@ -89,7 +89,7 @@ function FriendStatus(Props) {
               }));
         return (function (param) {
                   unsubscribeFromFriendStatus(friendId, handleStatusChange);
-                  
+
                 });
       });
   var text;
@@ -103,7 +103,7 @@ function FriendStatus(Props) {
     case /* Online */2 :
         text = friendId + " is online";
         break;
-    
+
   }
   return React.createElement("div", undefined, text);
 }
@@ -119,7 +119,7 @@ Now let’s say that our chat application also has a contact list, and we want t
 // FriendListItem.res
 type state = Offline | Loading | Online;
 
-// module ChatAPI = {...} 
+// module ChatAPI = {...}
 
 type friend = {
   id: string,
@@ -137,7 +137,7 @@ let make = (~friend: friend) => {
       })
     }
 
-    ChatAPI.subscribeToFriendStatus(friend.id, handleStatusChange); 
+    ChatAPI.subscribeToFriendStatus(friend.id, handleStatusChange);
     setState(_ => Loading);
 
     let cleanup = () => {
@@ -146,13 +146,13 @@ let make = (~friend: friend) => {
 
     Some(cleanup)
   })
-  
+
   let color = switch(state) {
     | Offline => "red"
     | Online => "green"
     | Loading => "grey"
   }
-  
+
   <li style={ReactDOMStyle.make(~color,())}>
       {React.string(friend.name)}
   </li>
@@ -182,7 +182,7 @@ function FriendListItem(Props) {
               }));
         return (function (param) {
                   unsubscribeFromFriendStatus(friend.id, handleStatusChange);
-                  
+
                 });
       });
   var color;
@@ -196,7 +196,7 @@ function FriendListItem(Props) {
     case /* Online */2 :
         color = "green";
         break;
-    
+
   }
   return React.createElement("li", {
               style: {
@@ -275,7 +275,7 @@ function useFriendStatus(friendId) {
               }));
         return (function (param) {
                   unsubscribeFromFriendStatus(friendId, handleStatusChange);
-                  
+
                 });
       });
   return match[0];
@@ -345,7 +345,7 @@ function FriendStatus(Props) {
     case /* Online */2 :
         color = "green";
         break;
-    
+
   }
   return React.createElement("li", {
               style: {
@@ -370,7 +370,7 @@ let make = (~friend: friend) => {
     | Online => "green"
     | Loading => "grey"
   }
-  
+
   <li style={ReactDOMStyle.make(~color,())}>
       {React.string(friend.name)}
   </li>
@@ -392,7 +392,7 @@ function FriendListItem(Props) {
     case /* Online */2 :
         color = "green";
         break;
-    
+
   }
   return React.createElement("li", {
               style: {
@@ -495,7 +495,7 @@ function Playground(Props) {
     case /* Online */2 :
         color = /* Green */1;
         break;
-    
+
   }
   var onChange = function (evt) {
     return Curry._1(setRecipientId, evt.target.value);
diff --git a/pages/docs/react/latest/hooks-effect.mdx b/pages/docs/react/latest/hooks-effect.mdx
diff --git a/pages/docs/react/latest/hooks-ref.mdx b/pages/docs/react/latest/hooks-ref.mdx
diff --git a/pages/docs/react/latest/refs-and-the-dom.mdx b/pages/docs/react/latest/refs-and-the-dom.mdx
diff --git a/src/SyntaxLookup.res b/src/SyntaxLookup.res
