Add @id to example queries

cpp/ql/examples/snippets/addressof.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/addressof
  * @name Address of reference variable
  * @description Finds address-of expressions (`&`) that take the address
  *              of a reference variable

cpp/ql/examples/snippets/arrayaccess.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/arrayaccess
  * @name Array access
  * @description Finds array access expressions with an index expression
  *              consisting of a postfix increment (`++`) expression.

cpp/ql/examples/snippets/castexpr.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/castexpr
  * @name Cast expressions
  * @description Finds casts from a floating point type to an integer type
  * @tags cast

cpp/ql/examples/snippets/catch_exception.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/catch-exception
  * @name Catch exception
  * @description Finds places where we catch exceptions of type `parse_error`
  * @tags catch

cpp/ql/examples/snippets/constructor_call.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/constructor-call
  * @name Call to constructor
  * @description Finds places where we call `new MyClass(...)`
  * @tags call

cpp/ql/examples/snippets/derives_from_class.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/derives-from-class
  * @name Class derives from
  * @description Finds classes that derive from `std::exception`
  * @tags base

cpp/ql/examples/snippets/emptyblock.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/emptyblock
  * @name Empty blocks
  * @description Finds empty block statements
  * @tags empty

cpp/ql/examples/snippets/emptythen.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/emptythen
  * @name If statements with empty then branch
  * @description Finds `if` statements where the `then` branch is
  *              an empty block statement

cpp/ql/examples/snippets/eq_true.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/eq-true
  * @name Equality test on boolean
  * @description Finds tests like `==true`, `!=true`
  * @tags equal

cpp/ql/examples/snippets/field_access.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/field-access
  * @name Access of field
  * @description Finds reads of `aDate` (defined on class `Order`)
  * @tags access

cpp/ql/examples/snippets/function_call.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/function-call
  * @name Call to function
  * @description Finds calls to `std::map<...>::find()`
  * @tags call

cpp/ql/examples/snippets/integer_literal.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/integer-literal
  * @name Integer literal
  * @description Finds places where we use the integer literal `2`
  * @tags integer

cpp/ql/examples/snippets/mutualrecursion.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/mutualrecursion
  * @name Mutual recursion
  * @description Finds pairs of functions that call each other
  * @tags function

cpp/ql/examples/snippets/override_method.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/override-method
  * @name Override of method
  * @description Finds methods that override `std::exception::what()`
  * @tags function

cpp/ql/examples/snippets/returnstatement.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/returnstatement
  * @name Return statements
  * @description Finds return statements that return `0`
  * @tags return

cpp/ql/examples/snippets/singletonblock.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/singletonblock
  * @name Singleton blocks
  * @description Finds block statements containing a single statement
  * @tags block

cpp/ql/examples/snippets/switchcase.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/switchcase
  * @name Switch statement case missing
  * @description Finds switch statements with a missing enum constant case
  *              and no default case

cpp/ql/examples/snippets/ternaryconditional.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/ternaryconditional
  * @name Conditional expressions
  * @description Finds conditional expressions of the form `... ? ... : ...`
  *              where the types of the resulting expressions differ

cpp/ql/examples/snippets/throw_exception.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/throw-exception
  * @name Throw exception of type
  * @description Finds places where we throw `parse_error` or one of its sub-types
  * @tags base

cpp/ql/examples/snippets/todocomment.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/todocomment
  * @name TODO comments
  * @description Finds comments containing the word "TODO"
  * @tags comment

cpp/ql/examples/snippets/toomanyparams.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/toomanyparams
  * @name Functions with many parameters
  * @description Finds functions or methods with more than 10 parameters
  * @tags function

cpp/ql/examples/snippets/unusedlocalvar.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/unusedlocalvar
  * @name Unused local variable
  * @description Finds local variables that are not accessed
  * @tags variable

cpp/ql/examples/snippets/unusedmethod.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/unusedmethod
  * @name Unused private method
  * @description Finds private non-virtual methods that are not accessed
  * @tags method

cpp/ql/examples/snippets/unusedparam.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/unusedparam
  * @name Unused parameter
  * @description Finds parameters that are not accessed
  * @tags parameter

cpp/ql/examples/snippets/voidreturntype.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/voidreturntype
  * @name Const method without return type
  * @description Finds const methods whose return type is `void`
  * @tags const

