[Pkg-javascript-devel] Bug#650343: nodejs: please provide "nodejs" command as a synonym for node

[Jonathan Nieder]

Jonathan Nieder wrote:

> I'm attaching a patch that adds some documentation.

And another patch, to make that documentation easier to find.
-------------- next part --------------
From: Jonathan Nieder <jrnieder at gmail.com>
Date: Sat, 28 Apr 2012 10:32:56 -0500
Subject: Install README.Debian in the nodejs package.

debian/README.Debian is being installed to the first package listed in
debian/control, nodejs-dev.

Better to install to the nodejs package, where the rest of the
documentation already is.
---
 debian/README.Debian        |   41 -----------------------------------------
 debian/changelog            |    1 +
 debian/nodejs.README.Debian |   41 +++++++++++++++++++++++++++++++++++++++++
 3 files changed, 42 insertions(+), 41 deletions(-)
 delete mode 100644 debian/README.Debian
 create mode 100644 debian/nodejs.README.Debian

diff --git a/debian/README.Debian b/debian/README.Debian
deleted file mode 100644
index 05344f66..00000000
--- a/debian/README.Debian
+++ /dev/null
@@ -1,41 +0,0 @@
-nodejs for Debian
-=================
-
-packaged modules
-----------------
-
-The global search path for modules is
-/usr/lib/nodejs
-
-Future packages of node modules will use that directory,
-so it should be used wisely.
-
-
-user modules
-------------
-
-Node looks for modules in ./node_modules directory first;
-please read node#modules documentation carefully for more information.
-
-Node does not look for modules in /usr/local/lib/node_modules,
-where npm put them.
-Please read npm-link(1) of npm package, to understand how to properly
-use npm-installed modules in a project.
-
-Note that require.paths is not supported in future node versions.
-See also nodejs(1) for more information about NODE_PATH.
-
-
-nodejs command
---------------
-
-The upstream name for the Node.js interpreter command is "node", and
-Debian provides the same (for now) for compatibility.
-
-That is a very generic name and there are other commands that use
-the same name in their upstreams, such as ax25-node from the "node"
-package.
-
-Scripts wishing to refer unambiguously to the Node.js interpreter
-can use the "nodejs" command instead.
-We are pursuing inclusion of this synonym upstream.
diff --git a/debian/changelog b/debian/changelog
index 740f00c7..1aa4a265 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -11,6 +11,7 @@ nodejs (0.6.14~dfsg1-2) UNRELEASED; urgency=low
   * Add /usr/bin/nodejs as a symlink to node and nodejs.1.gz as a
     symlink to the node(1) manpage. Explanation in README.Debian.
     Closes: #650343.
+  * Include README.Debian in nodejs package instead of nodejs-dev.
 
  -- Jonas Smedegaard <dr at jones.dk>  Sat, 28 Apr 2012 14:50:29 +0200
 
diff --git a/debian/nodejs.README.Debian b/debian/nodejs.README.Debian
new file mode 100644
index 00000000..05344f66
--- /dev/null
+++ b/debian/nodejs.README.Debian
@@ -0,0 +1,41 @@
+nodejs for Debian
+=================
+
+packaged modules
+----------------
+
+The global search path for modules is
+/usr/lib/nodejs
+
+Future packages of node modules will use that directory,
+so it should be used wisely.
+
+
+user modules
+------------
+
+Node looks for modules in ./node_modules directory first;
+please read node#modules documentation carefully for more information.
+
+Node does not look for modules in /usr/local/lib/node_modules,
+where npm put them.
+Please read npm-link(1) of npm package, to understand how to properly
+use npm-installed modules in a project.
+
+Note that require.paths is not supported in future node versions.
+See also nodejs(1) for more information about NODE_PATH.
+
+
+nodejs command
+--------------
+
+The upstream name for the Node.js interpreter command is "node", and
+Debian provides the same (for now) for compatibility.
+
+That is a very generic name and there are other commands that use
+the same name in their upstreams, such as ax25-node from the "node"
+package.
+
+Scripts wishing to refer unambiguously to the Node.js interpreter
+can use the "nodejs" command instead.
+We are pursuing inclusion of this synonym upstream.
-- 
1.7.10