1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
module.exports = help
help.completion = function (args, index, cb) {
if (index < 3) {
var getCompletions = require("./utils/completion/get-completions")
, section = args[0] || ""
getSections(function (er, sectionList) {
if (er) return cb(er)
cb(null, getCompletions(section, sectionList))
})
}
}
var fs = require("./utils/graceful-fs")
, path = require("path")
, exec = require("./utils/exec")
, npm = require("../npm")
, output = require("./utils/output")
function help (args, cb) {
var section = args.shift()
if (section === "help") {
section = !npm.config.get("usage") && "npm"
}
if (section) {
if ( npm.config.get("usage")
&& npm.commands[section]
&& npm.commands[section].usage
) {
npm.config.set("loglevel", "silent")
return output.write(npm.config.get("outfd"), npm.commands[section].usage, cb)
}
var section_path = path.join(__dirname, "../man1/"+section+".1")
return fs.stat
( section_path
, function (e, o) {
if (e) return cb(new Error("Help section not found: "+section))
// function exec (cmd, args, env, takeOver, cb) {
var manpath = path.join(__dirname, "..")
, env = {}
Object.keys(process.env).forEach(function (i) { env[i] = process.env[i] })
env.MANPATH = manpath
var viewer = npm.config.get("viewer")
switch (viewer) {
case "woman":
var args = ["-e", "(woman-find-file \"" + section_path + "\")"]
exec("emacsclient", args, env, true, cb)
break
default:
exec("man", [section], env, true, cb)
}
}
)
} else getSections(function (er, sections) {
if (er) return cb(er)
npm.config.set("loglevel", "silent")
output.write(npm.config.get("outfd"),
["\nUsage: npm <command>"
, ""
, "where <command> is one of:"
, " "+wrap(Object.keys(npm.commands))
, ""
, "Add -h to any command for quick help."
, ""
, "Specify configs in the ini-formatted file at "
+ npm.config.get("userconfig")
, "or on the command line via: npm <command> --key value"
, "Config info can be viewed via: npm help config"
, ""
, "Help usage: npm help <section>"
, ""
, "where <section> is one of:"
, " " + wrap(sections)
, ""
, "Even more help at: npm help help"
].join("\n"), function () { cb(er) })
})
}
function wrap (arr) {
var out = ['']
, l = 0
arr.sort(function (a,b) { return a<b?-1:1 })
.forEach(function (c) {
if (out[l].length + c.length + 2 < 60) {
out[l] += ', '+c
} else {
out[l++] += ','
out[l] = c
}
})
return out.join("\n ").substr(2)
}
function getSections(cb) {
fs.readdir(path.join(__dirname, "../man1/"), function (er, files) {
if (er) return cb(er)
var sectionList = files.concat("help.1")
.filter(function (s) { return s.match(/\.1$/) })
.map(function (s) { return s.replace(/\.1$/, '')})
cb(null, sectionList)
})
}
|
