PR-URL: https://github.com/nodejs/node/pull/50531 Reviewed-By: Richard Lau <rlau@redhat.com> Reviewed-By: Luigi Pinca <luigipinca@gmail.com> Reviewed-By: Debadree Chatterjee <debadree333@gmail.com>
54 lines
1.5 KiB
JavaScript
54 lines
1.5 KiB
JavaScript
const { dirname, relative, join, resolve, basename } = require('path')
|
|
const linkGently = require('./link-gently.js')
|
|
const manTarget = require('./man-target.js')
|
|
|
|
const linkMans = async ({ path, pkg, top, force }) => {
|
|
const target = manTarget({ path, top })
|
|
if (!target || !Array.isArray(pkg?.man) || !pkg.man.length) {
|
|
return []
|
|
}
|
|
|
|
const links = []
|
|
// `new Set` to filter out duplicates
|
|
for (let man of new Set(pkg.man)) {
|
|
if (!man || typeof man !== 'string') {
|
|
continue
|
|
}
|
|
// break any links to c:\\blah or /foo/blah or ../blah
|
|
man = join('/', man).replace(/\\|:/g, '/').slice(1)
|
|
const parseMan = man.match(/\.([0-9]+)(\.gz)?$/)
|
|
if (!parseMan) {
|
|
throw Object.assign(new Error('invalid man entry name\n' +
|
|
'Man files must end with a number, ' +
|
|
'and optionally a .gz suffix if they are compressed.'
|
|
), {
|
|
code: 'EBADMAN',
|
|
path,
|
|
pkgid: pkg._id,
|
|
man,
|
|
})
|
|
}
|
|
|
|
const section = parseMan[1]
|
|
const base = basename(man)
|
|
const absFrom = resolve(path, man)
|
|
/* istanbul ignore if - that unpossible */
|
|
if (absFrom.indexOf(path) !== 0) {
|
|
throw Object.assign(new Error('invalid man entry'), {
|
|
code: 'EBADMAN',
|
|
path,
|
|
pkgid: pkg._id,
|
|
man,
|
|
})
|
|
}
|
|
|
|
const to = resolve(target, 'man' + section, base)
|
|
const from = relative(dirname(to), absFrom)
|
|
|
|
links.push(linkGently({ from, to, path, absFrom, force }))
|
|
}
|
|
return Promise.all(links)
|
|
}
|
|
|
|
module.exports = linkMans
|