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

[Jonathan Nieder]

Jonas Smedegaard wrote:

>                            You really think that is acceptable for the 
> project?

Surely not: the new command has no manpage. :)

I'm attaching a patch that adds some documentation.
-------------- next part --------------
 debian/README.Debian |   16 +++++++++++++++-
 debian/changelog     |    3 ++-
 debian/nodejs.links  |    1 +
 3 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/debian/README.Debian b/debian/README.Debian
index 2ecf4315..05344f66 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -23,5 +23,19 @@ 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 node(1) for more information about NODE_PATH.
+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 936cf53e..740f00c7 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -8,7 +8,8 @@ nodejs (0.6.14~dfsg1-2) UNRELEASED; urgency=low
       excess indendation, and sort by year and then name.
 
   [ Jonathan Nieder ]
-  * Add /usr/bin/nodejs as a symlink to node.
+  * 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.
 
  -- Jonas Smedegaard <dr at jones.dk>  Sat, 28 Apr 2012 14:50:29 +0200
diff --git a/debian/nodejs.links b/debian/nodejs.links
index ddab6c5e..5e1073bf 100644
--- a/debian/nodejs.links
+++ b/debian/nodejs.links
@@ -1 +1,2 @@
 usr/bin/node usr/bin/nodejs
+usr/share/man/man1/node.1.gz usr/share/man/man1/nodejs.1.gz
-- 
1.7.10