nix-super/src/nix/flake-update.md

R""(

# Examples

* Recreate the lock file (i.e. update all inputs) and commit the new
  lock file:

  ```console
  # nix flake update --commit-lock-file
  * Updated 'nix': 'github:NixOS/nix/9fab14adbc3810d5cc1f88672fde1eee4358405c' -> 'github:NixOS/nix/8927cba62f5afb33b01016d5c4f7f8b7d0adde3c'
  * Updated 'nixpkgs': 'github:NixOS/nixpkgs/3d2d8f281a27d466fa54b469b5993f7dde198375' -> 'github:NixOS/nixpkgs/a3a3dda3bacf61e8a39258a0ed9c924eeca8e293'
  …
  warning: committed new revision '158bcbd9d6cc08ab859c0810186c1beebc982aad'
  ```

# Description

This command recreates the lock file of a flake (`flake.lock`), thus
updating the lock for every unlocked input (like `nixpkgs`) to its
current version. This is equivalent to passing `--recreate-lock-file`
to any command that operates on a flake. That is,

```console
# nix flake update
# nix build
```

is equivalent to:

```console
# nix build --recreate-lock-file
```

)""
Add 'nix flake' manpages 2020-12-23 14:19:53 +02:00			`R""(`

			`# Examples`

			`* Recreate the lock file (i.e. update all inputs) and commit the new`
			`lock file:`

			```console
docs/flake-update: fix example 2022-08-04 10:45:30 +03:00			`# nix flake update --commit-lock-file`
nix flake update: Recreate the lock file This is probably what most people expect it to do. Fixes #3781. There is a new command 'nix flake lock' that has the old behaviour of 'nix flake update', i.e. it just adds missing lock file entries unless overriden using --update-input. 2021-02-26 15:55:54 +02:00			`* Updated 'nix': 'github:NixOS/nix/9fab14adbc3810d5cc1f88672fde1eee4358405c' -> 'github:NixOS/nix/8927cba62f5afb33b01016d5c4f7f8b7d0adde3c'`
			`* Updated 'nixpkgs': 'github:NixOS/nixpkgs/3d2d8f281a27d466fa54b469b5993f7dde198375' -> 'github:NixOS/nixpkgs/a3a3dda3bacf61e8a39258a0ed9c924eeca8e293'`
Add 'nix flake' manpages 2020-12-23 14:19:53 +02:00			`…`
			`warning: committed new revision '158bcbd9d6cc08ab859c0810186c1beebc982aad'`
			```

			`# Description`

nix flake update: Recreate the lock file This is probably what most people expect it to do. Fixes #3781. There is a new command 'nix flake lock' that has the old behaviour of 'nix flake update', i.e. it just adds missing lock file entries unless overriden using --update-input. 2021-02-26 15:55:54 +02:00			This command recreates the lock file of a flake (`flake.lock`), thus
Trivial changes from the lazy-trees branch 2022-12-07 13:58:58 +02:00			updating the lock for every unlocked input (like `nixpkgs`) to its
nix flake update: Recreate the lock file This is probably what most people expect it to do. Fixes #3781. There is a new command 'nix flake lock' that has the old behaviour of 'nix flake update', i.e. it just adds missing lock file entries unless overriden using --update-input. 2021-02-26 15:55:54 +02:00			current version. This is equivalent to passing `--recreate-lock-file`
			`to any command that operates on a flake. That is,`
Add 'nix flake' manpages 2020-12-23 14:19:53 +02:00
			```console
nix flake update: Recreate the lock file This is probably what most people expect it to do. Fixes #3781. There is a new command 'nix flake lock' that has the old behaviour of 'nix flake update', i.e. it just adds missing lock file entries unless overriden using --update-input. 2021-02-26 15:55:54 +02:00			`# nix flake update`
Add 'nix flake' manpages 2020-12-23 14:19:53 +02:00			`# nix build`
			```

			`is equivalent to:`

			```console
nix flake update: Recreate the lock file This is probably what most people expect it to do. Fixes #3781. There is a new command 'nix flake lock' that has the old behaviour of 'nix flake update', i.e. it just adds missing lock file entries unless overriden using --update-input. 2021-02-26 15:55:54 +02:00			`# nix build --recreate-lock-file`
Add 'nix flake' manpages 2020-12-23 14:19:53 +02:00			```

			`)""`