[Couchdb Wiki] Update of "Quirks_on_Windows" by DaveCottlehuber

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Couchdb Wiki" for change notification.

The "Quirks_on_Windows" page has been changed by DaveCottlehuber.
http://wiki.apache.org/couchdb/Quirks_on_Windows

--------------------------------------------------

New page:
= Quirks on Windows =
This page will help you relax on Windows just as much as anywhere else.

== Build ==
 * use only 32-bit components even if you are building on a 64-bit architecture
 * make sure you have a clean path with your build chain first - watch out for other developer tools like git, which may have older versions of OpenSSL or ICU binaries in your path
 * Firefox is the only supported browser for running the Futon test suite - some tests still fail due to platform differences however
 * Online compaction is not supported on Windows due to differences between UX and Windows on renaming/deleting files that are open in another process/thread

== Upgrade ==
 * recommendation is to backup, uninstall, re-install, validate using Futon test suite, restore data, rather than an in-place upgrade
 * this ensures you have a cruft-free experience while the windows build & installer continues to change

== Run ==
 * You can still complete compaction of your couch by stopping CouchDB and deleting/renaming the appropriate data files - just be careful
 * the crash-safe storage engine means you can hibernate or reboot at will without data loss
 * VSS snapshots for backup are a really good way to go
 * Firefox is the only supported browser for the test suite, but for almost anything else a current version of IE will work "just fine". YMMV
 * you can restart the CouchDB service via commandline, the Services control panel, or build yourself a shortcut or .cmd file to do the trick also:

{{{
net.exe stop "Apache CouchDB" && net.exe start "Apache CouchDB"
}}}
 * cURL works just fine on Windows -- once you understand the unwritten rules of quotes which are very different to that on Unix. The standard example from CouchDB the Definitive Guide will fail with a "Invalid UTF-8 JSON" error

{{{
curl-X PUT http://username:password@localhost:5984/albums/6e1295ed6c29495e54cc05947f18c8af -d '{"title":"There is Nothing Left to Lose","artist":"Foo Fighters"}'
}}}
 * the 2 alternatives are either to include your JSON-encoded data as a file:

{{{
 curl-X PUT http://username:password@localhost:5984/albums/6e1295ed6c29495e54cc05947f18c8af -d @foo.json
}}}
 * or to use one of the three escape character sequences ("" or a ^" or a \") for every internal quote, to get past the cmd.exe shell

{{{
curl -X PUT http://@127.0.0.1:5984/albums/6e1295ed6c29495e54cc05947f18c8af -d "{\"title\":\"There is Nothing Left to Lose\",\"artist\":\"Foo Fighters\"}"
}}}