v0.44.1 Minor Update - Added Augs to Duplicate Sleeves and updated documentation

doc/source/netscript/basicfunctions/purchaseServer.rst

@@ -0,0 +1,30 @@
+purchaseServer() Netscript Function
+===================================
+
+.. js:function:: purchaseServer(hostname, ram)
+
+    :param string hostname: Hostname of the purchased server
+    :param number ram: Amount of RAM of the purchased server. Must be a power of 2 (2, 4, 8, 16, etc.). Maximum value of 1048576 (2^20)
+    :RAM cost: 2.25 GB
+
+    Purchased a server with the specified hostname and amount of RAM.
+
+    The *hostname* argument can be any data type, but it will be converted to a string and have whitespace removed. Anything that resolves to an empty string will
+    cause the function to fail. If there is already a server with the specified hostname, then the function will automatically append
+    a number at the end of the *hostname* argument value until it finds a unique hostname. For example, if the script calls
+    *purchaseServer("foo", 4)* but a server named "foo" already exists, the it will automatically change the hostname to "foo-0". If there is already
+    a server with the hostname "foo-0", then it will change the hostname to "foo-1", and so on.
+
+    Note that there is a maximum limit to the amount of servers you can purchase.
+
+    Returns the hostname of the newly purchased server as a string. If the function fails to purchase a server, then it will return an
+    empty string. The function will fail if the arguments passed in are invalid, if the player does not have enough money to purchase
+    the specified server, or if the player has exceeded the maximum amount of servers.
+
+    Example::
+
+        ram = 64;
+        hn = "pserv-";
+        for (i = 0; i < 5; ++i) {
+            purchaseServer(hn + i, ram);
+        }