Change DBus entry points to be static

The DBus class does not really have any usable instance data, so from an
API perspective, it doesn't make much sense to create an instance of
DBus just so that we can create an instance of Bus or Service.

So instead, make `getBus` and `registerService` static methods that can
be called directly, without instantiating a DBus instance first. This
simplifies the calling code a little bit.

That means that

    var dbus = new DBus();
    var bus = dbus.getBus('session');

turns into

    var bus = DBus.getBus('session');

and

    var dbus = new DBus();
    var service = dbus.registerService('session', 'service.name');

turns into

    var service = DBus.registerService('session', 'service.name');

Note that for backwards compatibility reasons, it's still possible to
instantiate a new instance and call the methods on the instance.

Author: bryanburgers

README.md

@@ -54,8 +54,8 @@ Work your way through other examples to explore supported functionality.
 
 ## Note on systems without X11
 If no X server is running, the module fails when attempting to obtain a D-Bus
-connection at `dbus._dbus.getBus()`. This can be remedied by setting two
-environment variables manually (the actual bus address might be different):
+connection at `DBus.getBus()`. This can be remedied by setting two environment
+variables manually (the actual bus address might be different):
 
 	process.env.DISPLAY = ':0';
 	process.env.DBUS_SESSION_BUS_ADDRESS = 'unix:path=/run/dbus/system_bus_socket';
@@ -68,16 +68,7 @@ environment variables manually (the actual bus address might be different):
 
 The root object of this module.
 
-#### `new DBus()`
-
-Create a new DBus instance.
-
-```
-var DBus = require('dbus')
-var dbus = new DBus()
-```
-
-#### `DBus.prototype.getBus(busName)`
+#### `DBus.getBus(busName)`
 
 * busName `<string>`
 
@@ -87,10 +78,10 @@ bus or `"session"` to connect to the session bus.
 Returns a `Bus`.
 
 ```
-var bus = dbus.getBus('session');
+var bus = DBus.getBus('session');
 ```
 
-#### `DBus.prototype.registerService(busName, serviceName)`
+#### `DBus.registerService(busName, serviceName)`
 
 * busName `<string>`
 * serviceName `<string>`
@@ -106,9 +97,26 @@ registered._
 Returns a `Service`.
 
 ```
-var service = dbus.registerService('session', 'com.example.Library');
+var service = DBus.registerService('session', 'com.example.Library');
+```
+
+#### *DEPRECATED* `new DBus()`
+
+Create a new DBus instance.
+
+```
+var DBus = require('dbus')
+var dbus = new DBus()
 ```
 
+#### *DEPRECATED* `DBus.prototype.getBus(busName)`
+
+Use `DBus.getBus(busName)`.
+
+#### *DEPRECATED* `DBus.prototype.registerService(busName, serviceName)`
+
+Use `DBus.registerService(busName, serviceName)`
+
 
 ### Bus
 

examples/error_handling.js

@@ -1,8 +1,6 @@
 var DBus = require('../');
 
-var dbus = new DBus();
-
-var bus = dbus.getBus('session');
+var bus = DBus.getBus('session');
 
 bus.getInterface('nodejs.dbus.ExampleService', '/nodejs/dbus/ExampleService', 'nodejs.dbus.ExampleService.Interface1', function(err, iface) {
 

examples/get_property.js

@@ -1,8 +1,6 @@
 var DBus = require('../');
 
-var dbus = new DBus();
-
-var bus = dbus.getBus('session');
+var bus = DBus.getBus('session');
 
 bus.getInterface('nodejs.dbus.ExampleService', '/nodejs/dbus/ExampleService', 'nodejs.dbus.ExampleService.Interface1', function(err, iface) {
 

examples/hello.js

@@ -1,8 +1,6 @@
 var DBus = require('../');
 
-var dbus = new DBus();
-
-var bus = dbus.getBus('session');
+var bus = DBus.getBus('session');
 
 bus.getInterface('nodejs.dbus.ExampleService', '/nodejs/dbus/ExampleService', 'nodejs.dbus.ExampleService.Interface1', function(err, iface) {
 

examples/invalid_args.js

@@ -1,8 +1,6 @@
 var DBus = require('../');
 
-var dbus = new DBus();
-
-var bus = dbus.getBus('session');
+var bus = DBus.getBus('session');
 
 bus.getInterface('nodejs.dbus.ExampleService', '/nodejs/dbus/ExampleService', 'nodejs.dbus.ExampleService.Interface1', function(err, iface) {
 	iface.Equal({ timeout: 1000 }, function(err, result) {

examples/method.js

@@ -1,8 +1,6 @@
 var DBus = require('../');
 
-var dbus = new DBus();
-
-var bus = dbus.getBus('session');
+var bus = DBus.getBus('session');
 
 bus.getInterface('nodejs.dbus.ExampleService', '/nodejs/dbus/ExampleService', 'nodejs.dbus.ExampleService.Interface1', function(err, iface) {
 

examples/multi_connection.js

@@ -1,8 +1,6 @@
 var DBus = require('../');
 
-var dbus = new DBus();
-
-var bus1 = dbus.getBus('session');
+var bus1 = DBus.getBus('session');
 
 bus1.getInterface('nodejs.dbus.ExampleService', '/nodejs/dbus/ExampleService', 'nodejs.dbus.ExampleService.Interface1', function(err, iface) {
 
@@ -12,7 +10,7 @@ bus1.getInterface('nodejs.dbus.ExampleService', '/nodejs/dbus/ExampleService', '
 
 });
 
-var bus2 = dbus.getBus('session');
+var bus2 = DBus.getBus('session');
 
 bus2.getInterface('nodejs.dbus.ExampleService', '/nodejs/dbus/ExampleService', 'nodejs.dbus.ExampleService.Interface1', function(err, iface) {
 

examples/service.js

@@ -1,9 +1,7 @@
 var DBus = require('../');
 
-var dbus = new DBus();
-
 // Create a new service, object and interface
-var service = dbus.registerService('session', 'nodejs.dbus.ExampleService');
+var service = DBus.registerService('session', 'nodejs.dbus.ExampleService');
 var obj = service.createObject('/nodejs/dbus/ExampleService');
 
 // Create interface

examples/set_max_received_size.js

@@ -1,7 +1,5 @@
 var DBus = require('../');
 
-var dbus = new DBus();
-
-var bus = dbus.getBus('session');
+var bus = DBus.getBus('session');
 
 bus.setMaxMessageSize(5000000);

examples/signal.js

@@ -1,8 +1,6 @@
 var DBus = require('../');
 
-var dbus = new DBus();
-
-var bus = dbus.getBus('session');
+var bus = DBus.getBus('session');
 
 bus.getInterface('nodejs.dbus.ExampleService', '/nodejs/dbus/ExampleService', 'nodejs.dbus.ExampleService.Interface1', function(err, iface) {