Ticket #1284: quickstart.darcs.patch

File quickstart.darcs.patch, 14.5 KB (added by arch_o_median, at 2011-01-02T05:06:15Z)

created "Windows caveats" section

Line 
1Wed Dec 29 17:36:54 PST 2010  wilcoxjg@gmail.com
2  * docs/quickstart.html: information about `troublesome dependencies' and `verified systems' de-emphasized by different fonts
3
4Sat Jan  1 20:20:58 PST 2011  wilcoxjg@gmail.com
5  * Clarified organization of quickstart by adding "Windows Caveats" subsection.
6
7New patches:
8
9[docs/quickstart.html: information about `troublesome dependencies' and `verified systems' de-emphasized by different fonts
10wilcoxjg@gmail.com**20101230013654
11 Ignore-this: e08b3995e9de7018691026088fbf13f6
12] {
13hunk ./docs/quickstart.html 4
14 <!DOCtype HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
15 <html lang="en">
16   <head>
17+    <style type="text/css">
18+    p1 {font-size:60%;}
19+    p1 {font-style:italic;}
20+    </style>
21     <title>Getting Tahoe-LAFS</title>
22     <link rev="made" class="mailto" href="mailto:zooko[at]zooko[dot]com">
23     <meta name="description" content="how to get Tahoe-LAFS">
24hunk ./docs/quickstart.html 17
25 
26   <body>
27     <h1>About Tahoe-LAFS</h1>
28-    <p>Welcome to <a href="http://tahoe-lafs.org">the Tahoe-LAFS project</a>, a secure, decentralized, fault-tolerant storage system. <a href="about.html">About Tahoe-LAFS.</a>
29+    <p> The homepage of Tahoe-LAFS is <a href="http://tahoe-lafs.org">
30+    http://tahoe-lafs.org </a>. There is a one-page overview at <a href="about.html"> about Tahoe-LAFS.</a>
31 
32     <h1>How To Get Tahoe-LAFS</h1>
33 
34hunk ./docs/quickstart.html 22
35-    <p>This procedure has been verified to work on Windows, Mac, OpenSolaris, and too many flavors of Linux and of *BSD to list.  It's likely to work on other platforms.
36-
37-    <h2>In Case Of Trouble</h2>
38-
39-    <p>There are a few 3rd party libraries that Tahoe-LAFS depends on that might not be easy to set up on your platform.  If the following instructions don't Just Work without any further effort on your part, then please write to the <a href="http://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev">the tahoe-dev mailing list</a> where friendly hackers will help you out. You might also find clues in the Advanced Install section described below.
40+    <p1>This has been verified to work on Windows, Mac,
41+    OpenSolaris, and too many flavors of Linux and of *BSD to list.
42+    It's likely to work on other platforms.</p1>
43+    <h1></h1>
44+    <p1><b><u>WARNING!</b></u> There are a few 3rd party libraries
45+    that Tahoe-LAFS depends on that might not be easy to set up on
46+    your platform.  If the following instructions don't Just Work,
47+    please contact
48+    the <a href="http://tahoe-lafs.org/cgi-bin/mailman/listinfo/tahoe-dev">the
49+    tahoe-dev mailing list</a> where fun, friendly, hackers will help you out! You might also find clues in the Advanced Install section described below.</p1>
50 
51     <h2>Install Python</h2>
52 
53hunk ./docs/quickstart.html 35
54-    <p>Check if you already have an adequate version of Python installed by running <cite>python -V</cite>.  Python&nbsp;v2.4 (v2.4.4 or greater), Python&nbsp;v2.5, Python&nbsp;v2.6, or Python&nbsp;v2.7 will work. Python&nbsp;v3 does not work. On Windows, we recommend the use of Python&nbsp;v2.6 (native, not Cygwin). If you don't have one of these versions of Python installed, then follow the instructions on <a href="http://www.python.org/download/releases/2.6.6/">the Python download page</a> to download and install Python&nbsp;v2.6. Make sure that the path to the installation directory has no spaces in it (e.g. on Windows, do not install Python in the "<tt>Program Files</tt>" directory).</p>
55-    <p>If you are on Windows, you now must manually install the pywin32 package from <a href="http://sourceforge.net/projects/pywin32/files/">the pywin32 site</a> before getting Tahoe-LAFS. Make sure to get the correct file for the version of Python you are using &mdash; e.g. ending in "py2.6.exe" for Python&nbsp;v2.6. If using 64-bit Windows, the file should have "win-amd64" in its name.</p>
56+    <p>Check if you already have an adequate version of Python
57+    installed by running <cite>python --version</cite>.  Python&nbsp;v2.4 (v2.4.4 or greater), Python&nbsp;v2.5, Python&nbsp;v2.6, or Python&nbsp;v2.7 will work. Python&nbsp;v3 does not work. On Windows, we recommend the use of Python&nbsp;v2.6 (native, not Cygwin). If you don't have one of these versions of Python installed, then follow the instructions on <a href="http://www.python.org/download/releases/2.6.6/">the Python download page</a> to download and install Python&nbsp;v2.6. Make sure that the path to the installation directory has no spaces in it (e.g. on Windows, do not install Python in the "<tt>Program Files</tt>" directory).</p>
58+    <p>If you are on Windows, you must manually install the pywin32 package from <a href="http://sourceforge.net/projects/pywin32/files/">the pywin32 site</a> before getting Tahoe-LAFS. Make sure to get the correct file for the version of Python you are using &mdash; e.g. ending in "py2.6.exe" for Python&nbsp;v2.6. If using 64-bit Windows, the file should have "win-amd64" in its name.</p>
59 
60     <h2>Get Tahoe-LAFS</h2>
61 
62}
63[Clarified organization of quickstart by adding "Windows Caveats" subsection.
64wilcoxjg@gmail.com**20110102042058
65 Ignore-this: 513d5ae8f23e5150f1ce72f834d297b6
66] hunk ./docs/quickstart.html 36
67     <h2>Install Python</h2>
68 
69     <p>Check if you already have an adequate version of Python
70-    installed by running <cite>python --version</cite>.  Python&nbsp;v2.4 (v2.4.4 or greater), Python&nbsp;v2.5, Python&nbsp;v2.6, or Python&nbsp;v2.7 will work. Python&nbsp;v3 does not work. On Windows, we recommend the use of Python&nbsp;v2.6 (native, not Cygwin). If you don't have one of these versions of Python installed, then follow the instructions on <a href="http://www.python.org/download/releases/2.6.6/">the Python download page</a> to download and install Python&nbsp;v2.6. Make sure that the path to the installation directory has no spaces in it (e.g. on Windows, do not install Python in the "<tt>Program Files</tt>" directory).</p>
71-    <p>If you are on Windows, you must manually install the pywin32 package from <a href="http://sourceforge.net/projects/pywin32/files/">the pywin32 site</a> before getting Tahoe-LAFS. Make sure to get the correct file for the version of Python you are using &mdash; e.g. ending in "py2.6.exe" for Python&nbsp;v2.6. If using 64-bit Windows, the file should have "win-amd64" in its name.</p>
72+    installed by running <cite>python --version</cite>.
73+    Python&nbsp;v2.4 (v2.4.4 or greater), Python&nbsp;v2.5,
74+    Python&nbsp;v2.6, or Python&nbsp;v2.7 will work. Python&nbsp;v3
75+    does not work. If you don't have one of these versions of Python installed, then follow the instructions on <a href="http://www.python.org/download/releases/2.6.6/">the Python download page</a> to download and install Python&nbsp;v2.6. Make sure that the path to the installation directory has no spaces in it (e.g. on Windows, do not install Python in the "<tt>Program Files</tt>" directory).</p>
76+
77+    <h4>Windows Caveats</h4>
78+
79+    <p> On Windows, we recommend the use of Python&nbsp;v2.6 (native, not Cygwin).
80+    You must manually install the pywin32 package from <a href="http://sourceforge.net/projects/pywin32/files/">the pywin32 site</a> before getting Tahoe-LAFS. Make sure to get the correct file for the version of Python you are using &mdash; e.g. ending in "py2.6.exe" for Python&nbsp;v2.6. If using 64-bit Windows, the file should have "win-amd64" in its name.</p>
81 
82     <h2>Get Tahoe-LAFS</h2>
83 
84
85Context:
86
87[Remove src/allmydata/util/find_exe.py which is no longer used. fixes #1150
88david-sarah@jacaranda.org**20101226023206
89 Ignore-this: 7436c9b53bf210aed34a1a973cd9cace
90]
91[status_web_pages_review.darcs.patch
92freestorm77@gmail.com**20110102034214
93 Ignore-this: 29f1ecb36177f10f3f846b3d56b313b2
94 
95 I make some changes on status web pages
96 
97 status.xhtml:
98 - Delete unused webform_css link
99 - Align tables on the left
100 
101 tahoe-css:
102 - Do some minor changes on code synthax
103 - changes table.status-download-events style to look like other tables
104 
105 status.py:
106 - Align table on the left
107 - Changes table header
108 - Add heading tags
109 - Modify google api graph: add image border, calculate height to feet data
110 
111 signed-off-by: zooko@zooko.com
112 fixes #1219
113]
114[test_storage.py: fix a pyflakes unused import warning.
115david-sarah@jacaranda.org**20101231220756
116 Ignore-this: df08231540cb7dff9d2b038e47ab30ee
117]
118[test_storage.py: leave at least 512 MiB free when running test_large_share. refs #1195
119david-sarah@jacaranda.org**20101231203215
120 Ignore-this: b2144c0341c3452b5d4ba219e284ea0e
121]
122[storage: use fileutil's version of get_disk_stats() and get_available_space(), use mockery/fakery in tests, enable large share test on platforms with sparse files and if > 4 GiB of disk space is currently available
123zooko@zooko.com**20100910173629
124 Ignore-this: 1304f1164c661de6d5304f993eb9b27b
125]
126[fileutil: copy in the get_disk_stats() and get_available_space() functions from storage/server.py
127zooko@zooko.com**20100910173520
128 Ignore-this: 8b15569715f710f4fc5092f7ca109253
129]
130[Update foolscap version requirement to 0.6.0, to address http://foolscap.lothar.com/trac/ticket/167
131david-sarah@jacaranda.org**20101231060039
132 Ignore-this: 98d2b8086a1a500b9f4565bca5a3810
133]
134[docs/webapi.rst: typos.
135david-sarah@jacaranda.org**20101230034422
136 Ignore-this: d1f5166d72cc711f7e0d9981eac9105e
137]
138[docs/webapi.rst: capitalization, formatting of section on URL character encoding, and a correction about Internet Explorer.
139david-sarah@jacaranda.org**20101230034049
140 Ignore-this: b3b9819d2fb264b4cdc5c8afd4e8c48d
141]
142[docs: corrections and clarifications.
143david-sarah@jacaranda.org**20101227051056
144 Ignore-this: e33202858c7644c58f3f924b164294b6
145]
146[docs: more formatting cleanups and corrections. Spell webapi and wapi as web-API.
147david-sarah@jacaranda.org**20101227050533
148 Ignore-this: 18b23cbfb780df585d8a722a1ec63e94
149]
150[docs/debian.rst: bring description of building dependencies from source up-to-date, and change hostname from allmydata.com to tahoe-lafs.org.
151david-sarah@jacaranda.org**20101212222912
152 Ignore-this: f38462afc88b4475195610385a28391c
153]
154[docs/architecture.rst: correct rst syntax.
155david-sarah@jacaranda.org**20101212202003
156 Ignore-this: 3fbe12feb28bec6f1c63aedbc79aad21
157]
158[docs/architecture.rst: formatting.
159david-sarah@jacaranda.org**20101212201719
160 Ignore-this: 305fa5dfc2939355eaf6d0d2161eb1ff
161]
162[docs: linkification, wording improvements.
163david-sarah@jacaranda.org**20101212201234
164 Ignore-this: 4e67287f527a8bc728cfbd93255d2aae
165]
166[docs: formatting.
167david-sarah@jacaranda.org**20101212201115
168 Ignore-this: 2e0ed394ac7726651d3a4f2c4b0d3798
169]
170[docs/configuration.rst: more formatting tweaks; which -> that.
171david-sarah@jacaranda.org**20101212195522
172 Ignore-this: a7becb7021854ca5a90edd892b36fdd7
173]
174[docs/configuration.rst: more changes to formatting.
175david-sarah@jacaranda.org**20101212194511
176 Ignore-this: 491aac33e5f5268d224359f1447d10be
177]
178[docs/configuration.rst: changes to formatting (mainly putting commands and filenames in monospace).
179david-sarah@jacaranda.org**20101212181828
180 Ignore-this: 8a1480e2d5f43bee678476424615b50f
181]
182[scripts/backupdb.py: more accurate comment about path field.
183david-sarah@jacaranda.org**20101212170320
184 Ignore-this: 50e47a2228a85207bbcd188a78a0d4e6
185]
186[scripts/cli.py: fix missing 'put' in usage example for 'tahoe put'.
187david-sarah@jacaranda.org**20101212170207
188 Ignore-this: 2cbadf066fff611fc03d3c0ff97ce6ec
189]
190[docs/frontends/CLI.rst: changes to formatting (mainly putting commands and filenames in monospace), and to command syntax to reflect that DIRCAP/... is accepted. Clarify the syntax of 'tahoe put' and other minor corrections. Tahoe -> Tahoe-LAFS.
191david-sarah@jacaranda.org**20101212165800
192 Ignore-this: a123ef6b564aa8624d1e79c97068ea12
193]
194[docs/frontends/CLI.rst: Unicode arguments to 'tahoe' work on Windows as of v1.7.1.
195david-sarah@jacaranda.org**20101212063740
196 Ignore-this: 3977a99dfa86ac33a44171deaf43aaab
197]
198[docs/known_issues.rst: fix title and linkify another URL. refs #1225
199david-sarah@jacaranda.org**20101212062817
200 Ignore-this: cc91287f7fb51c23440b3d2fe79c449c
201]
202[docs/known_issues.rst: fix an external link. refs #1225
203david-sarah@jacaranda.org**20101212062435
204 Ignore-this: b8cbf12f353131756c358965c48060ec
205]
206[Fix a link from uri.rst to dirnodes.rst. refs #1225
207david-sarah@jacaranda.org**20101212054502
208 Ignore-this: af6205299f5c9a33229cab259c00f9d5
209]
210[Fix a link from webapi.rst to FTP-and-SFTP.rst. refs #1225
211david-sarah@jacaranda.org**20101212053435
212 Ignore-this: 2b9f88678c3447ea860d6b61e8799858
213]
214[More specific hyperlink to architecture.rst from helper.rst. refs #1225
215david-sarah@jacaranda.org**20101212052607
216 Ignore-this: 50424c768fca481252fabf58424852dc
217]
218[Update hyperlinks between docs, and linkify some external references. refs #1225
219david-sarah@jacaranda.org**20101212051459
220 Ignore-this: cd43a4c3d3de1f832abfa88d5fc4ace1
221]
222[docs/specifications/dirnodes.rst: fix references to mutable.rst. refs #1225
223david-sarah@jacaranda.org**20101212012720
224 Ignore-this: 6819b4b4e06e947ee48b365e840db37d
225]
226[docs/specifications/mutable.rst: correct the magic string for v1 mutable containers. refs #1225
227david-sarah@jacaranda.org**20101212011400
228 Ignore-this: 99a5fcdd40cef83dbb08f323f6cdaaca
229]
230[Move .txt files in docs/frontends and docs/specifications to .rst. refs #1225
231david-sarah@jacaranda.org**20101212010251
232 Ignore-this: 8796d35d928370f7dc6ad2dafdc1c0fe
233]
234[Convert docs/frontends and docs/specifications to reStructuredText format (not including file moves).
235david-sarah@jacaranda.org**20101212004632
236 Ignore-this: e3ceb2d832d73875abe48624ddbb5622
237]
238[scripts/cli.py: remove the disclaimer in the help for 'tahoe cp' that it does not handle non-ASCII filenames well. (At least, we intend to handle them.)
239david-sarah@jacaranda.org**20101130002145
240 Ignore-this: 94c003efaa20b9eb4a83503d79844ca
241]
242[relnotes.txt: fifth -> sixth labor-of-love release
243zooko@zooko.com**20101129045647
244 Ignore-this: 21c245015268b38916e3a138d256c09d
245]
246[Makefile: BB_BRANCH is set to the empty string for trunk, not the string 'trunk'.
247david-sarah@jacaranda.org**20101128233512
248 Ignore-this: 5a7ef8eb10475636d21b91e25b56c369
249]
250[relnotes.txt: eleventh -> twelfth release.
251david-sarah@jacaranda.org**20101128223321
252 Ignore-this: 1e26410156a665271c1170803dea2c0d
253]
254[relnotes.tst: point to known_issues.rst, not known_issues.txt.
255david-sarah@jacaranda.org**20101128222918
256 Ignore-this: 60194eb4544cac446fe4f60b3e34b887
257]
258[quickstart.html: fix link to point to allmydata-tahoe-1.8.1.zip.
259david-sarah@jacaranda.org**20101128221728
260 Ignore-this: 7b3ee86f8256aa12f5d862f689f3ee29
261]
262[TAG allmydata-tahoe-1.8.1
263david-sarah@jacaranda.org**20101128212336
264 Ignore-this: 9c18bdeaef4822f590d2a0d879e00621
265]
266Patch bundle hash:
2675ffbc7f5f32ff7921d09953681aefdb4adf88a2e