aboutsummaryrefslogtreecommitdiff
path: root/readme.textile
diff options
context:
space:
mode:
authorNat Lasseter <user@4574.co.uk>2017-01-19 10:54:32 +0000
committerNat Lasseter <user@4574.co.uk>2017-01-19 10:54:32 +0000
commit07a17b442d7d7a397d076babfaa29fd2620921d7 (patch)
tree03d9095590bfe16b15d11b944b527c6d43b49e41 /readme.textile
Initial commit
Diffstat (limited to 'readme.textile')
-rw-r--r--readme.textile36
1 files changed, 36 insertions, 0 deletions
diff --git a/readme.textile b/readme.textile
new file mode 100644
index 0000000..e0c69ea
--- /dev/null
+++ b/readme.textile
@@ -0,0 +1,36 @@
+h1. SSHConfig
+
+This is a gem which allows you to programatically configure your ~/.ssh/config.
+
+It's a bit bad, but it works.
+
+h2. Config file
+
+Your new file to worry about is ~/.ssh/sshconfig.
+
+h2. ssh-update-config
+
+The @ssh-update-config@ command will generate the ~/.ssh/config file for you. The file will be overwritten.
+
+h2. Directives
+
+In the block you pass to a host method, any method becomes an sshconfig directive. It's method_missing_madness!
+
+h2. It's all ruby!
+
+h3. So write ruby!
+
+Methods, loops, variables; you name it.
+
+h3. $hostlist variable
+
+The grand list of hosts is stored in @$hostlist@. It's a @Hosts@ object. You can touch this. The @hosts {}@ method appends to this list. @$hostlist.host{}@ does the same as @hosts{host{}}@.
+
+h2. Building
+
+bc. gem build sshconfig.gemspec
+ gem install --user-install sshconfig
+
+h2. Example
+
+There's an example file, take a look.