nix-super/src
Jason Yundt a5959aa121
docs: specify that flake.lock files are JSON (#11594)
* docs: specify that flake.lock files are JSON

Recently, I decided that I was going to write some code that would parse
flake.lock files. I went to the Nix Reference Manual in order to look up
information on the format of flake.lock files, and I realized that a key
detail was missing from the Nix Reference Manual: it never says that
flake.lock files are JSON files. This commit fixes that issue.

This commit makes sure to specify that flake.lock files are encoded in
UTF-8. Confusingly, there’s multiple different JSON standards. Neither
ECMA-404, 2nd Edition [1] nor ISO/IEC 21778:2017 [2] mention UTF-8. RFC
8259 requires UTF-8, but only sometimes [3]. I chose to explicitly
specify that flake.lock files are UTF-8 in order to avoid any possible
ambiguities from the JSON standards.

[1]: <https://ecma-international.org/publications-and-standards/standards/ecma-404>
[2]: <https://www.iso.org/standard/71616.html>
[3]: <https://www.rfc-editor.org/rfc/rfc8259.html#section-8.1>
2024-09-26 00:21:33 +00:00
..
build-remote build-remote: only allocate storeUri once 2024-07-25 14:04:03 +02:00
external-api-docs Deduplicate our many package.nix a bit (#11175) 2024-07-25 03:12:39 +00:00
internal-api-docs Deduplicate our many package.nix a bit (#11175) 2024-07-25 03:12:39 +00:00
libcmd Add a few more aliases 2024-09-19 21:04:01 +02:00
libexpr Fix build without GC 2024-09-20 15:01:32 +02:00
libexpr-c Fix warning 2024-09-20 15:08:45 +02:00
libfetchers Ensure error messages don't leak private key 2024-09-23 16:36:48 -04:00
libflake Formatting 2024-09-11 20:35:04 +02:00
libmain fix: Avoid deadlock in ProgressBar::redraw() 2024-09-08 11:44:24 +02:00
libmain-c Deduplicate our many package.nix a bit (#11175) 2024-07-25 03:12:39 +00:00
libstore Merge pull request #11585 from NixOS/verify-tls 2024-09-25 23:52:25 +02:00
libstore-c Add nix_store_copy_closure to libstore-c 2024-08-23 12:49:39 +03:00
libutil Ensure error messages don't leak private key 2024-09-23 16:36:48 -04:00
libutil-c Merge pull request #10910 from hercules-ci/c-api-nix_clear_err 2024-08-26 10:50:26 -04:00
nix docs: specify that flake.lock files are JSON (#11594) 2024-09-26 00:21:33 +00:00
nix-build fix: check to see if there are any lines before 2024-08-18 22:35:54 -04:00
nix-channel Don't use OS_STR in nix-channel.cc 2024-08-18 18:27:20 +05:30
nix-collect-garbage More std::filesystem for nix-collect-garbage 2024-08-26 17:29:23 -04:00
nix-copy-closure Restrict some code to StoreDirConfig 2023-11-04 19:05:36 -04:00
nix-env Use std::strong_ordering for version comparison 2024-07-30 18:13:05 -07:00
nix-instantiate No global settings in libnixfetchers and libnixflake 2024-07-12 08:50:28 -04:00
nix-store Make abort() call sites log first 2024-07-24 16:52:04 +02:00
perl Move NIX_BIN_DIR and all logic using it to the Nix executable itself 2024-08-12 12:29:17 -04:00
nix-expr-test-support Put back files for now 2024-07-02 09:26:22 -04:00
nix-expr-tests Put back files for now 2024-07-02 09:26:22 -04:00
nix-fetchers-tests Put back files for now 2024-07-02 09:26:22 -04:00
nix-flake-tests Put back files for now 2024-07-02 09:26:22 -04:00
nix-functional-tests Build Functional tests with Meson 2024-08-14 15:35:40 -04:00
nix-store-test-support Put back files for now 2024-07-02 09:26:22 -04:00
nix-store-tests Put back files for now 2024-07-02 09:26:22 -04:00
nix-util-test-support Put back files for now 2024-07-02 09:26:22 -04:00
nix-util-tests Put back files for now 2024-07-02 09:26:22 -04:00