Hi,
My knowledge of Linux is much longer but my experience of Nixos is about a year and I have a question about man pages for grub2.
I am currently on version 24.5
I have installed grub2 packages by adding it to configuration.nix and expected man pages to follow with the packages, but it didn’t. Am I missing something in my configuration?
To be more specifc I have installed the package by adding grub2 in configuration.nix like
this:
{ config, lib, pkgs, … }:
{
environment.systemPackages = with pkgs;[
grub2
man-pages
man-pages-posix
];
documentation = {
dev.enable = true;
man.generateCaches = true;
nixos.includeAllModules = true;
};
}
and running from shell:
nixos-rebuild test
typing
man grub-install
No manual entry for grub-install.
Anyone knows if man pages exist for Nixos at all?
Might be missing. Would you be interested in contributing a fix?
Thank you @mightyiam for your reply. Certainly if I could I would. I am not a programmer though but more like a sys-admin.I have no idea how that fix would look like, but I was personally more curious and interested in if I had followed the procedure correctly for installing the package after using nixos search to find out about the package; and I understand also I can install ubuntu or Mint on a VM and read the manpages there for grub2 if in need.
Fix is coming in a couple of days to nixos-unstable:
NixOS:master
← eclairevoyant:grub-man
opened 07:17PM - 10 Aug 24 UTC
## Description of changes
This appears to add 27.8 KiB to the runtime closur… e.
Result of `nixpkgs-review` run on x86_64-linux [1](https://github.com/Mic92/nixpkgs-review)
<details>
<summary>9 packages built:</summary>
<ul>
<li>grub2 (grub2_light)</li>
<li>grub2.debug (grub2_light.debug)</li>
<li>grub2_efi</li>
<li>grub2_efi.debug</li>
<li>grub2_pvgrub_image</li>
<li>grub2_xen</li>
<li>os-prober</li>
<li>timeshift</li>
<li>woeusb</li>
</ul>
</details>
<!--
For package updates please link to a changelog or describe changes, this helps your fellow maintainers discover breaking updates.
For new packages please briefly describe the package or provide a link to its homepage.
-->
## Things done
- Built on platform(s)
- [x] x86_64-linux
- [ ] aarch64-linux
- [ ] x86_64-darwin
- [x] aarch64-darwin
- For non-Linux: Is sandboxing enabled in `nix.conf`? (See [Nix manual](https://nixos.org/manual/nix/stable/command-ref/conf-file.html))
- [ ] `sandbox = relaxed`
- [ ] `sandbox = true`
- [ ] Tested, as applicable:
- [NixOS test(s)](https://nixos.org/manual/nixos/unstable/index.html#sec-nixos-tests) (look inside [nixos/tests](https://github.com/NixOS/nixpkgs/blob/master/nixos/tests))
- and/or [package tests](https://github.com/NixOS/nixpkgs/blob/master/pkgs/README.md#package-tests)
- or, for functions and "core" functionality, tests in [lib/tests](https://github.com/NixOS/nixpkgs/blob/master/lib/tests) or [pkgs/test](https://github.com/NixOS/nixpkgs/blob/master/pkgs/test)
- made sure NixOS tests are [linked](https://nixos.org/manual/nixpkgs/unstable/#ssec-nixos-tests-linking) to the relevant packages
- [ ] Tested compilation of all packages that depend on this change using `nix-shell -p nixpkgs-review --run "nixpkgs-review rev HEAD"`. Note: all changes have to be committed, also see [nixpkgs-review usage](https://github.com/Mic92/nixpkgs-review#usage)
- [ ] Tested basic functionality of all binary files (usually in `./result/bin/`)
- [24.11 Release Notes](https://github.com/NixOS/nixpkgs/blob/master/nixos/doc/manual/release-notes/rl-2411.section.md) (or backporting [23.11](https://github.com/NixOS/nixpkgs/blob/master/nixos/doc/manual/release-notes/rl-2311.section.md) and [24.05](https://github.com/NixOS/nixpkgs/blob/master/nixos/doc/manual/release-notes/rl-2405.section.md) Release notes)
- [ ] (Package updates) Added a release notes entry if the change is major or breaking
- [ ] (Module updates) Added a release notes entry if the change is significant
- [ ] (Module addition) Added a release notes entry if adding a new NixOS module
- [x] Fits [CONTRIBUTING.md](https://github.com/NixOS/nixpkgs/blob/master/CONTRIBUTING.md).
<!--
To help with the large amounts of pull requests, we would appreciate your
reviews of other pull requests, especially simple package updates. Just leave a
comment describing what you have tested in the relevant package/service.
Reviewing helps to reduce the average time-to-merge for everyone.
Thanks a lot if you do!
List of open PRs: https://github.com/NixOS/nixpkgs/pulls
Reviewing guidelines: https://github.com/NixOS/nixpkgs/blob/master/pkgs/README.md#reviewing-contributions
-->
---
Add a :+1: [reaction] to [pull requests you find important].
[reaction]: https://github.blog/2016-03-10-add-reactions-to-pull-requests-issues-and-comments/
[pull requests you find important]: https://github.com/NixOS/nixpkgs/pulls?q=is%3Aopen+sort%3Areactions-%2B1-desc
And the backport PR for 24.05 is created as well:
NixOS:release-24.05
← NixOS:backport-333757-to-release-24.05
opened 04:13AM - 11 Aug 24 UTC
Bot-based backport to `release-24.05`, triggered by a label in #333757.
* [ ] B… efore merging, ensure that this backport is [acceptable for the release](https://github.com/NixOS/nixpkgs/blob/master/CONTRIBUTING.md#changes-acceptable-for-releases).
* Even as a non-commiter, if you find that it is not acceptable, leave a comment.
1 Like
Thanks @waffle8946 for your fix. Much appreciated!