@teambit/harmony.content.cli-reference 1.95.32 → 1.95.35

package/dist/cli-reference.mdx.js

@@ -119,7 +119,7 @@ function MDXContent(_ref) {
   }, "-t")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "specify test files to track. use quotation marks to list files or use a glob pattern")), (0, _react2.mdx)("tr", {
+  }, "LEGACY ONLY. specify test files to track. use quotation marks to list files or use a glob pattern")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -149,7 +149,7 @@ function MDXContent(_ref) {
   }, "-e")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "exclude file from being tracked. use quotation marks to list files or use a glob pattern")), (0, _react2.mdx)("tr", {
+  }, "LEGACY ONLY. exclude file from being tracked. use quotation marks to list files or use a glob pattern")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -243,7 +243,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", "and a package.tgz file generated by pkg aspect."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit artifacts <pattern...>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit artifacts <component-pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -330,23 +330,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "aspect list [pattern]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list all aspects configured on component(s)", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "you can use a ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit aspect list \"org.scope/utils/**\""), ".", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "use ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern --help"), " to understand patterns better and ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern <pattern>"), " to validate the pattern."), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": list all aspects configured on component(s)"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -386,9 +370,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "aspect get <component-id>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "aspect get <component-name>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": show aspects' data and configuration of the given component"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": list the aspects set on a component, as well as their config and data"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -445,82 +429,19 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "aspect set <pattern> <aspect-id> [config]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": set an aspect to component(s) with optional config.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "enter the config as stringified JSON (e.g. '{\"foo\":\"bar\"}' ).", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "if no config entered, the aspect will be set with empty config ({}).", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "you can use a ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit aspect set \"org.scope/utils/**\""), ".", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "use ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern --help"), " to understand patterns better and ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern <pattern>"), " to validate the pattern."), (0, _react2.mdx)("h3", null, "aspect unset"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": set components with an aspect to extend their development tools, metadata and (possibly) artifacts"), (0, _react2.mdx)("h3", null, "aspect unset"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "aspect unset <pattern> <aspect-id>")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": unset an aspect from component(s).", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "you can use a ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit aspect unset \"org.scope/utils/**\""), ".", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "use ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern --help"), " to understand patterns better and ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern <pattern>"), " to validate the pattern."), (0, _react2.mdx)("h3", null, "aspect update"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": unset an aspect from component(s)."), (0, _react2.mdx)("h3", null, "aspect update"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "aspect update <aspect-id> [pattern]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": update a version of an aspect", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "default to all components using the aspect, unless \"pattern\" is provided.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "you can use a ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit aspect update <aspect-id> \"org.scope/utils/**\""), ".", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "use ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern --help"), " to understand patterns better and ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern <pattern>"), " to validate the pattern."), (0, _react2.mdx)("p", null, "examples:", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "\"bit aspect update scope.org/aspect '", (0, _react2.mdx)("strong", {
-    parentName: "p"
-  }, "/ui/"), "'\" - update \"ui\" components that use scope.org/aspect to the latest version", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "\"bit aspect update scope.org/", (0, _react2.mdx)("a", {
-    parentName: "p",
-    "href": "mailto:aspect@2.0.0"
-  }, "aspect@2.0.0"), "\" - updates all components using scope.org/aspect to version 2.0.0."), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "Description"), ": update a version of an aspect"), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "build"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Workspace only"), ": yes", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -663,7 +584,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Description"), ": manage capsules", (0, _react2.mdx)("br", {
     parentName: "p"
-  }), "\n", "a capsule is a directory contains the component code, isolated from the workspace.", (0, _react2.mdx)("br", {
+  }), "\n", "a capsule is a directory containing the component code, isolated from the workspace.", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "normally, capsules are created during the build process, the component files are copied and the packages are installed", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -677,7 +598,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "capsule list")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": list all capsules"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": list the capsules generated for this workspace"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -717,9 +638,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }, "Usage"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "capsule create [componentIds...]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "capsule create [component-id...]")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": create capsules"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "Description"), ": create capsules for components"), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -1641,6 +1562,21 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
+  }, "--tree")), (0, _react2.mdx)("td", {
+    parentName: "tr",
+    "align": "center"
+  }, (0, _react2.mdx)("inlineCode", {
+    parentName: "td"
+  }, "-t")), (0, _react2.mdx)("td", {
+    parentName: "tr",
+    "align": null
+  }, "render dependencies as a tree, similar to \"npm ls\"")), (0, _react2.mdx)("tr", {
+    parentName: "tbody"
+  }, (0, _react2.mdx)("td", {
+    parentName: "tr",
+    "align": null
+  }, (0, _react2.mdx)("inlineCode", {
+    parentName: "td"
   }, "--debug")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
@@ -1711,7 +1647,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": show diff between components files", (0, _react2.mdx)("br", {
+  }, "Description"), ": show the diff between the components' source files and config", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", "bit diff => compare all modified components to their model version", (0, _react2.mdx)("br", {
     parentName: "p"
@@ -1858,25 +1794,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": replaces the components from the local scope with the corresponding packages", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "you can use a ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "<pattern>"), " for multiple component ids, such as ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit eject \"org.scope/utils/**\""), ".", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "use comma to separate patterns and \"!\" to exclude. e.g. \"ui/", "*", "*", ", !ui/button\"", (0, _react2.mdx)("br", {
+  }, "Description"), ": replace components maintained in the workspace with their corresponding packages"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }), "\n", "always wrap the pattern with quotes to avoid collision with shell commands.", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "use ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern --help"), " to understand patterns better and ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit pattern <pattern>"), " to validate the pattern."), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit eject <pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit eject <component-pattern>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -2245,7 +2165,7 @@ function MDXContent(_ref) {
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "HARMONY ONLY. avoid export to the central hub, instead, export directly to the original scopes. not recommended!")), (0, _react2.mdx)("tr", {
+  }, "EXPERIMENTAL. avoid export to the central hub, instead, export directly to the original scopes. not recommended!")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -3142,14 +3062,14 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": link components and core aspects", (0, _react2.mdx)("br", {
+  }, "Description"), ": create links in the node_modules directory, to core aspects and to components in the workspace", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("a", {
     parentName: "p",
     "href": "https://bit.dev/docs/workspace/component-links"
   }, "https://bit.dev/docs/workspace/component-links")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit link [ids...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit link [component-names...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -3524,7 +3444,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": log the CLI into Bit Cloud"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": log in to Bit cloud"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit login")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -3608,7 +3528,7 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--machine-name <string>")), (0, _react2.mdx)("td", {
+  }, "--machine-name <name>")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }), (0, _react2.mdx)("td", {
@@ -3790,7 +3710,7 @@ function MDXContent(_ref) {
     "href": "https://bit.dev/docs/workspace/moving-components"
   }, "https://bit.dev/docs/workspace/moving-components")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit move <existing-dir> <new-dir>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit move <current-component-dir> <new-component-dir>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -3826,7 +3746,7 @@ function MDXContent(_ref) {
   }, "-c")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "move component files that are spread over multiple directories to one directory. synopsis: ", (0, _react2.mdx)("inlineCode", {
+  }, "LEGACY ONLY. move component files that are spread over multiple directories to one directory. synopsis: ", (0, _react2.mdx)("inlineCode", {
     parentName: "td"
   }, "move <component-id> <directory>"))))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "new"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
