Transition from ports.json to listen.json

This commit changes the name of the ports.json file to listen.json. The rationale for this change is that IP addresses for Aluminum to use may also be specified in the file; hence, the term "listening address" is more suitable than "port." The documentation for the ports.json file has also been updated to use the new filename. Additionally, a warning that Wire does not yet include HTTPS support has been added below the description of `listenAddresses.wirePorts.HTTPS`.

This change is backwards-incompatible.

defaults/prefs/listen.json

@@ -0,0 +1,6 @@
+{
+  "wire": {
+    "HTTP": "80",
+    "HTTPS": "443"
+  }
+}

docs/general/listen-json.rst

@@ -0,0 +1,19 @@
+********************
+The listen.json file
+********************
+
+The ``listen.json`` file, located at ``/usr/prefs/listen.json`` determines which listening addresses Aluminum uses for different features. The file contains a single ``listenAddresses`` object, described below.
+
+A default configuration of ``listen.json`` is located at ``/defaults/prefs/listen.json``.
+
+.. json:object:: listenAddresses
+
+   :property wire: Listening address for Aluminum Wire
+   :proptype wire: :json:object:`wirePorts`
+
+.. json:object:: wirePorts
+
+   :property String HTTP: Port to use for Aluminum Wire over HTTP
+   :property String HTTPS: Port to use for Aluminum Wire over HTTPS
+
+        .. warning:: Wire does not yet support HTTPS.

docs/index.rst

@@ -26,7 +26,7 @@ Aluminum is controlled by configuration files written in JSON. These files are i
    :numbered:
    :hidden:
 
-   general/ports
+   general/listen-json
 
 
 Features

src/wire/main.js

@@ -5,7 +5,7 @@ const os = require('os') // For retrieving operating system information (for err
 const path = require('path') // For manipulating request paths
 const mimeTypes = require('mime-types') // For sending the correct Content-Type HTTP header
 
-const ports = JSON.parse(fs.readFileSync('../../usr/prefs/ports.json', 'utf8')).wire
+const ports = JSON.parse(fs.readFileSync('../../usr/prefs/listen.json', 'utf8')).wire
 const errorPage = fs.readFileSync('../../defaults/errors/404.html', 'utf8') // Default error page content
 const logo = fs.readFileSync('../../logo.svg', 'utf8')