Home (original) (raw)
This wiki provides supplementary documentation about jq.
Note: jq version 1.8.0 introduced a potentially serious performance issue #3345. The issue was addressed in the subsequent release, 1.8.1.
If you want to learn to use jq, please head to the jq home page. There you will find an overview, a tutorial, and a manual. Here you will find supplementary documentation, notably the jq Language Description, which provides a more technical introduction to jq than the manual.
The documentation on this wiki is currently structured as the_Sidebar_ menu (shown at the bottom in small screens) presents. Newcomers may find the following especially helpful:
- FAQ
- Install jq
- jq Language Description
- jq Cookbook
- Advanced Topics
- jq Internals
- Awesome jq - list of awesome jq tools and resources↗
Users should also peruse the Pitfalls page.
As a rule, the documentation here follows the convention that:
- official releases are referred to in the m.n format (e.g. 1.3, 1.4);
- a version number such as 1.4+ means a (sufficiently recent) version after 1.4.
This wiki is currently open for editing by anyone with a GitHub login. Welcome!