File: comments.md

package info (click to toggle)
node-stylus 0.48.1%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 4,196 kB
  • ctags: 766
  • sloc: makefile: 38
file content (39 lines) | stat: -rw-r--r-- 849 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
---
layout: default
permalink: docs/comments.html
---

# Comments

  Stylus supports three kinds of comments: single-line, and multi-line comments, and multi-line buffered comments.

## Single-line

  Single-line comments look like JavaScript comments, and do not output in the resulting CSS:

    // I'm a comment!
    body
      padding 5px // some awesome padding

## Multi-line

   Multi-line comments look identical to regular CSS comments. However, they only output when the `compress` option is not enabled.

    /*
     * Adds the given numbers together.
     */
    
    add(a, b)
      a + b

## Multi-line buffered

   Multi-line comments which are not suppressed start with `/*!`. This tells Stylus to output the comment regardless of compression.

    /*!
     * Adds the given numbers together.
     */
    
    add(a, b)
      a + b