docs: provide man page

[antongolub]

{
"bin": {
    "zx": "./build/cli.js"
  },
  "man": "./man/zx.1",
  "engines": {
    "node": ">= 12.17.0"
  },
}

[qlonik]

Just wanted to let you know, that this feature now causes zx global installation on github runners to fail:

Run npm install -g zx
npm ERR! code EACCES
npm ERR! syscall symlink
npm ERR! path ../../../lib/node_modules/zx/man/zx.1
npm ERR! dest /usr/local/share/man/man1/zx.1
npm ERR! errno -13
npm ERR! Error: EACCES: permission denied, symlink '../../../lib/node_modules/zx/man/zx.1' -> '/usr/local/share/man/man1/zx.1'
npm ERR!  [Error: EACCES: permission denied, symlink '../../../lib/node_modules/zx/man/zx.1' -> '/usr/local/share/man/man1/zx.1'] {
npm ERR!   errno: -13,
npm ERR!   code: 'EACCES',
npm ERR!   syscall: 'symlink',
npm ERR!   path: '../../../lib/node_modules/zx/man/zx.1',
npm ERR!   dest: '/usr/local/share/man/man1/zx.1'
npm ERR! }
npm ERR! 
npm ERR! The operation was rejected by your operating system.
npm ERR! It is likely you do not have the permissions to access this file as the current user
npm ERR! 
npm ERR! If you believe this might be a permissions issue, please double-check the
npm ERR! permissions of the file and its containing directories, or try running
npm ERR! the command again as root/Administrator.

npm ERR! A complete log of this run can be found in: /home/runner/.npm/_logs/2024-05-15T22_07_55_134Z-debug-0.log
Error: Process completed with exit code 243.

[antongolub]

actions/runner-images#9644
npm/statusboard#481

[antongolub]

IMO, man pages should not be installed for CI at all.

[antongolub]

• feat: ignore EACCES on linking npm/bin-links#121