cpp/ql/examples/snippets/volatilevariable.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cpp/examples/volatilevariable
  * @name Variable declared volatile
  * @description Finds variables with a `volatile` modifier
  * @tags variable

csharp/ql/examples/snippets/array_access.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/array-access
  * @name Array access
  * @description Finds array access expressions with an index expression
  *              consisting of a unary increment or decrement, e.g. 'a[i++]'.

csharp/ql/examples/snippets/cast_expr.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/cast-expr
  * @name Cast expressions
  * @description Finds casts from a floating point type to an integer type.
  * @tags cast

csharp/ql/examples/snippets/catch_exception.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/catch-exception
  * @name Catch exception
  * @description Finds places where we catch exceptions of type 'System.IO.IOException'.
  * @tags catch

csharp/ql/examples/snippets/constructor_call.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/constructor-call
  * @name Call to constructor
  * @description Finds places where we call 'new System.Exception(...)'.
  * @tags call

csharp/ql/examples/snippets/empty_block.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/empty-block
  * @name Empty blocks
  * @description Finds empty block statements.
  * @tags empty

csharp/ql/examples/snippets/empty_then.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/empty-then
  * @name If statements with empty then branch
  * @description Finds 'if' statements where the 'then' branch is
  *              an empty block statement.

csharp/ql/examples/snippets/eq_true.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/eq-true
  * @name Equality test on Boolean
  * @description Finds tests like 'x==true', 'x==false', 'x!=true', '!=false'.
  * @tags equals

csharp/ql/examples/snippets/extend_class.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/extend-class
  * @name Class extends/implements
  * @description Finds classes/interfaces that extend/implement 'System.Collections.IEnumerator'.
  * @tags class

csharp/ql/examples/snippets/extern_method.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/extern-method
  * @name Extern methods
  * @description Finds methods that are 'extern'.
  * @tags method

csharp/ql/examples/snippets/field_read.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/field-read
  * @name Read of field
  * @description Finds reads of 'VirtualAddress' (defined on 'Mono.Cecil.PE.Section').
  * @tags field

csharp/ql/examples/snippets/integer_literal.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/integer-literal
  * @name Integer literal
  * @description Finds places where we use the integer literal '0'.
  * @tags integer

csharp/ql/examples/snippets/method_call.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/method-call
  * @name Call to method
  * @description Finds calls to method 'Company.Class.MethodName'.
  * @tags call

csharp/ql/examples/snippets/mutual_recursion.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/mutual-recursion
  * @name Mutual recursion
  * @description Finds pairs of methods that call each other.
  * @tags method

csharp/ql/examples/snippets/null_argument.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/null-argument
  * @name Add null to collection
  * @description Finds places where we add 'null' to a collection.
  * @tags null

csharp/ql/examples/snippets/override_method.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/override-method
  * @name Override of method
  * @description Finds methods that directly override 'Object.ToString'.
  * @tags method

csharp/ql/examples/snippets/qualifier.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/qualifier
  * @name Expression qualifier
  * @description Finds qualified expressions (e.g. 'a.b()') and their qualifiers ('a').
  * @tags qualifier

csharp/ql/examples/snippets/return_statement.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/return-statement
  * @name Return statements
  * @description Finds return statements that return 'null'.
  * @tags return

csharp/ql/examples/snippets/singleton_block.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/singleton-block
  * @name Singleton blocks
  * @description Finds block statements containing a single statement.
  * @tags block

csharp/ql/examples/snippets/switch_case.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/switch-case
  * @name Switch statement case missing
  * @description Finds switch statements with a missing enum constant case and no default case.
  * @tags switch

csharp/ql/examples/snippets/ternary_conditional.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/ternary-conditional
  * @name Conditional expressions
  * @description Finds conditional expressions of the form '... ? ... : ...'
  *              where the types of the resulting expressions differ.

csharp/ql/examples/snippets/throw_exception.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/throw-exception
  * @name Throw exception of given type
  * @description Finds places where we throw 'System.IO.IOException' or one of its subtypes.
  * @tags throw

csharp/ql/examples/snippets/todo_comment.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/todo-comment
  * @name TODO comments
  * @description Finds comments containing the word "TODO".
  * @tags comment

csharp/ql/examples/snippets/too_many_params.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/too-many-params
  * @name Methods with many parameters
  * @description Finds methods with more than ten parameters.
  * @tags method

