Re: [PATCH] small INSTALL file corrections

[Stefan Hett <st...@egosoft.com>]

Hi Bert/Julian

sorry for the late reply, but I didn't get back to this earlier 
unfortunately.

So I've spend a bit more time and tried to incorporate the feedback from 
Bert into the patch as well as adding/updating a few more bits and 
pieces which I ran into myself when setting-up a Windows build 
environment here.

Please understand that this is a suggested patch for the current 
trunk-version (aka svn 1.10-dev). I would not suggest this patch for 
1.7/1.8 (and given that 1.9 is already in the stabilizing period for 
release I'm not sure whether all of these changes (especially the ones 
suggesting changes to supported VS platforms or the added placeholder 
for further documentation) would be appropriate for 1.9).

Therefore will likely send separate patches with just some 
corrections/fixes for 1.7/1.8/1.9 (unless u state this won't be 
required/useful).
Hope this is of some use to you.

[[[
Several updates/corrections to the INSTALL file:
- updated compatibility statements for Visual Studio (dropping 2002/2003 
support, adding support for 2008+ versions)
- case-correction for February
- replaced dead-link to Platform SDK for VC6 with link to still 
available instructions
- replaced redirection URL zlib.org with direct URL zlib.net
- update VS build instructions to be suitable for VS >= 2010
- libmagic marked as optional dependency
- made URLs consistently use a trailing /
- corrected minimum Serf version (1.2.1 -> 1.3.4)
- corrected section numbering and referencing in several cases
- clarify that Python is required for Windows as well
- specify Python >= 3.0 being unsupported atm
- dropping explicit mentioning of Subversion version 1.8 (since the 
documentation always applies to the current version)
- added missing prerequisite an install step instruction for SQLite 3.7.12
- added optional-markers to steps which are not required in all cases
- clarified when serf is required
- replaced DRIVE-variable with BUILD_ROOT-variable to make things a bit 
easier to understand
- added missing required quotes around SDK-paths which contain spaces
- added sections about building APR, ZLib, and Serf to give some leads 
how to build these from source (serf: only TODO-markers)

* INSTALL
     documentation updated
]]]

Regards,
Stefan

> Bert Huijben wrote:
>> I'm guessing VC6 still works as that was used in many httpd builds until
>> recently, but 2002 and 2003 are as far as I know unmaintained for a few
>> releases and most likely broken.
>>
>> A patch to  INSTALL would be welcome, but I just tried to improve the patch
>> a bit further. It might be easier to rework the entire document
> Can we apply Stefan's patch first, to create that positive feeling
> that something's been improved and the patch has been welcome, and
> *then* continue the process of further improvement?
>
> - Julian
>
>> as things as
>> 'install the sdk' are outdated in the common scenarios. 1.9+ also allows
>> references to dependencies in an install location instead of only in source
>> layouts.
>>
>> Bert
> [...]
>