+28
doc/README.md
+28
doc/README.md
···
213
213
This makes reviews and suggestions much easier, since GitHub's review system is based on lines.
214
214
It also helps identifying long sentences at a glance.
215
215
216
+
### Writing Function Documentation
217
+
218
+
Function documentation is *reference documentation*, for which
219
+
[diataxis Reference documentation](https://diataxis.fr/reference/) (8 minutes) is **mandatory reading**.
220
+
221
+
On top of the diataxis framework, which provides a balanced perspective on what reference documentation should contain, we apply a specific style rule to function documentation:
222
+
the first sentence is in present tense, active voice, and the subject is omitted, referring implicitly to the name of the function.
223
+
For example:
224
+
225
+
```nix
226
+
/**
227
+
Subtracts value `b` from value `a`.
228
+
229
+
Returns the difference as a number.
230
+
*/
231
+
subtractValues # ...elided code
232
+
```
233
+
234
+
Renders as:
235
+
236
+
```md
237
+
## `subtractValues`
238
+
239
+
Subtracts value `b` from value `a`.
240
+
241
+
Returns the difference as a number.
242
+
```
243
+
216
244
### Callouts and examples
217
245
218
246
Use the [admonition syntax](#admonitions) for callouts and examples.
+55
pkgs/by-name/co/cosmic-ext-applet-caffeine/package.nix
+55
pkgs/by-name/co/cosmic-ext-applet-caffeine/package.nix
···
1
+
{
2
+
lib,
3
+
stdenv,
4
+
fetchFromGitHub,
5
+
rustPlatform,
6
+
libcosmicAppHook,
7
+
just,
8
+
nix-update-script,
9
+
}:
10
+
rustPlatform.buildRustPackage {
11
+
pname = "cosmic-ext-applet-caffeine";
12
+
version = "2025-09-29";
13
+
14
+
src = fetchFromGitHub {
15
+
owner = "tropicbliss";
16
+
repo = "cosmic-ext-applet-caffeine";
17
+
rev = "a43db670e03894ff402fa19eec3d60f7c7bf663c";
18
+
hash = "sha256-0hIc62FdjIGU028z8/WCx2q317e+PCA25CSibBVi/p0=";
19
+
};
20
+
21
+
cargoHash = "sha256-nl/giMIQ5xNSOgjv67OMWkfuAVtdIcqZDbXC1mYwXBM=";
22
+
23
+
nativeBuildInputs = [
24
+
libcosmicAppHook
25
+
just
26
+
];
27
+
28
+
dontUseJustBuild = true;
29
+
dontUseJustCheck = true;
30
+
31
+
justFlags = [
32
+
"--set"
33
+
"prefix"
34
+
(placeholder "out")
35
+
"--set"
36
+
"bin-src"
37
+
"target/${stdenv.hostPlatform.rust.cargoShortTarget}/release/cosmic-ext-applet-caffeine"
38
+
];
39
+
40
+
passthru.updateScript = nix-update-script {
41
+
extraArgs = [
42
+
"--version"
43
+
"branch=HEAD"
44
+
];
45
+
};
46
+
47
+
meta = {
48
+
description = "Caffeine Applet for the COSMIC desktop";
49
+
homepage = "https://github.com/tropicbliss/cosmic-ext-applet-caffeine";
50
+
license = lib.licenses.mit;
51
+
mainProgram = "cosmic-ext-applet-caffeine";
52
+
maintainers = [ lib.maintainers.HeitorAugustoLN ];
53
+
platforms = lib.platforms.linux;
54
+
};
55
+
}
+60
pkgs/by-name/co/cosmic-ext-applet-external-monitor-brightness/package.nix
+60
pkgs/by-name/co/cosmic-ext-applet-external-monitor-brightness/package.nix
···
1
+
{
2
+
lib,
3
+
stdenv,
4
+
rustPlatform,
5
+
fetchFromGitHub,
6
+
libcosmicAppHook,
7
+
just,
8
+
pkg-config,
9
+
udev,
10
+
nix-update-script,
11
+
}:
12
+
rustPlatform.buildRustPackage {
13
+
pname = "cosmic-ext-applet-external-monitor-brightness";
14
+
version = "0.0.1-unstable-2025-08-05";
15
+
16
+
src = fetchFromGitHub {
17
+
owner = "cosmic-utils";
18
+
repo = "cosmic-ext-applet-external-monitor-brightness";
19
+
rev = "23104965bd9ab1988b040a60f3f1e5d64038e7ce";
20
+
hash = "sha256-+Hu9bLEbue9bXaGfKa3InhdFI6qsBxccyQY8qzBYFPk=";
21
+
};
22
+
23
+
cargoHash = "sha256-ou7iukl1pHMfcJNemwLdZYYxugbJJQ53XpCYowUTj90=";
24
+
25
+
nativeBuildInputs = [
26
+
libcosmicAppHook
27
+
just
28
+
pkg-config
29
+
];
30
+
31
+
buildInputs = [ udev ];
32
+
33
+
dontUseJustBuild = true;
34
+
dontUseJustCheck = true;
35
+
36
+
justFlags = [
37
+
"--set"
38
+
"prefix"
39
+
(placeholder "out")
40
+
"--set"
41
+
"cargo-target-dir"
42
+
"target/${stdenv.hostPlatform.rust.cargoShortTarget}"
43
+
];
44
+
45
+
passthru.updateScript = nix-update-script {
46
+
extraArgs = [
47
+
"--version"
48
+
"branch=HEAD"
49
+
];
50
+
};
51
+
52
+
meta = {
53
+
description = "Applet to control the brightness of external monitors";
54
+
homepage = "https://github.com/cosmic-utils/cosmic-ext-applet-external-monitor-brightness";
55
+
license = lib.licenses.gpl3Only;
56
+
mainProgram = "cosmic-ext-applet-external-monitor-brightness";
57
+
maintainers = with lib.maintainers; [ HeitorAugustoLN ];
58
+
platforms = lib.platforms.linux;
59
+
};
60
+
}
+3
-3
pkgs/by-name/ge/gemini-cli/package.nix
+3
-3
pkgs/by-name/ge/gemini-cli/package.nix
···
11
11
12
12
buildNpmPackage (finalAttrs: {
13
13
pname = "gemini-cli";
14
-
version = "0.6.1";
14
+
version = "0.7.0";
15
15
16
16
src = fetchFromGitHub {
17
17
owner = "google-gemini";
18
18
repo = "gemini-cli";
19
19
tag = "v${finalAttrs.version}";
20
-
hash = "sha256-1QeVFPl6IH1iQFxrDZ0U8eTeLd+fIgSw1CkAiSGaL/s=";
20
+
hash = "sha256-tAX32t/NLO9j7kRxR9kipfl/afLfANN/jzWKXJC9mS4=";
21
21
};
22
22
23
-
npmDepsHash = "sha256-l5AFQH5h6CPNnuSP0jjla3UbBhjPDVEc8fL5NWcT1XQ=";
23
+
npmDepsHash = "sha256-nSNGWjRbAR2IFod3yC7d30Siui7N4Z0KZVxtsJ01UX8=";
24
24
25
25
nativeBuildInputs = [
26
26
jq
+3
-8
pkgs/by-name/is/issue2md/package.nix
+3
-8
pkgs/by-name/is/issue2md/package.nix
···
6
6
7
7
buildGoModule (finalAttrs: {
8
8
pname = "issue2md";
9
-
version = "1.2.0";
9
+
version = "1.3.0";
10
10
11
11
src = fetchFromGitHub {
12
12
owner = "bigwhite";
13
13
repo = "issue2md";
14
14
tag = "v${finalAttrs.version}";
15
-
hash = "sha256-jwMaXiGcdNCQZJ2xht1oAcFJohFJiTH3lV3+opZ677g=";
15
+
hash = "sha256-bbID2yJkVdzWJ+LcQCTTeoMsQpJdT4op9PhTDwr+D+A=";
16
16
};
17
17
18
18
vendorHash = null;
19
19
20
-
ldflags = [
21
-
"-s"
22
-
"-w"
23
-
];
24
-
25
20
meta = {
26
21
description = "CLI tool to convert GitHub issue into Markdown file";
27
22
homepage = "https://github.com/bigwhite/issue2md";
28
23
license = lib.licenses.asl20;
29
-
maintainers = with lib.maintainers; [ ];
24
+
maintainers = with lib.maintainers; [ drupol ];
30
25
mainProgram = "issue2md";
31
26
};
32
27
})
+2
-2
pkgs/by-name/pr/protonmail-desktop/package.nix
+2
-2
pkgs/by-name/pr/protonmail-desktop/package.nix
···
9
9
}:
10
10
let
11
11
mainProgram = "proton-mail";
12
-
version = "1.9.0";
12
+
version = "1.9.1";
13
13
14
14
in
15
15
stdenv.mkDerivation {
···
18
18
19
19
src = fetchurl {
20
20
url = "https://proton.me/download/mail/linux/${version}/ProtonMail-desktop-beta.deb";
21
-
sha256 = "sha256-8gUkWDBLzilmLrZCHRjf8EPYrjyHpwpA7ZIU4FQ1azA=";
21
+
hash = "sha256-P2i/uX++F1JUgwSUyndYazjLSCK1mP+XSGICPUoo1VE=";
22
22
};
23
23
24
24
dontConfigure = true;
+3
-3
pkgs/by-name/te/television/package.nix
+3
-3
pkgs/by-name/te/television/package.nix
···
10
10
}:
11
11
rustPlatform.buildRustPackage (finalAttrs: {
12
12
pname = "television";
13
-
version = "0.13.2";
13
+
version = "0.13.4";
14
14
15
15
src = fetchFromGitHub {
16
16
owner = "alexpasmantier";
17
17
repo = "television";
18
18
tag = finalAttrs.version;
19
-
hash = "sha256-Ur6UTd3XsI2ZyVboQA9r3WDkl7hd1wQ0NCgTlYFF/C0=";
19
+
hash = "sha256-LImipNu1uK1jcxU18Cw3BayHig2AS37PMGOOO8cJoE4=";
20
20
};
21
21
22
-
cargoHash = "sha256-LfaYRrJ4ZXoNVDsI650t+A7mWB9+2+znATp+mqDwTiE=";
22
+
cargoHash = "sha256-c/IYFf9gc3udzy5LPnyPPF0xuzT4vd2BGcLz0Xan2Do=";
23
23
24
24
nativeBuildInputs = [ makeWrapper ];
25
25
+1
-5
pkgs/development/interpreters/clojure/default.nix
+1
-5
pkgs/development/interpreters/clojure/default.nix
···
4
4
bashNonInteractive,
5
5
fetchurl,
6
6
installShellFiles,
7
-
jdk21,
7
+
jdk,
8
8
rlwrap,
9
9
makeWrapper,
10
10
writeScript,
11
11
}:
12
-
let
13
-
# set this to an LTS version of java
14
-
jdk = jdk21;
15
-
in
16
12
stdenv.mkDerivation (finalAttrs: {
17
13
pname = "clojure";
18
14
version = "1.12.2.1565";
+2
-2
pkgs/development/python-modules/django/5_1.nix
+2
-2
pkgs/development/python-modules/django/5_1.nix
···
44
44
45
45
buildPythonPackage rec {
46
46
pname = "django";
47
-
version = "5.1.12";
47
+
version = "5.1.13";
48
48
pyproject = true;
49
49
50
50
disabled = pythonOlder "3.10";
···
53
53
owner = "django";
54
54
repo = "django";
55
55
rev = "refs/tags/${version}";
56
-
hash = "sha256-QWBxP728D/HQb+WLPkaXMOQtlO8b+FWcYxZyHoVcxVI=";
56
+
hash = "sha256-y6wBMQ2BA6UUOJDWGhidCFwthtXZU2r0oGOUUSwKvQE=";
57
57
};
58
58
59
59
patches = [
+2
-2
pkgs/development/python-modules/django/5_2.nix
+2
-2
pkgs/development/python-modules/django/5_2.nix
···
43
43
44
44
buildPythonPackage rec {
45
45
pname = "django";
46
-
version = "5.2.6";
46
+
version = "5.2.7";
47
47
pyproject = true;
48
48
49
49
disabled = pythonOlder "3.10";
···
52
52
owner = "django";
53
53
repo = "django";
54
54
rev = "refs/tags/${version}";
55
-
hash = "sha256-Bzm4FTzYeXEEFenkT2gN1IzYnUIo7tlD2GI/sX2THkw=";
55
+
hash = "sha256-rvnKa2+QabRtRfj0sauUsoxp0LJLUCmWrFs6ruVrz4k=";
56
56
};
57
57
58
58
patches = [
+10
-1
pkgs/os-specific/linux/kernel/common-config.nix
+10
-1
pkgs/os-specific/linux/kernel/common-config.nix
···
230
230
DAMON_DBGFS = whenBetween "5.15" "6.9" yes;
231
231
DAMON_RECLAIM = whenAtLeast "5.16" yes;
232
232
DAMON_LRU_SORT = whenAtLeast "6.0" yes;
233
+
DAMON_STAT = whenAtLeast "6.17" yes;
233
234
# Support recovering from memory failures on systems with ECC and MCA recovery.
234
235
MEMORY_FAILURE = yes;
235
236
···
1307
1308
HOTPLUG_PCI_PCIE = yes; # PCI-Expresscard hotplug support
1308
1309
1309
1310
# Enable AMD's ROCm GPU compute stack
1310
-
HSA_AMD = lib.mkIf stdenv.hostPlatform.is64bit (yes);
1311
+
HSA_AMD = lib.mkIf stdenv.hostPlatform.is64bit yes;
1312
+
# required for P2P DMABUF
1313
+
DMABUF_MOVE_NOTIFY = lib.mkIf stdenv.hostPlatform.is64bit (whenAtLeast "6.6" yes);
1314
+
# required for P2P transfers between accelerators
1315
+
HSA_AMD_P2P = lib.mkIf stdenv.hostPlatform.is64bit (whenAtLeast "6.6" yes);
1316
+
1311
1317
ZONE_DEVICE = lib.mkIf stdenv.hostPlatform.is64bit (yes);
1312
1318
HMM_MIRROR = yes;
1313
1319
DRM_AMDGPU_USERPTR = yes;
···
1474
1480
# Enable AMD Wi-Fi RF band mitigations
1475
1481
# See https://cateee.net/lkddb/web-lkddb/AMD_WBRF.html
1476
1482
AMD_WBRF = whenAtLeast "6.8" yes;
1483
+
1484
+
# Enable AMD heterogeneous core hardware feedback interface
1485
+
AMD_HFI = whenAtLeast "6.17" yes;
1477
1486
1478
1487
# Enable Intel Turbo Boost Max 3.0
1479
1488
INTEL_TURBO_MAX_3 = yes;
+19
-14
pkgs/os-specific/linux/kernel/kernels-org.json
+19
-14
pkgs/os-specific/linux/kernel/kernels-org.json
···
5
5
"lts": false
6
6
},
7
7
"6.1": {
8
-
"version": "6.1.154",
9
-
"hash": "sha256:165im36dhnvhrfkn4x77ds6cgisn40d1cwxvxsci5lnhqf9bl6kg",
8
+
"version": "6.1.155",
9
+
"hash": "sha256:0wsw99h2jsrcx9fff59nqjx66l40vywj8qi3j6yvqpq8xsp8g4y2",
10
10
"lts": true
11
11
},
12
12
"5.15": {
13
-
"version": "5.15.193",
14
-
"hash": "sha256:168ymh51hm0l6pd9g2kc33ji28gznc25rwzj7rvhnw82z79640n7",
13
+
"version": "5.15.194",
14
+
"hash": "sha256:0zi6ihvjmaf940arnc7jjvdqrjf3cvkc9mqc8n24dz85vam6z39l",
15
15
"lts": true
16
16
},
17
17
"5.10": {
18
-
"version": "5.10.244",
19
-
"hash": "sha256:1h3dqaran5zrfgs0vybwq576yka8s9jirahiy3bb7hpm1763f2i1",
18
+
"version": "5.10.245",
19
+
"hash": "sha256:17wxs8i8vd5ivv99ra0sri3wmkw5c22wsaw8nf1xcvys2kmpa7hk",
20
20
"lts": true
21
21
},
22
22
"5.4": {
23
-
"version": "5.4.299",
24
-
"hash": "sha256:0bdzy3bpywm24nx73ah9smwmmlmyhvlf5xcp2kk1z54dxfp9bpl8",
23
+
"version": "5.4.300",
24
+
"hash": "sha256:0nl1l689d4jq2l39v816yy7z5lzc5dvv8aqn85xlv4najc022jcr",
25
25
"lts": true
26
26
},
27
27
"6.6": {
28
-
"version": "6.6.108",
29
-
"hash": "sha256:19k834gd9galmzl7gq0v25nv785ld7ryygrmgdh1cpb9m8rd6730",
28
+
"version": "6.6.109",
29
+
"hash": "sha256:1x1h2x04xvds8k59x36zqxzbj4cm6yl5l6xacgfyxzccfycwscbp",
30
30
"lts": true
31
31
},
32
32
"6.12": {
33
-
"version": "6.12.49",
34
-
"hash": "sha256:09jm892q3b275liyzmycczg6nyjg1ramsma920jf5k6s8vhj2ii3",
33
+
"version": "6.12.50",
34
+
"hash": "sha256:19bjzhxasj4r6m1lhsa486a96axfigbm06kqa2lwa7y2s5sbsdf4",
35
35
"lts": true
36
36
},
37
37
"6.16": {
38
-
"version": "6.16.9",
39
-
"hash": "sha256:13g59jvc6kvp8dzl6ysmzrpq4nh9xvy5va5avrsn6iq5ryiwij3s",
38
+
"version": "6.16.10",
39
+
"hash": "sha256:1wm8azbwy131cwvxab66v2ccybfkaq7gkxili0p6hjqyhnlbn1mb",
40
+
"lts": false
41
+
},
42
+
"6.17": {
43
+
"version": "6.17",
44
+
"hash": "sha256:19spyyknps9dzb6mz5sk685a505hzqi144lqc0rdi6f9l5k72q4v",
40
45
"lts": false
41
46
}
42
47
}
+2
pkgs/top-level/aliases.nix
+2
pkgs/top-level/aliases.nix
···
1425
1425
linuxPackages_6_14 = linuxKernel.packages.linux_6_14;
1426
1426
linuxPackages_6_15 = linuxKernel.packages.linux_6_15;
1427
1427
linuxPackages_6_16 = linuxKernel.packages.linux_6_16;
1428
+
linuxPackages_6_17 = linuxKernel.packages.linux_6_17;
1428
1429
linuxPackages_ham = linuxKernel.packages.linux_ham;
1429
1430
linuxPackages_rpi0 = linuxKernel.packages.linux_rpi1;
1430
1431
linuxPackages_rpi02w = linuxKernel.packages.linux_rpi3;
···
1450
1451
linux_6_14 = linuxKernel.kernels.linux_6_14;
1451
1452
linux_6_15 = linuxKernel.kernels.linux_6_15;
1452
1453
linux_6_16 = linuxKernel.kernels.linux_6_16;
1454
+
linux_6_17 = linuxKernel.kernels.linux_6_17;
1453
1455
linux_ham = linuxKernel.kernels.linux_ham;
1454
1456
linux_rpi0 = linuxKernel.kernels.linux_rpi1;
1455
1457
linux_rpi02w = linuxKernel.kernels.linux_rpi3;
+6
-1
pkgs/top-level/all-packages.nix
+6
-1
pkgs/top-level/all-packages.nix
···
5780
5780
xeus-cling
5781
5781
;
5782
5782
5783
-
clojure = callPackage ../development/interpreters/clojure { };
5783
+
clojure = callPackage ../development/interpreters/clojure {
5784
+
# set this to an LTS version of java
5785
+
# Be careful if you remove this, out-of-tree consumers expect to
5786
+
# be able to override `jdk`.
5787
+
jdk = jdk21;
5788
+
};
5784
5789
5785
5790
clooj = callPackage ../development/interpreters/clojure/clooj.nix { };
5786
5791
+10
-1
pkgs/top-level/linux-kernels.nix
+10
-1
pkgs/top-level/linux-kernels.nix
···
218
218
];
219
219
};
220
220
221
+
linux_6_17 = callPackage ../os-specific/linux/kernel/mainline.nix {
222
+
branch = "6.17";
223
+
kernelPatches = [
224
+
kernelPatches.bridge_stp_helper
225
+
kernelPatches.request_key_helper
226
+
];
227
+
};
228
+
221
229
linux_testing =
222
230
let
223
231
testing = callPackage ../os-specific/linux/kernel/mainline.nix {
···
737
745
linux_6_6 = recurseIntoAttrs (packagesFor kernels.linux_6_6);
738
746
linux_6_12 = recurseIntoAttrs (packagesFor kernels.linux_6_12);
739
747
linux_6_16 = recurseIntoAttrs (packagesFor kernels.linux_6_16);
748
+
linux_6_17 = recurseIntoAttrs (packagesFor kernels.linux_6_17);
740
749
}
741
750
// lib.optionalAttrs config.allowAliases {
742
751
linux_4_19 = throw "linux 4.19 was removed because it will reach its end of life within 24.11"; # Added 2024-09-21
···
809
818
packageAliases = {
810
819
linux_default = packages.linux_6_12;
811
820
# Update this when adding the newest kernel major version!
812
-
linux_latest = packages.linux_6_16;
821
+
linux_latest = packages.linux_6_17;
813
822
linux_rt_default = packages.linux_rt_5_15;
814
823
linux_rt_latest = packages.linux_rt_6_6;
815
824
}