# priority

## Synopsis

    priority <number>

## Description

Explicitly sets the priority of a class or display class. Display classes are always considered first, regardless of the priorities of ordinary classes, however they do not affect defragmentation (in the example below, the file `/foobar` would be highlighted red if it was fragmented, despite the display class having a lower priority).

We generally recommend that you avoid using this feature, as it makes the class set definitions harder to read (for a human being, that is). If you do use it, we suggest choosing a fairly high number as a starting point (say 1,000); it may also be useful to go up in increments of (say) 10 units, so that class definitions can be inserted by including another file.

Note that numerically lower priority values correspond to higher priorities; that is, priority 0 is the highest, followed by 1, 2 and so on.

## Example

    // Highlight fragmented files in red

    display class "Fragmented" {
      match files where file is fragmented
      color "#ff0000"
      priority 100000
    }

    // Matches all files in the root directory whose names start with the letters "foo"

    class "Foo" {
      match files where name ~= "/foo.*"
      color "#00ff00"
      priority 1000
    }

    // Matches the file "/foobar", despite the class definition above

    class "Foobar" {
      match files where name = "/foobar"
      color "#0000ff"
      priority 900
    }

## See also

class, display class