/
powder.1.html
252 lines (191 loc) · 8.59 KB
/
powder.1.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
<!DOCTYPE html>
<html>
<head>
<meta http-equiv='content-type' value='text/html;charset=utf8'>
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
<title>powder(1) - manage Pow Rack server</title>
<style type='text/css' media='all'>
/* style: man */
body#manpage {margin:0}
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
.mp h2 {margin:10px 0 0 0}
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
.mp h3 {margin:0 0 0 4ex}
.mp dt {margin:0;clear:left}
.mp dt.flush {float:left;width:8ex}
.mp dd {margin:0 0 0 9ex}
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
.mp pre {margin-bottom:20px}
.mp pre+h2,.mp pre+h3 {margin-top:22px}
.mp h2+pre,.mp h3+pre {margin-top:5px}
.mp img {display:block;margin:auto}
.mp h1.man-title {display:none}
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
.mp h2 {font-size:16px;line-height:1.25}
.mp h1 {font-size:20px;line-height:2}
.mp {text-align:justify;background:#fff}
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
.mp u {text-decoration:underline}
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
.mp b.man-ref {font-weight:normal;color:#434241}
.mp pre {padding:0 4ex}
.mp pre code {font-weight:normal;color:#434241}
.mp h2+pre,h3+pre {padding-left:0}
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
ol.man-decor {width:100%}
ol.man-decor li.tl {text-align:left}
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
ol.man-decor li.tr {text-align:right;float:right}
</style>
</head>
<!--
The following styles are deprecated and will be removed at some point:
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
.man-navigation should be used instead.
-->
<body id='manpage'>
<div class='mp' id='man'>
<div class='man-navigation' style='display:none'>
<a href="#NAME">NAME</a>
<a href="#SYNOPSIS">SYNOPSIS</a>
<a href="#DESCRIPTION">DESCRIPTION</a>
<a href="#HOMEPAGE">HOMEPAGE</a>
<a href="#EXAMPLES">EXAMPLES</a>
<a href="#AUTHOR">AUTHOR</a>
</div>
<ol class='man-decor man-head man head'>
<li class='tl'>powder(1)</li>
<li class='tc'></li>
<li class='tr'>powder(1)</li>
</ol>
<h2 id="NAME">NAME</h2>
<p class="man-name">
<code>powder</code> - <span class="man-whatis">manage Pow Rack server</span>
</p>
<h2 id="SYNOPSIS">SYNOPSIS</h2>
<p><code>powder</code></p>
<h2 id="DESCRIPTION">DESCRIPTION</h2>
<p>Command-line management utility for 37signals' Pow zero-configuration Rack server for OS X (http://pow.cx/).</p>
<h2 id="HOMEPAGE">HOMEPAGE</h2>
<p>https://github.com/Rodreegez/powder</p>
<h2 id="EXAMPLES">EXAMPLES</h2>
<h3 id="Display-usage-information">Display usage information</h3>
<p> <code>$ powder [-h|help]</code><br />
=> Display usage information<br />
# Lists name and brief descriptions of the tasks available</p>
<h3 id="Linking-applications-in-Pow">Linking applications in Pow</h3>
<p>powder will attempt to read .powder, which names a default symlink for the current project</p>
<p> <code>$ powder link</code><br />
=> Link the current dir to ~/.pow/<var>current_directory</var></p>
<p> <code>$ powder link [bacon]</code><br />
=> Link the current dir to ~/.pow/bacon<br />
=> Create .powder, contents bacon</p>
<p> <code>$ powder link [bacon] --no-create</code><br />
=> Link the current dir to ~/.pow/bacon</p>
<p> <code>$ powder link [bacon] --force</code><br />
=> Remove the current pow symlink, and .powder<br />
=> Link the current dir to ~/.pow/bacon<br />
=> Create .powder, contents bacon</p>
<p> <code>$ powder default</code>
=> Link the current dir to ~/.pow/default
# Serve this directory for all unhandled domains</p>
<p>For both forms of link, if the current directory doesn't
look like an app that can be powed it will offer to download
a basic <strong>config.ru</strong> for Rails 2</p>
<h3 id="Unlinking-applications">Unlinking applications</h3>
<p> <code>$ powder unlink</code><br />
=> Unlink current_dir or the symlink defined in .powder</p>
<p> <code>$ powder unlink bacon</code><br />
=> Unlink bacon</p>
<p> <code>$ powder cleanup</code><br />
=> remove all invalid symbolic links</p>
<h3 id="Working-with-Pow">Working with Pow</h3>
<p> <code>$ powder config</code><br />
=> Get Pow's current configuration information</p>
<p> <code>$ powder list</code><br />
=> List all the current apps linked in ~/.pow<br />
# aliased as <code>powder -l</code></p>
<p> <code>$ powder status</code><br />
=> Get Pow's current status information</p>
<p> <code>$ powder version</code><br />
=> Returns the current powder version<br />
# aliased as <code>powder -v</code></p>
<h3 id="Working-with-applications">Working with applications</h3>
<p> <code>$ powder open</code><br />
=> Opens the pow link in a browser<br />
# aliased as powder -o</p>
<p> <code>$ powder open [bacon]</code><br />
=> Opens http://bacon.dev in a browser<br />
# if you have set up alternative top level domains in .powconfig,<br />
# then the first listed domain will be opened.</p>
<p> <code>$ powder open --browser Safari</code>
=> Opens the pow link in a specific browser (in this case, Safari)
# Also aliased as -b</p>
<p> <code>$ powder open -b 'Google Chrome'</code>
=> Opens the pow link with browsers with more than one word</p>
<p> # Should also works with all the other 'open' options:
<code>$ powder open bacon -b Safari</code>
<code>$ powder open --xip -b Firefox</code>
<code>$ powder -o -x -b 'Google Chrome'</code></p>
<h3 id="Managing-application-restarts">Managing application restarts</h3>
<p> <code>$ powder restart</code><br />
=> Restart the current app<br />
# aliased as <code>powder -r</code></p>
<p> <code>$ powder always_restart</code><br />
=> Always restart the current app<br />
# aliased as powder -a</p>
<p> <code>$ powder no_restarts</code><br />
=> don't do any automatic restarting of the current app</p>
<h3 id="Working-with-logs">Working with logs</h3>
<p> <code>$ powder applog</code><br />
=> tail the log of the current app</p>
<p> <code>$ powder log</code><br />
=> Tails the pow log.<br />
# Not the application log, but the pow log, available at<br />
# ~/Library/Logs/Pow/apps/#{app-directory}.log</p>
<h3 id="Working-with-Environment-Variables">Working with Environment Variables</h3>
<p> <code>$ powder env</code>
=> Displays your current custom pow environment variables
# Pow reads environment varialbles from .powenv</p>
<p> <code>$ powder env_reset</code>
=> Deletes your .powevn, removing all custom environment variables.</p>
<p> <code>$ powder env BACON chunky</code>
=> Pass an arbitrary environment variable to pow, eg, ENV["BACON"] = "chunky"
# Remove an ENV by passing in no value, eg: powder env BACON
# If you already have a .gitignore, the newly created .powenv will also be ignored automatically.</p>
<p> <code>$ powder [production|development|test]</code>
=> Run your Rails app as Production
# aliased as powder [prod|dev]
# This is a wrapper for powder env RAILS_ENV ...</p>
<h3 id="Installing-and-uninstalling-Pow">Installing and uninstalling Pow</h3>
<p> <code>$ powder install</code><br />
=> Installs pow server<br />
# (I know, "curl get.pow.cx | sh" isn't hard, but this is <em>even</em> easier)</p>
<p> <code>$ powder uninstall</code><br />
=> Uninstalls pow server</p>
<p> <code>$ powder update</code><br />
=> Updates pow server<br />
# Really this is just an alias to powder install, but it feels more natural<br />
# this way.</p>
<h3 id="Enabling-and-Disabling-Pow">Enabling and Disabling Pow</h3>
<p> <code>$ powder up</code><br />
=> Enable Pow</p>
<p> <code>$ powder down</code><br />
=> Disable Pow</p>
<p> <code>$ powder debug</code>
=> Opens a debug shell with your application environment</p>
<h2 id="AUTHOR">AUTHOR</h2>
<p>Built by <a href="https://github.com/Rodreegez">rodreegez</a> and <a href="https://github.com/philnash">philnash</a>.</p>
<ol class='man-decor man-foot man foot'>
<li class='tl'></li>
<li class='tc'>August 2012</li>
<li class='tr'>powder(1)</li>
</ol>
</div>
</body>
</html>