1 # This file is ingested by `ThreadAllows.py` to produce a list of thread names
2 # which our clang plugin will allow to be used with `NS_NewNamedThread`.
4 # Permitted thread names are a maximum of 15 characters in length, and must be
5 # string literals at their point-of-use in the code -- i.e., in the invocation
6 # of `NS_NewNamedThread`.
8 # Within this file, each permitted thread name is on a separate line. Comments
9 # begin with `#`, as seen here. Leading and trailing whitespace, trailing
10 # comments, and blank lines are ignored, and may be used freely.
12 # Please explain the addition of any new thread names in comments, preferably
13 # with a pointer to a relevant bug. (Do not add thread names only used in tests
14 # to this file; instead, add the test file to `ThreadFileAllows.txt`.)
17 # Gecko/Firefox thread names
19 # (None documented yet -- but see "Unsorted thread names", below.)
22 # Thunderbird-only thread names
27 Checker Test # used only as part of tests for the thread-checker itself
30 # Unsorted thread names
32 # Thread names below this point are grandfathered in. Please do not add new
33 # thread names to this list -- and please remove any that you can, whether by
34 # documenting and moving them or by confirming that they are no longer required.
36 # In particular, if a thread name is only used for testing, please consider
37 # moving its declarator to `ThreadFileAllows.txt`.