man/man1/rainbows.1 in rainbows-5.0.0 vs man/man1/rainbows.1 in rainbows-5.0.0.5.ge717

- old
+ new

@@ -1,172 +1,173 @@ -.TH rainbows 1 "December 3, 2009" "Rainbows! User Manual" +.TH "rainbows" "1" "December 3, 2009" "Rainbows! User Manual" "" .SH NAME .PP -rainbows - rackup-like command to launch Rainbows! +rainbows \- rackup\-like command to launch Rainbows! .SH SYNOPSIS .PP -rainbows [-c CONFIG_FILE] [-E RACK_ENV] [-D] [RACKUP_FILE] +rainbows [\-c CONFIG_FILE] [\-E RACK_ENV] [\-D] [RACKUP_FILE] .SH DESCRIPTION .PP -A rackup(1)-like command to launch Rack applications using Rainbows!. +A rackup(1)\-like command to launch Rack applications using Rainbows!. It is expected to be started in your application root (APP_ROOT), but the "working_directory" directive may be used in the CONFIG_FILE. .PP -While Rainbows! takes a myriad of command-line options for compatibility -with ruby(1) and rackup(1), it is recommended to stick to the few -command-line options specified in the SYNOPSIS and use the CONFIG_FILE -as much as possible. +While Rainbows! takes a myriad of command\-line options for +compatibility with ruby(1) and rackup(1), it is recommended to stick to +the few command\-line options specified in the SYNOPSIS and use the +CONFIG_FILE as much as possible. .SH RACKUP FILE .PP This defaults to "config.ru" in APP_ROOT. It should be the same file used by rackup(1) and other Rack launchers, it uses the \f[I]Rack::Builder\f[] DSL. .PP -Embedded command-line options are mostly parsed for compatibility with +Embedded command\-line options are mostly parsed for compatibility with rackup(1) but strongly discouraged. .SH UNICORN OPTIONS .TP -.B -c, --config-file CONFIG_FILE -Path to the Unicorn-specific config file. +.B \-c, \-\-config\-file CONFIG_FILE +Path to the Unicorn\-specific config file. The config file is implemented as a Ruby DSL, so Ruby code may executed. See the RDoc/ri for the \f[I]Unicorn::Configurator\f[] class for the full list of directives available from the DSL. .RS .RE .TP -.B -D, --daemonize +.B \-D, \-\-daemonize Run daemonized in the background. The process is detached from the controlling terminal and stdin is redirected to "/dev/null". Unlike many common UNIX daemons, we do not chdir to "/" upon daemonization to allow more control over the startup/upgrade process. Unless specified in the CONFIG_FILE, stderr and stdout will also be redirected to "/dev/null". .RS .RE .TP -.B -E, --env RACK_ENV +.B \-E, \-\-env RACK_ENV Run under the given RACK_ENV. See the RACK ENVIRONMENT section for more details. .RS .RE .TP -.B -l, --listen ADDRESS +.B \-l, \-\-listen ADDRESS Listens on a given ADDRESS. ADDRESS may be in the form of HOST:PORT or PATH, HOST:PORT is taken to mean a TCP socket and PATH is meant to be a path to a UNIX domain socket. Defaults to "0.0.0.0:8080" (all addresses on TCP port 8080) For production deployments, specifying the "listen" directive in CONFIG_FILE -is recommended as it allows fine-tuning of socket options. +is recommended as it allows fine\-tuning of socket options. .RS .RE .TP -.B -N, --no-default-middleware +.B \-N, \-\-no\-default\-middleware Disables loading middleware implied by RACK_ENV. This bypasses the configuration documented in the RACK ENVIRONMENT section, but still allows RACK_ENV to be used for -application/framework-specific purposes. +application/framework\-specific purposes. .RS .RE .SH RACKUP COMPATIBILITY OPTIONS .TP -.B -o, --host HOST +.B \-o, \-\-host HOST Listen on a TCP socket belonging to HOST, default is "0.0.0.0" (all addresses). -If specified multiple times on the command-line, only the last-specified -value takes effect. +If specified multiple times on the command\-line, only the +last\-specified value takes effect. This option only exists for compatibility with the rackup(1) command, -use of "-l"/"--listen" switch is recommended instead. +use of "\-l"/"\-\-listen" switch is recommended instead. .RS .RE .TP -.B -p, --port PORT +.B \-p, \-\-port PORT Listen on the specified TCP PORT, default is 8080. -If specified multiple times on the command-line, only the last-specified -value takes effect. +If specified multiple times on the command\-line, only the +last\-specified value takes effect. This option only exists for compatibility with the rackup(1) command, -use of "-l"/"--listen" switch is recommended instead. +use of "\-l"/"\-\-listen" switch is recommended instead. .RS .RE .TP -.B -s, --server SERVER -No-op, this exists only for compatibility with rackup(1). +.B \-s, \-\-server SERVER +No\-op, this exists only for compatibility with rackup(1). .RS .RE .SH RUBY OPTIONS .TP -.B -e, --eval LINE +.B \-e, \-\-eval LINE Evaluate a LINE of Ruby code. -This evaluation happens immediately as the command-line is being parsed. +This evaluation happens immediately as the command\-line is being +parsed. .RS .RE .TP -.B -d, --debug +.B \-d, \-\-debug Turn on debug mode, the $DEBUG variable is set to true. .RS .RE .TP -.B -w, --warn +.B \-w, \-\-warn Turn on verbose warnings, the $VERBOSE variable is set to true. .RS .RE .TP -.B -I, --include PATH -specify $LOAD_PATH. -PATH will be prepended to $LOAD_PATH. +.B \-I, \-\-include PATH +specify +\f[I]L\f[]\f[I]O\f[]\f[I]A\f[]\f[I]D\f[]~\f[I]P\f[]~\f[I]A\f[]\f[I]T\f[]\f[I]H\f[].\f[I]P\f[]\f[I]A\f[]\f[I]T\f[]\f[I]H\f[]\f[I]w\f[]\f[I]i\f[]\f[I]l\f[]\f[I]l\f[]\f[I]b\f[]\f[I]e\f[]\f[I]p\f[]\f[I]r\f[]\f[I]e\f[]\f[I]p\f[]\f[I]e\f[]\f[I]n\f[]\f[I]d\f[]\f[I]e\f[]\f[I]d\f[]\f[I]t\f[]\f[I]o\f[]LOAD_PATH. The \[aq]:\[aq] character may be used to delimit multiple directories. This directive may be used more than once. Modifications to $LOAD_PATH take place immediately and in the order they -were specified on the command-line. +were specified on the command\-line. .RS .RE .TP -.B -r, --require LIBRARY +.B \-r, \-\-require LIBRARY require a specified LIBRARY before executing the application. The "require" statement will be executed immediately and in the order -they were specified on the command-line. +they were specified on the command\-line. .RS .RE .SH SIGNALS .PP The following UNIX signals may be sent to the master process: .IP \[bu] 2 -HUP - reload config file, app, and gracefully restart all workers +HUP \- reload config file, app, and gracefully restart all workers .IP \[bu] 2 -INT/TERM - quick shutdown, kills all workers immediately +INT/TERM \- quick shutdown, kills all workers immediately .IP \[bu] 2 -QUIT - graceful shutdown, waits for workers to finish their current +QUIT \- graceful shutdown, waits for workers to finish their current request before finishing. .IP \[bu] 2 -USR1 - reopen all logs owned by the master and all workers See +USR1 \- reopen all logs owned by the master and all workers See Unicorn::Util.reopen_logs for what is considered a log. .IP \[bu] 2 -USR2 - reexecute the running binary. +USR2 \- reexecute the running binary. A separate QUIT should be sent to the original process once the child is verified to be up and running. .IP \[bu] 2 -WINCH - gracefully stops workers but keep the master running. +WINCH \- gracefully stops workers but keep the master running. This will only work for daemonized processes. .IP \[bu] 2 -TTIN - increment the number of worker processes by one +TTIN \- increment the number of worker processes by one .IP \[bu] 2 -TTOU - decrement the number of worker processes by one +TTOU \- decrement the number of worker processes by one .PP -See the SIGNALS (http://rainbows.bogomips.org/SIGNALS.html) document for -full description of all signals used by Rainbows!. +See the SIGNALS (https://bogomips.org/rainbows/SIGNALS.html) document +for full description of all signals used by Rainbows!. .SH RACK ENVIRONMENT .PP Accepted values of RACK_ENV and the middleware they automatically load (outside of RACKUP_FILE) are exactly as those in rackup(1): .IP \[bu] 2 -development - loads Rack::CommonLogger, Rack::ShowExceptions, and +development \- loads Rack::CommonLogger, Rack::ShowExceptions, and Rack::Lint middleware .IP \[bu] 2 -deployment - loads Rack::CommonLogger middleware +deployment \- loads Rack::CommonLogger middleware .IP \[bu] 2 -none - loads no middleware at all, relying entirely on RACKUP_FILE +none \- loads no middleware at all, relying entirely on RACKUP_FILE .PP All unrecognized values for RACK_ENV are assumed to be "none". Production deployments are strongly encouraged to use "deployment" or "none" for maximum performance. .PP @@ -181,10 +182,10 @@ .IP \[bu] 2 \f[I]Rack::Builder\f[] ri/RDoc .IP \[bu] 2 \f[I]Unicorn::Configurator\f[] ri/RDoc .IP \[bu] 2 -Rainbows! RDoc (http://rainbows.bogomips.org/) +Rainbows! RDoc (https://bogomips.org/rainbows/) .IP \[bu] 2 Rack RDoc (http://rdoc.info/gems/r#/gems/rack/frames) .IP \[bu] 2 Rackup HowTo (http://wiki.github.com/rack/rack/tutorial-rackup-howto) .SH AUTHORS