[webkit-dev] website installation instructions correction

[Jack Wootton]

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."

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



-- 
Regards
Jack