Bug 2436319

Summary: nix-shell man page contains {{#include ./opt-common.md}}
Product: [Fedora] Fedora Reporter: Dennis Schridde <heri>
Component: nixAssignee: Jens Petersen <petersen>
Status: CLOSED ERRATA QA Contact:
Severity: medium Docs Contact:
Priority: unspecified    
Version: 44CC: petersen
Target Milestone: ---   
Target Release: ---   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: nix-2.34.5-1.fc44 Doc Type: ---
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2026-04-16 23:40:58 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Dennis Schridde 2026-02-03 12:52:15 UTC
On Fedora 43 `nix-shell --help` or `man 1 nix-shell` contains `{{#include ./opt-common.md}}` in the "Options" section.  This appears to be a packaging issue, since I cannot reproduce it on NixOS 25.11.  It might be related to bug #2415126.

Reproducible: Always




Additional Information:

NixOS 25.11 has `nix-env --version`: nix-env (Nix) 2.31.2

Fedora 43 has:
```
❯ dnf info nix
Installed packages
Name            : nix
Epoch           : 0
Version         : 2.31.3
Release         : 1.fc43
Architecture    : x86_64
Installed size  : 0.0   B
Source          : nix-2.31.3-1.fc43.src.rpm
From repository : updates
Summary         : A purely functional package manager
URL             : https://github.com/NixOS/nix
License         : LGPL-2.1-or-later
Description     : Nix is a purely functional package manager.
                : It allows multiple versions of a package to be installed side-by-side,
                : ensures that dependency specifications are complete,
                : supports atomic upgrades and rollbacks,
                : allows non-root users to install software, and has many other features.
                : It is the basis of the NixOS Linux distribution,
                : but it can be used equally well under other Unix systems.
                :
                : See the README.fedora.md file for setup instructions.
Vendor          : Fedora Project
```

Comment 1 Jens Petersen 2026-02-03 16:05:19 UTC
Thank you for the report: appreciate it.

I need to into this more: not sure if this is easy to fix currently.
Though might tie into the fedora patch you allude too.

However things may improve in 2.33 perhaps since I think the manpages
there were decoupled from mdbook perhaps (which we don't have in fedora ((yet anyway))).

Comment 2 Jens Petersen 2026-03-21 06:46:19 UTC
I believe this is fixed in nix-2.33 which is now built for Rawhide at least.

I will probably backport 2.33 to F44 later (I just updated it to 2.32).

Comment 3 Fedora Update System 2026-04-10 04:00:14 UTC
FEDORA-2026-8c7366e046 (nix-2.34.5-1.fc44) has been submitted as an update to Fedora 44.
https://bodhi.fedoraproject.org/updates/FEDORA-2026-8c7366e046

Comment 4 Fedora Update System 2026-04-16 23:40:58 UTC
FEDORA-2026-8c7366e046 (nix-2.34.5-1.fc44) has been pushed to the Fedora 44 stable repository.
If problem still persists, please make note of it in this bug report.