<folders>

[Folder | Folders] {ALL | *{<folder path> [+<depth>] *[<item type>]}}

Specifies all folders in the view or specific folder paths, optionally indicating a folder depth and specific item types. The keyword Folder or (Folders) is optional unless the keyword ALL is used.

Usage

A valid <folder path> must begin and end with a forward slash (/src/com/). If provided, the <depth> specifies the number of child folder levels below the specified folder to include; it can be a number, or the keyword All.

  • If a folder path contains spaces, it must be inclosed in quotes.
  • If no <item type> parameters are provided, only files are included in the specified folder(s). Otherwise, all items of the specified item types are included.

Recognized item types are CRs, Files, Folders, Tasks, Topics, and Requirements (singular or plural).

Examples

Below are examples of <folder> usage:

// all folders in the view
include folders ALL

// all files in the folder /src/com/acme/ alone
include /src/com/acme/

// all files and tasks in  /src/ and below
include /src/ +all files tasks

// all CRs in the folder "/triage/" and all files in "/PR docs/"
// child folders two levels below it
include /triage/ CRs "/PR docs/" +2

By convention, the root folder is represented by a single "/". This means that the root folder name should not be provided in folder paths. For example, if the root folder is named "StarDraw", the folder path for the immediate child folder "Source Code" is simply /Source Code/.