add osx-ssl-certs help page

help/osx-ssl-certs.md

@@ -0,0 +1,49 @@
+# OSX OpenSSL Certificates handling.
+
+## Synopsis
+
+    rvm osx-ssl-certs status [<ruby>|all]
+    rvm [--silent] osx-ssl-certs update [<ruby>|all]
+    rvm osx-ssl-certs cron [status|install|uninstall]
+
+## Description
+
+Apple OS X comes with old version of OpenSSL, to keep you secure RVM installs newer version.
+RVM also allows specifying custom version of OpenSSL and binary rubies linked to custom locations.
+Taken this all into account most likely your Ruby is using outdated certificates.
+To solve this problem `rvm osx-ssl-certs` will find all locations for certificates.
+You can check status, update certificates manually or schedule an automated update.
+
+## Arguments
+`rvm osx-ssl-certs`:
+
+* `status`      => Show certificates status for current Ruby,
+  * `<ruby>`    => Status of a specific Ruby certificates,
+  * `all`       => Status of all installed Rubies certificate paths.
+* `update`      => Update SSL certificates for current Ruby,
+  * `<ruby>`    => Update a specific Ruby certificates,
+  * `all`       => Update all installed Rubies certificate paths.
+* `cron`        => Manage cron job for daily updates,
+  * `status`    => Show if the cron job is installed,
+  * `install`   => Install the cron job,
+  * `uninstall` => Uninstall the cron job.
+
+## Examples
+
+Show the status for all installed rubies
+
+    rvm osx-ssl-certs status all
+
+Update certificates for current ruby OpenSSL
+
+    rvm osx-ssl-certs status all
+
+Schedule daily update of certificates
+
+    rvm osx-ssl-certs cron install
+
+## Reporting bugs
+
+Please report issues to https://github.com/wayneeseguin/rvm/issues
+
+In case of security issues use rvm-internal@googlegroups.com