Actualizacion maquina principal

[dotfiles/.git] / .config / coc / extensions / node_modules / coc-prettier / node_modules / stylelint / lib / rules / comment-empty-line-before / README.md

diff --git a/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/comment-empty-line-before/README.md b/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/comment-empty-line-before/README.md
new file mode 100644 (file)
index 0000000..5348750
--- /dev/null
+++ b/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/comment-empty-line-before/README.md
@@ -0,0 +1,153 @@
+# comment-empty-line-before
+
+Require or disallow an empty line before comments.
+
+```css
+a {}
+              /* ← */
+/* comment */ /* ↑ */
+/**              ↑
+*        This line */
+```
+
+If the comment is the very first node in a stylesheet then it is ignored. Shared-line comments are also ignored.
+
+If you're using a custom syntax which support single-line comments with `//`, those are ignored as well.
+
+**Caveat:** Comments within *selector and value lists* are currently ignored.
+
+The `--fix` option on the [command line](../../../docs/user-guide/cli.md#autofixing-errors) can automatically fix all of the problems reported by this rule. We recommend to enable [`indentation`](../indentation/README.md) rule for better autofixing results with this rule.
+
+## Options
+
+`string`: `"always"|"never"`
+
+### `"always"`
+
+There *must always* be an empty line before comments.
+
+The following patterns are considered violations:
+
+```css
+a {}
+/* comment */
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a {}
+
+/* comment */
+```
+
+```css
+a {} /* comment */
+```
+
+### `"never"`
+
+There *must never* be an empty line before comments.
+
+The following patterns are considered violations:
+
+```css
+a {}
+
+/* comment */
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a {}
+/* comment */
+```
+
+```css
+a {} /* comment */
+```
+
+## Optional secondary options
+
+### `except: ["first-nested"]`
+
+Reverse the primary option for comments that are nested and the first child of their parent node.
+
+For example, with `"always"`:
+
+The following patterns are considered violations:
+
+```css
+a {
+
+  /* comment */
+  color: pink;
+}
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a {
+  /* comment */
+  color: pink;
+}
+```
+
+### `ignore: ["after-comment", "stylelint-commands"]`
+
+#### `"after-comment"`
+
+Don't require an empty line after a comment.
+
+For example, with `"always"`:
+
+The following patterns are *not* considered violations:
+
+```css
+a {
+  background: pink;
+
+  /* comment */
+  /* comment */
+  color: #eee;
+}
+```
+
+```css
+a {
+  background: pink;
+
+  /* comment */
+
+  /* comment */
+  color: #eee;
+}
+```
+
+#### `"stylelint-commands"`
+
+Ignore comments that deliver commands to stylelint, e.g. `/* stylelint-disable color-no-hex */`.
+
+For example, with `"always"`:
+
+The following patterns are considered violations:
+
+```css
+a {
+  background: pink;
+  /* not a stylelint command */
+  color: #eee;
+}
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a {
+  background: pink;
+  /* stylelint-disable color-no-hex */
+  color: pink;
+}
+```