nvm.fish: add page

[reinhart1010]

• The page (if new), does not already exist in the repository.
• The page is in the correct platform directory (common/, linux/, etc.)
• The page has 8 or fewer examples.
• The PR title conforms to the recommended templates.
• The page follows the content guidelines.
• The page description includes a link to documentation or a homepage (if applicable).

Version of the command being documented (if known): 2.2.6

This is related to our discussion on #7480. However, this might break some tldr clients as this is the first known file to have more than one dot characters (.).

[tldr-bot]

Hello! I've noticed something unusual when checking this PR:

• The page common/nvm.fish.md seems to be a copy of common/nvm.md (56% matching).

Is this intended? If so, just ignore this comment. Otherwise, please double-check the commits.

[nicokosi]

If I understand correctly, the binary is nvm so I think there is a mismatch here.
Moreover, the CLI interface seems similar to https://github.com/nvm-sh/nvm so I am not sure this whole page is needed (it seems to overlap with #7511). 💭

[reinhart1010]

There are several differences between the original nvm with this version. In short, currently the commands between both versions aren't compatible with each other:

1. No nvm run or nvm exec (though I can just create a PR for that 😀)
2. The default Node.js version is set through set instead of a subcommand (again, even though I can just PR about it 😅)

Maybe I should close this PR by sending a couple to https://github.com/jorgebucaran/nvm.fish...

[nicokosi]

Thanks for the detailed information. 👍
I understand that commands are different. 👌
But I don't understand what to do with the mismatch between the binary name (nvm) and the page name (we would need to run tldr nvm.fish to find it, if I understand correctly). 🤔

[reinhart1010]

There's a bunch of related discussions related to this:

1. Help documenting other variants of NVM (Node Version Manager) #7480 - The one I've referenced here
2. Group commands by shells #7503 - Plans to separate commands by shells, if so I can move this into something like common/fish/nvm
3. Let's document: PowerShell #6621 - PowerShell, related to Group commands by shells #7503

[sbrl]

The title of a page needs to exactly match the command name being executed. This is not the case for the filename.

• Filename: nvm.fish.md
• Page title: nvm
• Command being executed: nvm

Ideally the page title and the filename will match, but this is unfortunately not always possible.

[sbrl]

For completeness, the command in question where it's also not possible is rename.

[sbrl]

Is this a typo? Should this be prefixed by nvm at all, or is this essentially updating an environment variable that nvm (fish) reads?

[reinhart1010]

Yes it uses the Fish' builtin set command to set the default version.

[github-actions]

Hi all! This thread has not had any recent activity.
Are there any updates? Thanks!

[sbrl]

Thanks, @reinhart1010!