Skip to content

Comments

tmux: install manpages#86296

Closed
iblech wants to merge 2 commits intoNixOS:masterfrom
iblech:patch-12
Closed

tmux: install manpages#86296
iblech wants to merge 2 commits intoNixOS:masterfrom
iblech:patch-12

Conversation

@iblech
Copy link
Contributor

@iblech iblech commented Apr 29, 2020

Motivation for this change

On current master, man tmux comes empty after in a nix-shell -p tmux. This pull request fixes that.

However, I'm a little bit unsure whether this is the correct procedure. I looked at other packages for guidance, but didn't spot a consistent pattern. The packages feh and vdr both use multiple outputs, as tmux did before this pull request; the manpages for feh are installed correctly and these for vdr are not.

Things done
  • Tested using sandboxing (nix.useSandbox on NixOS, or option sandbox in nix.conf on non-NixOS linux)
  • Built on platform(s)
    • NixOS
    • macOS
    • other Linux distributions
  • Tested via one or more NixOS test(s) if existing and applicable for the change (look inside nixos/tests)
  • Tested compilation of all pkgs that depend on this change using nix-shell -p nixpkgs-review --run "nixpkgs-review wip"
  • Tested execution of all binary files (usually in ./result/bin/)
  • Determined the impact on package closure size (by running nix path-info -S before and after)
  • Ensured that relevant documentation is up to date
  • Fits CONTRIBUTING.md.

@ofborg ofborg bot requested a review from fpletz April 29, 2020 08:32
@ofborg ofborg bot added 10.rebuild-darwin: 1-10 This PR causes between 1 and 10 packages to rebuild on Darwin. 10.rebuild-linux: 1-10 This PR causes between 1 and 10 packages to rebuild on Linux. labels Apr 29, 2020
version = "3.1";

outputs = [ "out" "man" ];
outputs = [ "out" ];
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this line is redundant if you only want to have the "out" output.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I dom't believe removing the man output is the solution.
I am not sure how nix-shell and MANPATH interact
nix-shell --pure -p tmux.man man does not find the man but my installed tmux brings up the manpage

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this line is redundant if you only want to have the "out" output.

Oh yes, I agree. I'll change this in a second.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I dom't believe removing the man output is the solution.
I am not sure how nix-shell and MANPATH interact
nix-shell --pure -p tmux.man man does not find the man but my installed tmux brings up the manpage

Okay, weird, it doesn't work for me. But it's not terribly important. I'll await further guidance how to proceed. :-) Thank you two of your review!

@Ma27
Copy link
Member

Ma27 commented Apr 29, 2020

👎 the multiple-output feature exists for a reason: https://nixos.org/nixpkgs/manual/#chap-multiple-output

I'm not 100% sure why the MANPATH isn't properly configured on nix-shell, you may want to file an issue here instead since a lot more packages are utilizing this pattern.

The packages feh and vdr both use multiple outputs, as tmux did before this pull request; the manpages for feh are installed correctly and these for vdr are not.

Is it possible that feh is installed in your local profile or your system and that's why the man-pages are found?

@doronbehar
Copy link
Contributor

doronbehar commented May 1, 2020

@doronbehar doronbehar closed this May 2, 2020
@iblech
Copy link
Contributor Author

iblech commented May 4, 2020

Thank you @doronbehar, I agree this should be closed in favor of the other issues/pull requests. I did not notice these before. Thank you for your work on our documentation system!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

10.rebuild-darwin: 1-10 This PR causes between 1 and 10 packages to rebuild on Darwin. 10.rebuild-linux: 1-10 This PR causes between 1 and 10 packages to rebuild on Linux.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants