Ticket #1420: add-man-page.darcs.patch

File add-man-page.darcs.patch, 21.9 KB (added by davidsarah, at 2011-07-24T18:17:35Z)

docs/man/tahoe.1: add man page. fixes #1420

Line 
11 patch for repository davidsarah@dev.allmydata.org:/home/darcs/tahoe/trunk:
2
3Sun Jul 24 18:17:28 BST 2011  david-sarah@jacaranda.org
4  * docs/man/tahoe.1: add man page. fixes #1420
5
6New patches:
7
8[docs/man/tahoe.1: add man page. fixes #1420
9david-sarah@jacaranda.org**20110724171728
10 Ignore-this: fc7601ec7f25494288d6141d0ae0004c
11] {
12adddir ./docs/man
13addfile ./docs/man/tahoe.1
14hunk ./docs/man/tahoe.1 1
15+.TH TAHOE 1 "July 2011" "Tahoe-LAFS \[em] tahoe command" "User Commands"
16+.SH NAME
17+.PP
18+tahoe - Secure distributed filesystem.
19+.SH SYNOPSIS
20+.PP
21+tahoe \f[I]COMMAND\f[] [\f[I]OPTION\f[]]... [\f[I]PARAMETER\f[]]...
22+.SH GENERAL OPTIONS
23+.TP
24+.B \f[B]-q,\ --quiet\f[]
25+Operate silently.
26+.RS
27+.RE
28+.TP
29+.B \f[B]-V,\ --version\f[]
30+Display version numbers.
31+.RS
32+.RE
33+.TP
34+.B \f[B]--version-and-path\f[]
35+Display version numbers and paths to their locations.
36+.RS
37+.RE
38+.TP
39+.B \f[B]-d,\ --node-directory\f[]
40+Specify which Tahoe node directory should be used.
41+(default for most commands: `$HOME/.tahoe')
42+.RS
43+.RE
44+.SH COMMANDS
45+.PP
46+The \f[B]tahoe\f[] runner can be used for various tasks depending
47+on the command used.
48+.SS ADMINISTRATION
49+.PP
50+tahoe \f[I]COMMAND\f[] [\f[I]OPTION\f[]]... [\f[I]NODEDIR\f[]]
51+.RS
52+.SS COMMANDS
53+.TP
54+.B \f[B]create-node\f[]
55+Create a node that acts as a client, server or both.
56+.TP
57+.B \f[B]create-client\f[]
58+Create a client node (with storage initially disabled).
59+.TP
60+.B \f[B]create-introducer\f[]
61+Create an introducer node.
62+.TP
63+.B \f[B]create-key-generator\f[]
64+Create a key generator service.
65+.TP
66+.B \f[B]create-stats-gatherer\f[]
67+Create a stats-gatherer service.
68+.SS OPTIONS
69+.TP
70+.B \f[B]-C,\ --basedir=\f[]
71+Same as \[em]node-directory.
72+.TP
73+.B \f[B]-d,\ --node-directory=\f[]
74+Specify which Tahoe node directory should be used.
75+(default for \f[B]create-node\f[] and \f[B]create-client\f[]:
76+`$HOME/.tahoe/').
77+.TP
78+.B \f[B]-n,\ --nickname=\f[]
79+Specify the nickname for this node (\f[B]create-node\f[] and
80+\f[B]create-client\f[] only).
81+.TP
82+.B \f[B]-i,\ --introducer=\f[]
83+Specify the introducer FURL to use (\f[B]create-node\f[] and
84+\f[B]create-client\f[] only).
85+.TP
86+.B \f[B]-p,\ --webport=\f[]
87+Specify which TCP port to run the HTTP interface on.
88+Use `none' to disable.
89+Default: `tcp:3456:interface=127.0.0.1' (\f[B]create-node\f[] and
90+\f[B]create-client\f[] only).
91+.TP
92+.B \f[B]--no-storage\f[]
93+Do not offer storage service to other nodes (\f[B]create-node\f[]
94+only).
95+.RE
96+.SS CONTROLLING NODES
97+.PP
98+tahoe \f[I]COMMAND\f[] [\f[I]OPTION\f[]]... [\f[I]NODEDIR\f[]]
99+.SS COMMANDS
100+.TP
101+.B \f[B]start\f[]
102+Start a node (of any type).
103+.RS
104+.RE
105+.TP
106+.B \f[B]stop\f[]
107+Stop a node.
108+.RS
109+.RE
110+.TP
111+.B \f[B]restart\f[]
112+Restart a node.
113+.RS
114+.RE
115+.TP
116+.B \f[B]run\f[]
117+Run a node synchronously.
118+.RS
119+.RE
120+.SS OPTIONS
121+.TP
122+.B \f[B]-p,\ --profile\f[]
123+Run under the Python profiler, putting results in
124+`profiling_results.prof' (use with \f[B]start\f[] or
125+\f[B]restart\f[] only).
126+.RS
127+.RE
128+.TP
129+.B \f[B]--syslog\f[]
130+Tell the node to log to syslog, not a file (use with \f[B]start\f[]
131+or \f[B]restart\f[] only).
132+.RS
133+.RE
134+.TP
135+.B \f[B]-C,\ --basedir=\f[]
136+Same as \[em]node-directory.
137+.RS
138+.RE
139+.TP
140+.B \f[B]-d,\ --node-directory=\f[]
141+Specify which Tahoe node directory should be used (default for commands
142+other than \f[B]run\f[]: `$HOME/.tahoe/').
143+.RS
144+.RE
145+.TP
146+.B \f[B]--help\f[]
147+Display help and exit
148+.RS
149+.RE
150+.SS USING THE FILSYSTEM
151+.TP
152+.B \f[B]mkdir\f[]
153+Create a new directory.
154+.RS
155+.RE
156+.TP
157+.B \f[B]add-alias\f[]
158+Add a new alias cap.
159+.RS
160+.RE
161+.TP
162+.B \f[B]create-alias\f[]
163+Create a new alias cap.
164+.RS
165+.RE
166+.TP
167+.B \f[B]list-aliases\f[]
168+List all alias caps.
169+.RS
170+.RE
171+.TP
172+.B \f[B]ls\f[]
173+List a directory.
174+.RS
175+.RE
176+.TP
177+.B \f[B]get\f[]
178+Retrieve a file from the grid.
179+.RS
180+.RE
181+.TP
182+.B \f[B]put\f[]
183+Upload a file into the grid.
184+.RS
185+.RE
186+.TP
187+.B \f[B]cp\f[]
188+Copy one or more files or directories.
189+.RS
190+.RE
191+.TP
192+.B \f[B]unlink\f[]
193+Unlink a file or directory on the grid.
194+.RS
195+.RE
196+.TP
197+.B \f[B]rm\f[]
198+Unlink a file or directory on the grid (same as \f[B]unlink\f[]).
199+.RS
200+.RE
201+.TP
202+.B \f[B]mv\f[]
203+Move a file within the grid.
204+.RS
205+.RE
206+.TP
207+.B \f[B]ln\f[]
208+Make an additional link to an existing file or directory.
209+.RS
210+.RE
211+.TP
212+.B \f[B]backup\f[]
213+Make target dir look like local dir.
214+.RS
215+.RE
216+.TP
217+.B \f[B]webopen\f[]
218+Open a web browser to a grid file or directory.
219+.RS
220+.RE
221+.TP
222+.B \f[B]manifest\f[]
223+List all files/directories in a subtree.
224+.RS
225+.RE
226+.TP
227+.B \f[B]stats\f[]
228+Print statistics about all files/directories in a subtree.
229+.RS
230+.RE
231+.TP
232+.B \f[B]check\f[]
233+Check a single file or directory.
234+.RS
235+.RE
236+.TP
237+.B \f[B]deep-check\f[]
238+Check all files/directories reachable from a starting point
239+.RS
240+.RE
241+.SS OPTIONS
242+.PP
243+Please run `tahoe \f[I]COMMAND\f[] --help' for more details on each
244+command.
245+.SS DEBUGGING
246+.PP
247+tahoe debug \f[I]SUBCOMMAND\f[] [\f[I]OPTION\f[]]... [\f[I]PARAMETER\f[]]...
248+.SS SUBCOMMANDS
249+.TP
250+.B \f[B]dump-share\f[]
251+Unpack and display the contents of a share.
252+.RS
253+.RE
254+.TP
255+.B \f[B]dump-cap\f[]
256+Unpack a read-cap or write-cap.
257+.RS
258+.RE
259+.TP
260+.B \f[B]find-shares\f[]
261+Locate sharefiles in node directories.
262+.RS
263+.RE
264+.TP
265+.B \f[B]catalog-shares\f[]
266+Describe all shares in node dirs.
267+.RS
268+.RE
269+.TP
270+.B \f[B]corrupt-share\f[]
271+Corrupt a share by flipping a bit.
272+.RS
273+.RE
274+.TP
275+.B \f[B]repl\f[]
276+Open a Python interpreter.
277+.RS
278+.RE
279+.TP
280+.B \f[B]trial\f[]
281+Run tests using Twisted Trial with the right imports.
282+.RS
283+.RE
284+.PP
285+Please run e.g.\ `tahoe debug dump-share --help' for more
286+details on each subcommand.
287+.SH AUTHORS
288+.PP
289+Tahoe-LAFS has been written by Brian Warner, Zooko Wilcox-O'Hearn
290+and dozens of others.
291+This manpage was originally written by bertagaz.
292+.SH REPORTING BUGS
293+.PP
294+Please see <http://tahoe-lafs.org/trac/tahoe-lafs/wiki/HowToReportABug>.
295+.PP
296+For known security issues see
297+<http://tahoe-lafs.org/trac/tahoe-lafs/browser/docs/known_issues.rst>.
298+.PP
299+Tahoe-LAFS home page: <http://tahoe-lafs.org/>
300+.PP
301+tahoe-dev mailing list: <http://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev>
302+.SH COPYRIGHT
303+.PP
304+2006\[en]2011 \@ AllMyData, Inc.
305+
306}
307
308Context:
309
310[misc/build_helpers/run_trial.py: undo change to block pywin32 (it didn't work because run_trial.py is no longer used). refs #1334
311david-sarah@jacaranda.org**20110722035402
312 Ignore-this: 5d03f544c4154f088e26c7107494bf39
313]
314[misc/build_helpers/run_trial.py: ensure that pywin32 is not on the sys.path when running the test suite. Includes some temporary debugging printouts that will be removed. refs #1334
315david-sarah@jacaranda.org**20110722024907
316 Ignore-this: 5141a9f83a4085ed4ca21f0bbb20bb9c
317]
318[frontends/ftpd.py: remove the check for IWriteFile.close since we're now guaranteed to be using Twisted >= 10.1 which has it.
319david-sarah@jacaranda.org**20110722000320
320 Ignore-this: 55cd558b791526113db3f83c00ec328a
321]
322[Update the dependency on zope.interface to fix an incompatiblity between Nevow and zope.interface 3.6.4. fixes #1435
323david-sarah@jacaranda.org**20110721234941
324 Ignore-this: 2ff3fcfc030fca1a4d4c7f1fed0f2aa9
325]
326[Update the dependency on Twisted to >= 10.1. This allows us to simplify some documentation: it's no longer necessary to install pywin32 on Windows, or apply a patch to Twisted in order to use the FTP frontend. fixes #1274, #1438. refs #1429
327david-sarah@jacaranda.org**20110721233658
328 Ignore-this: 81b41745477163c9b39c0b59db91cc62
329]
330[docs/running.rst: use 'tahoe run ~/.tahoe' instead of 'tahoe run' (the default is the current directory, unlike 'tahoe start').
331david-sarah@jacaranda.org**20110718005949
332 Ignore-this: 81837fbce073e93d88a3e7ae3122458c
333]
334[docs/running.rst: say to put the introducer.furl in tahoe.cfg.
335david-sarah@jacaranda.org**20110717194315
336 Ignore-this: 954cc4c08e413e8c62685d58ff3e11f3
337]
338[setup: remove the dependency on foolscap's "secure_connections" extra, add a dependency on pyOpenSSL
339zooko@zooko.com**20110717114226
340 Ignore-this: df222120d41447ce4102616921626c82
341 fixes #1383
342]
343[docs: add missing link in NEWS.rst
344zooko@zooko.com**20110712153307
345 Ignore-this: be7b7eb81c03700b739daa1027d72b35
346]
347[contrib: remove the contributed fuse modules and the entire contrib/ directory, which is now empty
348zooko@zooko.com**20110712153229
349 Ignore-this: 723c4f9e2211027c79d711715d972c5
350 Also remove a couple of vestigial references to figleaf, which is long gone.
351 fixes #1409 (remove contrib/fuse)
352]
353[README.txt: say that quickstart.rst is in the docs directory.
354david-sarah@jacaranda.org**20110717192400
355 Ignore-this: bc6d35a85c496b77dbef7570677ea42a
356]
357[test_sftp.py cleanup: remove a redundant definition of failUnlessReallyEqual.
358david-sarah@jacaranda.org**20110716181813
359 Ignore-this: 50113380b368c573f07ac6fe2eb1e97f
360]
361[add Protovis.js-based download-status timeline visualization
362Brian Warner <warner@lothar.com>**20110629222606
363 Ignore-this: 477ccef5c51b30e246f5b6e04ab4a127
364 
365 provide status overlap info on the webapi t=json output, add decode/decrypt
366 rate tooltips, add zoomin/zoomout buttons
367]
368[add more download-status data, fix tests
369Brian Warner <warner@lothar.com>**20110629222555
370 Ignore-this: e9e0b7e0163f1e95858aa646b9b17b8c
371]
372[prepare for viz: improve DownloadStatus events
373Brian Warner <warner@lothar.com>**20110629222542
374 Ignore-this: 16d0bde6b734bb501aa6f1174b2b57be
375 
376 consolidate IDownloadStatusHandlingConsumer stuff into DownloadNode
377]
378[docs: fix error in crypto specification that was noticed by Taylor R Campbell <campbell+tahoe@mumble.net>
379zooko@zooko.com**20110629185711
380 Ignore-this: b921ed60c1c8ba3c390737fbcbe47a67
381]
382[setup.py: don't make bin/tahoe.pyscript executable. fixes #1347
383david-sarah@jacaranda.org**20110130235809
384 Ignore-this: 3454c8b5d9c2c77ace03de3ef2d9398a
385]
386[Makefile: remove targets relating to 'setup.py check_auto_deps' which no longer exists. fixes #1345
387david-sarah@jacaranda.org**20110626054124
388 Ignore-this: abb864427a1b91bd10d5132b4589fd90
389]
390[Makefile: add 'make check' as an alias for 'make test'. Also remove an unnecessary dependency of 'test' on 'build' and 'src/allmydata/_version.py'. fixes #1344
391david-sarah@jacaranda.org**20110623205528
392 Ignore-this: c63e23146c39195de52fb17c7c49b2da
393]
394[Rename test_package_initialization.py to (much shorter) test_import.py .
395Brian Warner <warner@lothar.com>**20110611190234
396 Ignore-this: 3eb3dbac73600eeff5cfa6b65d65822
397 
398 The former name was making my 'ls' listings hard to read, by forcing them
399 down to just two columns.
400]
401[tests: fix tests to accomodate [20110611153758-92b7f-0ba5e4726fb6318dac28fb762a6512a003f4c430]
402zooko@zooko.com**20110611163741
403 Ignore-this: 64073a5f39e7937e8e5e1314c1a302d1
404 Apparently none of the two authors (stercor, terrell), three reviewers (warner, davidsarah, terrell), or one committer (me) actually ran the tests. This is presumably due to #20.
405 fixes #1412
406]
407[wui: right-align the size column in the WUI
408zooko@zooko.com**20110611153758
409 Ignore-this: 492bdaf4373c96f59f90581c7daf7cd7
410 Thanks to Ted "stercor" Rolle Jr. and Terrell Russell.
411 fixes #1412
412]
413[docs: three minor fixes
414zooko@zooko.com**20110610121656
415 Ignore-this: fec96579eb95aceb2ad5fc01a814c8a2
416 CREDITS for arc for stats tweak
417 fix link to .zip file in quickstart.rst (thanks to ChosenOne for noticing)
418 English usage tweak
419]
420[docs/running.rst: fix stray HTML (not .rst) link noticed by ChosenOne.
421david-sarah@jacaranda.org**20110609223719
422 Ignore-this: fc50ac9c94792dcac6f1067df8ac0d4a
423]
424[server.py:  get_latencies now reports percentiles _only_ if there are sufficient observations for the interpretation of the percentile to be unambiguous.
425wilcoxjg@gmail.com**20110527120135
426 Ignore-this: 2e7029764bffc60e26f471d7c2b6611e
427 interfaces.py:  modified the return type of RIStatsProvider.get_stats to allow for None as a return value
428 NEWS.rst, stats.py: documentation of change to get_latencies
429 stats.rst: now documents percentile modification in get_latencies
430 test_storage.py:  test_latencies now expects None in output categories that contain too few samples for the associated percentile to be unambiguously reported.
431 fixes #1392
432]
433[docs: revert link in relnotes.txt from NEWS.rst to NEWS, since the former did not exist at revision 5000.
434david-sarah@jacaranda.org**20110517011214
435 Ignore-this: 6a5be6e70241e3ec0575641f64343df7
436]
437[docs: convert NEWS to NEWS.rst and change all references to it.
438david-sarah@jacaranda.org**20110517010255
439 Ignore-this: a820b93ea10577c77e9c8206dbfe770d
440]
441[docs: remove out-of-date docs/testgrid/introducer.furl and containing directory. fixes #1404
442david-sarah@jacaranda.org**20110512140559
443 Ignore-this: 784548fc5367fac5450df1c46890876d
444]
445[scripts/common.py: don't assume that the default alias is always 'tahoe' (it is, but the API of get_alias doesn't say so). refs #1342
446david-sarah@jacaranda.org**20110130164923
447 Ignore-this: a271e77ce81d84bb4c43645b891d92eb
448]
449[setup: don't catch all Exception from check_requirement(), but only PackagingError and ImportError
450zooko@zooko.com**20110128142006
451 Ignore-this: 57d4bc9298b711e4bc9dc832c75295de
452 I noticed this because I had accidentally inserted a bug which caused AssertionError to be raised from check_requirement().
453]
454[M-x whitespace-cleanup
455zooko@zooko.com**20110510193653
456 Ignore-this: dea02f831298c0f65ad096960e7df5c7
457]
458[docs: fix typo in running.rst, thanks to arch_o_median
459zooko@zooko.com**20110510193633
460 Ignore-this: ca06de166a46abbc61140513918e79e8
461]
462[relnotes.txt: don't claim to work on Cygwin (which has been untested for some time). refs #1342
463david-sarah@jacaranda.org**20110204204902
464 Ignore-this: 85ef118a48453d93fa4cddc32d65b25b
465]
466[relnotes.txt: forseeable -> foreseeable. refs #1342
467david-sarah@jacaranda.org**20110204204116
468 Ignore-this: 746debc4d82f4031ebf75ab4031b3a9
469]
470[replace remaining .html docs with .rst docs
471zooko@zooko.com**20110510191650
472 Ignore-this: d557d960a986d4ac8216d1677d236399
473 Remove install.html (long since deprecated).
474 Also replace some obsolete references to install.html with references to quickstart.rst.
475 Fix some broken internal references within docs/historical/historical_known_issues.txt.
476 Thanks to Ravi Pinjala and Patrick McDonald.
477 refs #1227
478]
479[docs: FTP-and-SFTP.rst: fix a minor error and update the information about which version of Twisted fixes #1297
480zooko@zooko.com**20110428055232
481 Ignore-this: b63cfb4ebdbe32fb3b5f885255db4d39
482]
483[munin tahoe_files plugin: fix incorrect file count
484francois@ctrlaltdel.ch**20110428055312
485 Ignore-this: 334ba49a0bbd93b4a7b06a25697aba34
486 fixes #1391
487]
488[corrected "k must never be smaller than N" to "k must never be greater than N"
489secorp@allmydata.org**20110425010308
490 Ignore-this: 233129505d6c70860087f22541805eac
491]
492[Fix a test failure in test_package_initialization on Python 2.4.x due to exceptions being stringified differently than in later versions of Python. refs #1389
493david-sarah@jacaranda.org**20110411190738
494 Ignore-this: 7847d26bc117c328c679f08a7baee519
495]
496[tests: add test for including the ImportError message and traceback entry in the summary of errors from importing dependencies. refs #1389
497david-sarah@jacaranda.org**20110410155844
498 Ignore-this: fbecdbeb0d06a0f875fe8d4030aabafa
499]
500[allmydata/__init__.py: preserve the message and last traceback entry (file, line number, function, and source line) of ImportErrors in the package versions string. fixes #1389
501david-sarah@jacaranda.org**20110410155705
502 Ignore-this: 2f87b8b327906cf8bfca9440a0904900
503]
504[remove unused variable detected by pyflakes
505zooko@zooko.com**20110407172231
506 Ignore-this: 7344652d5e0720af822070d91f03daf9
507]
508[allmydata/__init__.py: Nicer reporting of unparseable version numbers in dependencies. fixes #1388
509david-sarah@jacaranda.org**20110401202750
510 Ignore-this: 9c6bd599259d2405e1caadbb3e0d8c7f
511]
512[update FTP-and-SFTP.rst: the necessary patch is included in Twisted-10.1
513Brian Warner <warner@lothar.com>**20110325232511
514 Ignore-this: d5307faa6900f143193bfbe14e0f01a
515]
516[control.py: remove all uses of s.get_serverid()
517warner@lothar.com**20110227011203
518 Ignore-this: f80a787953bd7fa3d40e828bde00e855
519]
520[web: remove some uses of s.get_serverid(), not all
521warner@lothar.com**20110227011159
522 Ignore-this: a9347d9cf6436537a47edc6efde9f8be
523]
524[immutable/downloader/fetcher.py: remove all get_serverid() calls
525warner@lothar.com**20110227011156
526 Ignore-this: fb5ef018ade1749348b546ec24f7f09a
527]
528[immutable/downloader/fetcher.py: fix diversity bug in server-response handling
529warner@lothar.com**20110227011153
530 Ignore-this: bcd62232c9159371ae8a16ff63d22c1b
531 
532 When blocks terminate (either COMPLETE or CORRUPT/DEAD/BADSEGNUM), the
533 _shares_from_server dict was being popped incorrectly (using shnum as the
534 index instead of serverid). I'm still thinking through the consequences of
535 this bug. It was probably benign and really hard to detect. I think it would
536 cause us to incorrectly believe that we're pulling too many shares from a
537 server, and thus prefer a different server rather than asking for a second
538 share from the first server. The diversity code is intended to spread out the
539 number of shares simultaneously being requested from each server, but with
540 this bug, it might be spreading out the total number of shares requested at
541 all, not just simultaneously. (note that SegmentFetcher is scoped to a single
542 segment, so the effect doesn't last very long).
543]
544[immutable/downloader/share.py: reduce get_serverid(), one left, update ext deps
545warner@lothar.com**20110227011150
546 Ignore-this: d8d56dd8e7b280792b40105e13664554
547 
548 test_download.py: create+check MyShare instances better, make sure they share
549 Server objects, now that finder.py cares
550]
551[immutable/downloader/finder.py: reduce use of get_serverid(), one left
552warner@lothar.com**20110227011146
553 Ignore-this: 5785be173b491ae8a78faf5142892020
554]
555[immutable/offloaded.py: reduce use of get_serverid() a bit more
556warner@lothar.com**20110227011142
557 Ignore-this: b48acc1b2ae1b311da7f3ba4ffba38f
558]
559[immutable/upload.py: reduce use of get_serverid()
560warner@lothar.com**20110227011138
561 Ignore-this: ffdd7ff32bca890782119a6e9f1495f6
562]
563[immutable/checker.py: remove some uses of s.get_serverid(), not all
564warner@lothar.com**20110227011134
565 Ignore-this: e480a37efa9e94e8016d826c492f626e
566]
567[add remaining get_* methods to storage_client.Server, NoNetworkServer, and
568warner@lothar.com**20110227011132
569 Ignore-this: 6078279ddf42b179996a4b53bee8c421
570 MockIServer stubs
571]
572[upload.py: rearrange _make_trackers a bit, no behavior changes
573warner@lothar.com**20110227011128
574 Ignore-this: 296d4819e2af452b107177aef6ebb40f
575]
576[happinessutil.py: finally rename merge_peers to merge_servers
577warner@lothar.com**20110227011124
578 Ignore-this: c8cd381fea1dd888899cb71e4f86de6e
579]
580[test_upload.py: factor out FakeServerTracker
581warner@lothar.com**20110227011120
582 Ignore-this: 6c182cba90e908221099472cc159325b
583]
584[test_upload.py: server-vs-tracker cleanup
585warner@lothar.com**20110227011115
586 Ignore-this: 2915133be1a3ba456e8603885437e03
587]
588[happinessutil.py: server-vs-tracker cleanup
589warner@lothar.com**20110227011111
590 Ignore-this: b856c84033562d7d718cae7cb01085a9
591]
592[upload.py: more tracker-vs-server cleanup
593warner@lothar.com**20110227011107
594 Ignore-this: bb75ed2afef55e47c085b35def2de315
595]
596[upload.py: fix var names to avoid confusion between 'trackers' and 'servers'
597warner@lothar.com**20110227011103
598 Ignore-this: 5d5e3415b7d2732d92f42413c25d205d
599]
600[refactor: s/peer/server/ in immutable/upload, happinessutil.py, test_upload
601warner@lothar.com**20110227011100
602 Ignore-this: 7ea858755cbe5896ac212a925840fe68
603 
604 No behavioral changes, just updating variable/method names and log messages.
605 The effects outside these three files should be minimal: some exception
606 messages changed (to say "server" instead of "peer"), and some internal class
607 names were changed. A few things still use "peer" to minimize external
608 changes, like UploadResults.timings["peer_selection"] and
609 happinessutil.merge_peers, which can be changed later.
610]
611[storage_client.py: clean up test_add_server/test_add_descriptor, remove .test_servers
612warner@lothar.com**20110227011056
613 Ignore-this: efad933e78179d3d5fdcd6d1ef2b19cc
614]
615[test_client.py, upload.py:: remove KiB/MiB/etc constants, and other dead code
616warner@lothar.com**20110227011051
617 Ignore-this: dc83c5794c2afc4f81e592f689c0dc2d
618]
619[test: increase timeout on a network test because Francois's ARM machine hit that timeout
620zooko@zooko.com**20110317165909
621 Ignore-this: 380c345cdcbd196268ca5b65664ac85b
622 I'm skeptical that the test was proceeding correctly but ran out of time. It seems more likely that it had gotten hung. But if we raise the timeout to an even more extravagant number then we can be even more certain that the test was never going to finish.
623]
624[docs/configuration.rst: add a "Frontend Configuration" section
625Brian Warner <warner@lothar.com>**20110222014323
626 Ignore-this: 657018aa501fe4f0efef9851628444ca
627 
628 this points to docs/frontends/*.rst, which were previously underlinked
629]
630[web/filenode.py: avoid calling req.finish() on closed HTTP connections. Closes #1366
631"Brian Warner <warner@lothar.com>"**20110221061544
632 Ignore-this: 799d4de19933f2309b3c0c19a63bb888
633]
634[Add unit tests for cross_check_pkg_resources_versus_import, and a regression test for ref #1355. This requires a little refactoring to make it testable.
635david-sarah@jacaranda.org**20110221015817
636 Ignore-this: 51d181698f8c20d3aca58b057e9c475a
637]
638[allmydata/__init__.py: .name was used in place of the correct .__name__ when printing an exception. Also, robustify string formatting by using %r instead of %s in some places. fixes #1355.
639david-sarah@jacaranda.org**20110221020125
640 Ignore-this: b0744ed58f161bf188e037bad077fc48
641]
642[Refactor StorageFarmBroker handling of servers
643Brian Warner <warner@lothar.com>**20110221015804
644 Ignore-this: 842144ed92f5717699b8f580eab32a51
645 
646 Pass around IServer instance instead of (peerid, rref) tuple. Replace
647 "descriptor" with "server". Other replacements:
648 
649  get_all_servers -> get_connected_servers/get_known_servers
650  get_servers_for_index -> get_servers_for_psi (now returns IServers)
651 
652 This change still needs to be pushed further down: lots of code is now
653 getting the IServer and then distributing (peerid, rref) internally.
654 Instead, it ought to distribute the IServer internally and delay
655 extracting a serverid or rref until the last moment.
656 
657 no_network.py was updated to retain parallelism.
658]
659[TAG allmydata-tahoe-1.8.2
660warner@lothar.com**20110131020101]
661Patch bundle hash:
662cc9e5fc75eb944260eaca500fd94cfcc0b89afd8