mirror of
https://gitlab.winehq.org/wine/wine-gecko.git
synced 2024-09-13 09:24:08 -07:00
6ef77f05f6
This patch adds UseCounter.conf for defining use counters along with infrastructure to generate enums and telemetry identifiers from UseCounter.conf.
34 lines
1.4 KiB
Plaintext
34 lines
1.4 KiB
Plaintext
// This Source Code Form is subject to the terms of the Mozilla Public
|
|
// License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
|
|
// This file defines a list of use counters, which are things that can
|
|
// record usage of Web platform features and then report this information
|
|
// through Telemetry.
|
|
//
|
|
// The format of this file is very strict. Each line can be:
|
|
//
|
|
// (a) a blank line
|
|
//
|
|
// (b) a comment, which is a line that begins with "//"
|
|
//
|
|
// (c) an #if/ifdef/else/endif preprocessor directive
|
|
//
|
|
// (d) one of three possible use counter declarations:
|
|
//
|
|
// method <IDL interface name>.<IDL operation name>
|
|
// attribute <IDL interface name>.<IDL attribute name>
|
|
// property <CSS property name>
|
|
//
|
|
// To actually cause use counters to be incremented, DOM methods
|
|
// and attributes must have a [UseCounter] extended attribute in
|
|
// the Web IDL file, and CSS properties must be declared with
|
|
// the CSS_PROPERTY_HAS_USE_COUNTER flag in nsCSSPropList.h.
|
|
//
|
|
// You might reasonably ask why we have this file and we require
|
|
// annotating things with [UseCounter] in the relevant WebIDL file as
|
|
// well. Generating things from bindings codegen and ensuring all the
|
|
// dependencies were correct would have been rather difficult, and
|
|
// annotating the WebIDL files does nothing for identifying CSS
|
|
// property usage, which we would also like to track.
|