@@ -4281,7 +4201,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": remove component(s) from your workspace, or a remote scope", (0, _react2.mdx)("br", {
+  }, "Description"), ": remove component(s) from the workspace, or a remote scope", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("a", {
     parentName: "p",
@@ -4290,7 +4210,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", "you can use a pattern for multiple ids, such as bit remove \"utils/", "*", "\". (wrap the pattern with quotes to avoid collision with shell commands)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit remove <ids...>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit remove <component-ids...>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -4341,7 +4261,7 @@ function MDXContent(_ref) {
   }, "-t")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "keep tracking component (default = false)")), (0, _react2.mdx)("tr", {
+  }, "keep tracking component in .bitmap (default = false), helps transform a tagged-component to new")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -4405,15 +4325,9 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": EXPERIMENTAL. rename component. if tagged/exported, create a new component and deprecate the source-component", (0, _react2.mdx)("br", {
-    parentName: "p"
-  }), "\n", "the ", (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "<target-name>"), " should include the component-name only, without the scope-name.", (0, _react2.mdx)("br", {
+  }, "Description"), ": EXPERIMENTAL. rename component. if tagged/exported, create a new component and deprecate the original component"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }), "\n", "to assign a default-scope to this component, please use \"--scope\" flag"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
-    parentName: "p"
-  }, "bit rename <source-name> <target-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit rename <current-name> <new-name>")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -4441,7 +4355,7 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--scope <string>")), (0, _react2.mdx)("td", {
+  }, "--scope <scope-name>")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }, (0, _react2.mdx)("inlineCode", {
@@ -4456,7 +4370,7 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--path <string>")), (0, _react2.mdx)("td", {
+  }, "--path <relative-path>")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }, (0, _react2.mdx)("inlineCode", {
@@ -4481,7 +4395,7 @@ function MDXContent(_ref) {
   }, "-r")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "change the source code of all components using this component with the new package-name")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "run"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
