<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/.