It superficially looks like `@param` is supported in QLDoc, but this is mostly an accident of how its parser works. Attributes starting with `@` are only intended to be used in the top-level QLDoc of a query, and there can only be one of each attribute. If there are multiple `@param` entries, the QLDoc parser will only keep the first one. Even though `parseConvSpec` in `Scanf.qll` documented multiple parameters, only the first one would be shown in an IDE. The corresponding predicate in `Print.qll` documented only its first parameter, perhaps because of an autoformatting accident earlier in time. I've attempted to reconstruct documentation for its other parameters based on its sibling in `Scanf.qll`.
Semmle QL
This open source repository contains the standard QL libraries and queries that power LGTM, and the other products that Semmle makes available to its customers worldwide.
How do I learn QL and run queries?
There is extensive documentation on getting started with writing QL. You can use the interactive query console on LGTM.com or the QL for Eclipse plugin to try out your queries on any open-source project that's currently being analyzed.
Contributing
We welcome contributions to our standard library and standard checks. Do you have an idea for a new check, or how to improve an existing query? Then please go ahead and open a pull request! Before you do, though, please take the time to read our contributing guidelines. You can also consult our style guides to learn how to format your QL for consistency and clarity, how to write query metadata, and how to write query help documentation for your query.
License
The QL queries in this repository are licensed under Apache License 2.0 by Semmle.