[webkit-dev] website installation instructions correction

[Jack Wootton]

On Thu, Nov 6, 2008 at 5:23 PM, Jack Wootton <jackwootton at gmail.com> wrote:
> On Thu, Nov 6, 2008 at 5:18 PM, Maciej Stachowiak <mjs at apple.com> wrote:
>>
>> On Nov 6, 2008, at 8:41 AM, Jack Wootton wrote:
>>
>>> On Thu, Nov 6, 2008 at 4:36 PM, Maciej Stachowiak <mjs at apple.com> wrote:
>>>>
>>>> On Nov 6, 2008, at 8:27 AM, Jack Wootton wrote:
>>>>
>>>>> On this page http://webkit.org/building/tools.html. The last
>>>>> instruction of Step 2 is
>>>>>
>>>>> /*****************************************/
>>>>> "In addition to the paths specified in step 3 of the Platform SDK
>>>>> installation instructions, you must also add the following include
>>>>> path. Update the Visual C++ directories in the Projects and Solutions
>>>>> section in the Options dialog box:
>>>>>
>>>>> C:\Program Files\Microsoft Platform SDK for Windows Server 2003
>>>>> R2\Include\mfc"
>>>>> /*****************************************/
>>>>>
>>>>> This is ambiguous and confusing since 'paths' are added using the
>>>>> 'show directories for' drop down menu.  The 'show directories for'
>>>>> drop down menu contains the following options:
>>>>>
>>>>> Executable files
>>>>> Include files
>>>>> Reference files
>>>>> Library files
>>>>> Source files
>>>>> Exclude directories
>>>>
>>>> You want to add it to "Include files", thus the mention of "include
>>>> path". I
>>>> agree we can make it even more clear.
>>>
>>> There is no 'include path'  option, only 'include files'.
>>
>> The include path is the path used to find include files.
>
> OK.  I think this could be be made a lot clearer, perhaps it should read:
>
> In addition to the paths specified in step 3 of the Platform SDK
> installation instructions, you must also add the following path for
> 'include files'.
>
> C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Include\mfc
>
>>
>>>
>>>
>>>>
>>>>> How is the reader supposed to know which option to select when adding
>>>>> the additional path specified in Step 2?  The instruction is further
>>>>> rendered useless because of the confusing spacing and single type face
>>>>> used for
>>>>>
>>>>> "C:\Program Files\Microsoft Platform SDK for Windows Server 2003
>>>>> R2\Include\mfc"
>>>>
>>>> What do you find confusing about it? I believe you should be able to cut
>>>> and
>>>> paste the string. We can use a monospace font for this path if you think
>>>> it
>>>> would help.
>>>
>>> Perhaps this is my fault, I'm not accustomed to include strings being
>>> anything other than file locations or directory paths.  I do not have
>>> the directory "C:\Program Files\Microsoft Platform SDK for Windows
>>> Server 2003 R2\Include\mfc"
>>>
>>> Is this correct?
>>
>> Sounds to me like you are missing some needed files, then, specifically the
>> platform SDK. Did you follow the installation instructions for that?
>
> Yes, I believe so,
>
> 1. Install Visual C++ 2005 Express.
> 2. Install Microsoft Visual C++ Express 2005 Service Pack 1.
> 3. Install the Windows Server 2003 R2 Platform SDK, then follow steps
> 2 and 3 of "How to: Use Visual C++ Express Edition with the Microsoft
> Platform SDK."

OK, I have resolved the issue.  As you correctly asserted, I had not
installed the SDK.  The WebKit instructions neglect to mention an
intermediate download that is required before one can download the
SDK.  Perhaps the instructions could be updated to include the interim
download that Microsoft enforce before the SDK can be installed?

However I still have no "Extract all" option when I right click on to
cygwin zip file.  I am running Windows XP and have both WinZip and 7
Zip installed.

>
> And that's it, up until the extra path that must be included, but does
> not exist on my machine.
>>
>>  - Maciej
>>
>>
>
>
>
> --
> Regards
> Jack
>



-- 
Regards
Jack