swift/doc/manpages
Samuel Merritt d69f929be9 Add "normal", optparse-style options to swift-ring-builder add.
The old format is still present and works just like it did before, so
your existing scripts won't break.

New format pros:
 * it's readable even for Swift newcomers
 * it's easy to extend
 * it's familiar to anyone who's used a Unix command line
 * we don't have to maintain the parser

New format cons:
 * you can't add multiple devices in one go

Old format pros:
 * you can add many devices with one command
 * it's compact

Old format cons:
 * it confuses newcomers
 * "wait, is that zone dash IP colon port slash device, or zone slash
   IP dash port colon meta underscore device?" Just try walking
   someone through adding a device over voice chat.
 * it's annoying to add new fields

Note that this only affects the command "swift-ring-builder
<builderfile> add". Other swift-ring-builder commands are unchanged.

DocImpact

Change-Id: I034b7f79eb6f4d81a5c4da193e1358741441c5b5
2013-06-10 14:09:27 -07:00
..
account-server.conf.5 Add the max_clients parameter to bound clients 2013-04-26 10:29:57 -04:00
container-server.conf.5 Add the max_clients parameter to bound clients 2013-04-26 10:29:57 -04:00
dispersion.conf.5 Add auth_version to dispersion.conf.5 2013-04-22 11:31:21 -06:00
object-expirer.conf.5 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
object-server.conf.5 implement an rsync_bwlimit setting for object replicator 2013-05-31 15:57:19 -04:00
proxy-server.conf.5 Add the max_clients parameter to bound clients 2013-04-26 10:29:57 -04:00
swift-account-auditor.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-account-reaper.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-account-replicator.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-account-server.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-container-auditor.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-container-replicator.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-container-server.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-container-sync.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-container-updater.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-dispersion-populate.1 Merge "Replaces Copyright statements for LLC with Foundation, removes date." 2013-02-12 06:25:45 +00:00
swift-dispersion-report.1 Merge "Replaces Copyright statements for LLC with Foundation, removes date." 2013-02-12 06:25:45 +00:00
swift-get-nodes.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-init.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-object-auditor.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-object-expirer.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-object-info.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-object-replicator.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-object-server.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-object-updater.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-orphans.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-proxy-server.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-recon.1 Replaces Copyright statements for LLC with Foundation, removes date. 2013-02-11 16:32:33 -06:00
swift-ring-builder.1 Add "normal", optparse-style options to swift-ring-builder add. 2013-06-10 14:09:27 -07:00