csharp/ql/examples/snippets/try_finally.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/try-finally
  * @name Try-finally statements
  * @description Finds try-finally statements without a catch clause.
  * @tags try

csharp/ql/examples/snippets/unused_local_var.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/unused-local-var
  * @name Unused local variable
  * @description Finds local variables that are not accessed.
  * @tags variable

csharp/ql/examples/snippets/unused_param.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/unused-param
  * @name Unused parameter
  * @description Finds parameters that are not accessed.
  * @tags parameter

csharp/ql/examples/snippets/void_return_type.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/void-return-type
  * @name Methods without return type
  * @description Finds methods whose return type is 'void'.
  * @tags method

csharp/ql/examples/snippets/volatile_field.ql

@@ -1,4 +1,5 @@
 /**
+ * @id cs/examples/volatile-field
  * @name Fields declared volatile
  * @description Finds fields with a 'volatile' modifier.
  * @tags field

java/ql/examples/snippets/arrayaccess.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/arrayaccess
  * @name Array access
  * @description Finds array access expressions with an index expression
  *              consisting of a unary assignment

java/ql/examples/snippets/castexpr.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/castexpr
  * @name Cast expressions
  * @description Finds casts from a floating point type to an integer type
  * @tags cast

java/ql/examples/snippets/catch_exception.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/catch-exception
  * @name Catch exception
  * @description Finds places where we catch exceptions of type com.example.AnException
  * @tags catch

java/ql/examples/snippets/constructor_call.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/constructor-call
  * @name Call to constructor
  * @description Finds places where we call `new com.example.Class(...)`
  * @tags call

java/ql/examples/snippets/emptyblock.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/emptyblock
  * @name Empty blocks
  * @description Finds empty block statements
  * @tags empty

java/ql/examples/snippets/emptythen.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/emptythen
  * @name If statements with empty then branch
  * @description Finds 'if' statements where the 'then' branch is
  *              an empty block statement

java/ql/examples/snippets/eq_true.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/eq-true
  * @name Equality test on boolean
  * @description Finds tests like `==true`, `==false`, `!=true`, `!=false`
  * @tags equals

java/ql/examples/snippets/extend_class.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/extend-class
  * @name Class extends/implements
  * @description Finds classes/interfaces that extend/implement com.example.Class
  * @tags class

java/ql/examples/snippets/field_read.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/field-read
  * @name Read of field
  * @description Finds reads of aField (defined on com.example.Class)
  * @tags field

java/ql/examples/snippets/integer_literal.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/integer-literal
  * @name Integer literal
  * @description Finds places where we use the integer literal `0`
  * @tags integer

java/ql/examples/snippets/method_call.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/method-call
  * @name Call to method
  * @description Finds calls to com.example.Class.methodName
  * @tags call

java/ql/examples/snippets/mutualrecursion.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/mutualrecursion
  * @name Mutual recursion
  * @description Finds pairs of methods that call each other
  * @tags method

java/ql/examples/snippets/nativemethod.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/nativemethod
  * @name Native methods
  * @description Finds methods that are native
  * @tags method

java/ql/examples/snippets/null_argument.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/null-argument
  * @name Add null to collection
  * @description Finds places where we add null to a collection
  * @tags null

java/ql/examples/snippets/override_method.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/override-method
  * @name Override of method
  * @description Finds methods that override com.example.Class.baseMethod
  * @tags method

java/ql/examples/snippets/qualifiedthis.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/qualifiedthis
  * @name Qualified 'this' access
  * @description Finds 'this' accesses that are qualified by a type name
  * @tags this

java/ql/examples/snippets/returnstatement.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/returnstatement
  * @name Return statements
  * @description Finds return statements that return 'null'
  * @tags return

java/ql/examples/snippets/singletonblock.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/singletonblock
  * @name Singleton blocks
  * @description Finds block statements containing a single statement
  * @tags block

java/ql/examples/snippets/switchcase.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/switchcase
  * @name Switch statement case missing
  * @description Finds switch statements with a missing enum constant case and no default case
  * @tags switch

java/ql/examples/snippets/synchronizedmethod.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/synchronizedmethod
  * @name Synchronized methods
  * @description Finds methods that are synchronized
  * @tags method

java/ql/examples/snippets/ternaryconditional.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/ternaryconditional
  * @name Conditional expressions
  * @description Finds conditional expressions of the form '... ? ... : ...'
  *              where the types of the resulting expressions differ

java/ql/examples/snippets/throw_exception.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/throw-exception
  * @name Throw exception of type
  * @description Finds places where we throw com.example.AnException or one of its subtypes
  * @tags throw

java/ql/examples/snippets/todocomment.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/todocomment
  * @name TODO comments
  * @description Finds comments containing the word "TODO"
  * @tags comment

java/ql/examples/snippets/toomanyparams.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/toomanyparams
  * @name Methods with many parameters
  * @description Finds methods with more than ten parameters
  * @tags method

java/ql/examples/snippets/tryfinally.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/tryfinally
  * @name Try-finally statements
  * @description Finds try-finally statements without a catch clause
  * @tags try

java/ql/examples/snippets/unusedlocalvar.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/unusedlocalvar
  * @name Unused local variable
  * @description Finds local variables that are not accessed
  * @tags variable

java/ql/examples/snippets/unusedmethod.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/unusedmethod
  * @name Unused private method
  * @description Finds private methods that are not accessed
  * @tags method

java/ql/examples/snippets/unusedparam.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/unusedparam
  * @name Unused parameter
  * @description Finds parameters that are not accessed
  * @tags parameter

java/ql/examples/snippets/voidreturntype.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/voidreturntype
  * @name Methods without return type
  * @description Finds methods whose return type is 'void'
  * @tags method

java/ql/examples/snippets/volatilefield.ql

@@ -1,4 +1,5 @@
 /**
+ * @id java/examples/volatilefield
  * @name Fields declared volatile
  * @description Finds fields with a 'volatile' modifier
  * @tags field

javascript/ql/examples/snippets/argumentsparam.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/argumentsparam
  * @name Parameters called 'arguments'
  * @description Finds parameters called 'arguments'
  * @tags parameter

javascript/ql/examples/snippets/call.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/call
  * @name Calls to function
  * @description Finds function calls of the form `eval(...)`
  * @tags call

javascript/ql/examples/snippets/callback.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/callback
  * @name Callbacks
  * @description Finds functions that are passed as arguments to other functions
  * @tags function

javascript/ql/examples/snippets/classdefltctor.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/classdefltctor
  * @name Classes with a default constructor
  * @description Finds classes that do not declare an explicit constructor
  * @tags class

javascript/ql/examples/snippets/classname.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/classname
  * @name Classes called 'File'
  * @description Finds classes called 'File'
  * @tags class

javascript/ql/examples/snippets/constantbrackets.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/constantbrackets
  * @name Constant property name in `[]` property access
  * @description Finds property accesses using the square bracket notation
  *              where the property name is a constant string

javascript/ql/examples/snippets/emptyblock.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/emptyblock
  * @name Empty blocks
  * @description Finds empty block statements
  * @tags empty

javascript/ql/examples/snippets/emptythen.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/emptythen
  * @name If statements with empty then branch
  * @description Finds 'if' statements where the 'then' branch is
  *              an empty block statement

javascript/ql/examples/snippets/equalitystmt.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/equalitystmt
  * @name Equalities as expression statements
  * @description Finds `==` equality expressions that form an expression statement
  * @tags comparison

javascript/ql/examples/snippets/evenness.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/evenness
  * @name Tests for even numbers
  * @description Finds expressions of the form `e % 2 === 0`
  * @tags arithmetic

javascript/ql/examples/snippets/exportfn.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/exportfn
  * @name Default exports exporting a function
  * @description Finds 'default' exports that export a function
  * @tags module

javascript/ql/examples/snippets/filename.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/filename
  * @name File with given name
  * @description Finds files called `index.js`
  * @tags file

javascript/ql/examples/snippets/fnnoreturn.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/fnnoreturn
  * @name Functions without return statements
  * @description Finds functions that do not contain a return statement
  * @tags function

javascript/ql/examples/snippets/generator.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/generator
  * @name Generator functions
  * @description Finds generator functions
  * @tags generator

javascript/ql/examples/snippets/iife.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/iife
  * @name Immediately invoked function expressions
  * @description Finds calls of the form `(function(...) { ... })(...)`
  * @tags call

javascript/ql/examples/snippets/importfrom.ql

@@ -1,4 +1,5 @@
 /**
+ * @id js/examples/importfrom
  * @name Imports from 'react'
  * @description Finds import statements that import from module 'react'
  * @tags module