@@ -75,7 +75,7 @@ with your package.
7575
7676It should look like this:
7777
78- { "url" : "http ://github.com/owner/project/issues"
78+ { "url" : "https ://github.com/owner/project/issues"
79798080 }
8181
@@ -219,7 +219,7 @@ will create entries for `man foo` and `man 2 foo`
219219
220220The CommonJS [ Packages] ( http://wiki.commonjs.org/wiki/Packages/1.0 ) spec details a
221221few ways that you can indicate the structure of your package using a ` directories `
222- object. If you look at [ npm's package.json] ( http ://registry.npmjs.org/npm/latest) ,
222+ object. If you look at [ npm's package.json] ( https ://registry.npmjs.org/npm/latest) ,
223223you'll see that it has directories for doc, lib, and man.
224224
225225In the future, this information may be used in other creative ways.
@@ -260,18 +260,23 @@ Do it like this:
260260
261261 "repository" :
262262 { "type" : "git"
263- , "url" : "http ://github.com/npm/npm.git"
263+ , "url" : "https ://github.com/npm/npm.git"
264264 }
265265
266266 "repository" :
267267 { "type" : "svn"
268- , "url" : "http ://v8.googlecode.com/svn/trunk/"
268+ , "url" : "https ://v8.googlecode.com/svn/trunk/"
269269 }
270270
271271The URL should be a publicly available (perhaps read-only) url that can be handed
272272directly to a VCS program without any modification. It should not be a url to an
273273html project page that you put in your browser. It's for computers.
274274
275+ For GitHub repositories you can use the same shortcut syntax you use for `npm
276+ install`:
277+
278+ "repository": "npm/npm"
279+
275280## scripts
276281
277282The "scripts" property is a dictionary containing script commands that are run
@@ -459,13 +464,19 @@ For example:
459464 }
460465
461466This ensures your package ` tea-latte ` can be installed * along* with the second
462- major version of the host package ` tea ` only. The host package is automatically
463- installed if needed. ` npm install tea-latte ` could possibly yield the following
464- dependency graph:
467+ major version of the host package ` tea ` only. ` npm install tea-latte ` could
468+ possibly yield the following dependency graph:
465469
466470467471468472
473+ ** NOTE: npm versions 1 and 2 will automatically install ` peerDependencies ` if
474+ they are not explicitly depended upon higher in the dependency tree. In the
475+ next major version of npm (npm@3), this will no longer be the case. You will
476+ receive a warning that the peerDependency is not installed instead.** The
477+ behavior in npms 1 & 2 was frequently confusing and could easily put you into
478+ dependency hell, a situation that npm is designed to avoid as much as possible.
479+
469480Trying to install another plugin with a conflicting requirement will cause an
470481error. For this reason, make sure your plugin requirement is as broad as
471482possible, and not to lock it down to specific patch versions.
@@ -534,6 +545,8 @@ field is advisory only.
534545
535546## engineStrict
536547
548+ ** NOTE: This feature is deprecated and will be removed in npm 3.0.0.**
549+
537550If you are sure that your module will * definitely not* run properly on
538551versions of Node/npm other than those specified in the ` engines ` object,
539552then you can set ` "engineStrict": true ` in your package.json file.
@@ -542,8 +555,7 @@ This will override the user's `engine-strict` config setting.
542555Please do not do this unless you are really very very sure. If your
543556engines object is something overly restrictive, you can quite easily and
544557inadvertently lock yourself into obscurity and prevent your users from
545- updating to new versions of Node. Consider this choice carefully. If
546- people abuse it, it will be removed in a future version of npm.
558+ updating to new versions of Node. Consider this choice carefully.
547559
548560## os
549561
0 commit comments