summaryrefslogtreecommitdiffstats
path: root/docs
AgeCommit message (Collapse)Author
2021-05-01update the version available through Chocolateymjarosie
2021-05-01Re-apply patch from ff8924ce16e58f to dev manualAleksey Tsalolikhin
2021-05-01Remove decimal number text from v1.6 manualAleksey Tsalolikhin
2020-12-18Fix #2197 extended regex pattern exampleAlexandre Jasmin
2020-06-08Add some missing code quoting to the manualMaximilian Roos
2020-03-02Minor fixes to website generationWilliam Langford
2020-03-02Change Homebrew version in docs to 1.6Gustav
2020-01-14fix typosAlanscut
2020-01-07Add information on how to install on OS X with MacPortsBernard Niset
2020-01-07docs: --indent value has maximum of 7, not 8William Chargin
Test Plan: To verify that this is in fact the behavior: ``` $ jq --indent 7 -n '[1]' [ 1 ] $ jq --indent 8 -n '[1]' jq: --indent takes a number between -1 and 7 Use jq --help for help with command-line options, or see the jq manpage, or online docs at https://stedolan.github.io/jq ``` This patch was generated by running `git grep "no more than"` and fixing up appropriate results. wchargin-branch: docs-fix-indent-bounds
2020-01-03outputing -> outputtingAlanscut
2020-01-02Update other manual and source to use ;37David Biesack
2020-01-02correct the default JQ_COLORS to use 37, not undefined color 39David Biesack
2020-01-02fix typosAlanscut
2019-12-30Add -0 / --nul-output option for processing values containing newlinesPaul Wise
Closes: https://github.com/stedolan/jq/issues/1271
2019-12-29Rephrase doc "A string B is contained in A" ...Felix Wolfsteller
Minor rephrasing to prevent read/brain backtracking when using capital letter A as an article and a variable term.
2019-10-22Save literal value of the parsed number to preserve it for the outputLeonid S. Usov
Extend jv_number to use decNumber for storing number literals. Any math operations on the numbers will truncate them to double precision. Comparisons when both numbers are literal numbers will compare them without truncation. Delay conversion of numbers to doubles until a math operation is performed, to preserve precision. A literal jv_number will only need conversion to double once, and will reuse the resultant double on subsequent conversions. Outputting literal jv_numbers preserves the original precision. Add strong pthread requirement to manage contexts/allocations for converting numbers between their decNumber, string, and double formats.
2019-10-22Add decNumber libraryLeonid S. Usov
The library adds support for decimal numbers of arbitrary length. Downloaded from ICU, under ICU 1.8.1 license http://download.icu-project.org/files/decNumber/decNumber-icu-368.zip
2019-07-21docs: fix seriously dangerous download instructions for Arch LinuxEli Schwartz
The current instructions tell users to perform two actions: - update the package database - install the jq package The only thing users need to or should be doing is actually installing the jq package -- regardless of which version is being installed. Guidelines on how to perform system updates are massively out of scope. In the case of partially performing a system update as a prerequisite for installing jq, the official guidance from Arch Linux is not to do this: partial updates are not supported, we refuse to support them, and anyone who does try to perform them anyway is assumed to know so much about their system that they clearly do not ever need help from anyone else (which is a good thing since they won't get it). The result is a frankensteined system that can only ever be supported by the person who frankensteined it to begin with. The only reason the package manager even allows it to occur in the first place is because other distributions using pacman might have different LTS policies, and because it would prevent expert users from being in control of their system, as per the traditional Unix philosophy: "Unix was not designed to stop you from doing stupid things, because that would also stop you from doing clever things." Consequences of performing partial updates without understanding the ramifications in extensive detail can include breaking the partially updated application (jq), breaking any application that shares a mutual dependency with the partially updated application (which jq is *lucky* to only depend on the ever-backwards-compatible glibc), or breaking the entire operating system by leaving armed traps behind for the next time a `pacman -S new-package` is executed and thereby breaks *its* cascading dependencies. See: https://wiki.archlinux.org/index.php/System_maintenance#Partial_upgrades_are_unsupported
2019-07-08clarify filter usageHelmut K. C. Tessarek
The current paragraph is not complete, since a digit is not a special character. Changing it to: If the key contains special characters or starts with a digit, you need to surround it with double quotes like this: `."foo$"`, or else `.["foo$"]`.
2019-03-24Add -b / --binary option for WindowsNicolas Williams
2019-02-26Cleanup leftover references to rubyWilliam Langford
2019-02-26Remove ruby dependency from mantestsWilliam Langford
2019-02-26Remove ruby dependency from manpage buildWilliam Langford
2019-02-26Remove ruby dependency from website buildWilliam Langford
2019-02-20Fix if-then-else example formattingNicolas Williams
2019-02-20Document optional `else` clause of `if`Nicolas Williams
2019-02-07FIX if-then-else exampleMatt Clegg
"(.+)" doesn't match new line characters so the link generated for [if-then-else](https://github.com/stedolan/jq/blob/90bc29c1b544c0436ec44246e180fdbb6d6384df/docs/content/3.manual/v1.5/manual.yml#L1804) doesn't work
2019-01-05Merge pull request #1774 from dooglus/patch-1William Langford
Fix grammar typo.
2018-12-10Allow variable refs as object keys {$key:value}Nicolas Williams
Users are often surprised by the requirement to parenthesize any non-trivial object key expressions in object constructors. E.g., {"a"+"b":1}. This commit adds one more kind of key expression besides literals and idents: variable references. A common use case for this is jq programs as JSON templates to fill in with variables computed from inputs or passed in on the command-line. E.g., {some_key:$value}. Now users can also use, e.g., {$key:$value}. This and the restrictions on key and value expressions in object constructors are now clarified a bit in the documentation.
2018-11-29Fix grammar typo.Chris Moore
'operator' needs to be plural here.
2018-11-02Minor website fixes for 1.6William Langford
2018-11-01Update website with details for jq-1.6William Langford
2018-10-21Fix website whitespaceWilliam Langford
2018-10-21Add documentation for destructuring alternationWilliam Langford
2018-02-23Fix "provides" typoRiley Avron
2018-01-04fix FreeBSD install instructionsPaul Chvostek
2017-12-11Added rawfileDavid Fetter
In passing, clean remnants of argfile from slurpfile docs.
2017-12-11Revert "reduce: handle empty updates (fix #1313)"Nicolas Williams
This reverts commit e24af3c78e78a3aab05a2800d825d56f1d842b1b. While the semantics are desirable, there is no way to implement them efficiently. The reason is that in order to handle backtracking (empty) from the state update expression, we have to retain a reference to the reduction state value in order to restore it upon backtracking. Retaining a reference to the reduction state kills performance by causing lots of additional memory allocations and garbage because the input to the update expression will always have at least two references, thus no changes to it can be done in-place, and all changes end up being CoW changes. Avoiding this is the very reason for the LOADVN instruction (leaving `null` in the variable loaded from).
2017-11-29Actually fix the strptime testsmacos-strptimeWilliam Langford
This has been a complicated issue to fix for a number of reasons. The core of it is that the behavior is different between different versions of macOS, some of which set possible-but-incorrect values. This commit addresses the issue by always using our computation for tm_wday and tm_yday on macOS. As a side-effect, strptime format strings that specify %u and %j will no longer work on macOS.
2017-11-22Typo correctiontrantor
Suppresion -> Suppression
2017-05-21Deal with strptime() on OS X and *BSD (fix #1415)Nicolas Williams
strptime() on OS X and *BSDs (reputedly) does not set tm_wday and tm_yday unless corresponding %U and %j format specifiers were used. That can be... surprising when one parsed year, month, and day anyways. Glibc's strptime() conveniently sets tm_wday and tm_yday in those cases, but OS X's does not, ignoring them completely. This commit makes jq compute those where possible, though the day of week computation may be wrong for dates before 1900-03-01 or after 2099-12-31.
2017-04-29Add JQ_COLORS env var for color config (fix #1252)Nico Williams
2017-04-15def isempty(g) # Testing 'isempty(empty)' at line number 1364pkoppstein
2017-03-31Don't require java to build gh-pagesWilliam Langford
2017-03-31Add collect example with pipelineWilliam Langford
2017-03-30Add missing close-backtick in docsWilliam Langford
2017-02-26Add `halt`, `halt_error` builtins (fix #386)Nicolas Williams
2017-02-26Document `stderr`Nicolas Williams
2017-02-26Add $ENV builtin variable to access environmentNicolas Williams