+  }, "update the import/require statements in all dependent components (in the same workspace)")))), (0, _react2.mdx)("hr", null), (0, _react2.mdx)("h2", null, "run"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("strong", {
     parentName: "p"
   }, "Alias"), ": ", (0, _react2.mdx)("inlineCode", {
     parentName: "p"
@@ -5028,7 +4942,7 @@ function MDXContent(_ref) {
     "href": "https://bit.dev/components/tags"
   }, "https://bit.dev/components/tags")), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit tag [patterns...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit tag [component-patterns...]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5181,26 +5095,28 @@ function MDXContent(_ref) {
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--snapped")), (0, _react2.mdx)("td", {
+  }, "--pre-release [identifier]")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "EXPERIMENTAL. tag components that their head is a snap (not a tag)")), (0, _react2.mdx)("tr", {
+  }, "syntactic sugar for \"--increment prerelease\" and ", (0, _react2.mdx)("inlineCode", {
+    parentName: "td"
+  }, "--prerelease-id <identifier>"))), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
   }, (0, _react2.mdx)("inlineCode", {
     parentName: "td"
-  }, "--pre-release [identifier]")), (0, _react2.mdx)("td", {
+  }, "--snapped")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": "center"
   }), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "DEPRECATED. use \"-l prerelease\" (and --prerelease-id) instead")), (0, _react2.mdx)("tr", {
+  }, "EXPERIMENTAL. tag components that their head is a snap (not a tag)")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",
@@ -5552,7 +5468,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": revert versions tagged for component(s)", (0, _react2.mdx)("br", {
+  }, "Description"), ": revert tagged or snapped versions for component(s)", (0, _react2.mdx)("br", {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("a", {
     parentName: "p",
@@ -5561,7 +5477,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", "you can use a pattern for multiple ids, such as bit untag \"utils/", "*", "\". (wrap the pattern with quotes to avoid collision with shell commands)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
-  }, "bit untag [id] [version]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
+  }, "bit untag [component-name] [component-version]")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
   }, (0, _react2.mdx)("tr", {
     parentName: "thead"
@@ -5689,7 +5605,7 @@ function MDXContent(_ref) {
     parentName: "p"
   }), "\n", (0, _react2.mdx)("strong", {
     parentName: "p"
-  }, "Description"), ": watch a set of components"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
+  }, "Description"), ": automatically recompile modified components (on save)"), (0, _react2.mdx)("p", null, (0, _react2.mdx)("inlineCode", {
     parentName: "p"
   }, "bit watch")), (0, _react2.mdx)("table", null, (0, _react2.mdx)("thead", {
     parentName: "table"
@@ -5727,7 +5643,7 @@ function MDXContent(_ref) {
   }, "-v")), (0, _react2.mdx)("td", {
     parentName: "tr",
     "align": null
-  }, "showing npm verbose output for inspection and prints stack trace")), (0, _react2.mdx)("tr", {
+  }, "show npm verbose output for inspection and print the stack trace")), (0, _react2.mdx)("tr", {
     parentName: "tbody"
   }, (0, _react2.mdx)("td", {
     parentName: "tr",