[webkit-dev] website installation instructions correction

2008-11-06 Thread Jack Wootton
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

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

Can this be corrected so that the instructions are meaningful and can
someone advise me as to how I add the additional path?

Many thanks,
Jack
___
webkit-dev mailing list
webkit-dev@lists.webkit.org
http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev


Re: [webkit-dev] website installation instructions correction

2008-11-06 Thread Maciej Stachowiak


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.



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.



Can this be corrected so that the instructions are meaningful and can
someone advise me as to how I add the additional path?


Does the above help?

 - Maciej

___
webkit-dev mailing list
webkit-dev@lists.webkit.org
http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev


Re: [webkit-dev] website installation instructions correction

2008-11-06 Thread Jack Wootton
On Thu, Nov 6, 2008 at 4:36 PM, Maciej Stachowiak [EMAIL PROTECTED] 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'.


 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?

 Can this be corrected so that the instructions are meaningful and can
 someone advise me as to how I add the additional path?

 Does the above help?

  - Maciej





-- 
Regards
Jack
___
webkit-dev mailing list
webkit-dev@lists.webkit.org
http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev


Re: [webkit-dev] website installation instructions correction

2008-11-06 Thread Jack Wootton
To add, Step 3 (http://webkit.org/building/tools.html) states

Download cygwin-downloader.zip.
Right-click cygwin-downloader.zip and choose Extract All

I am using Windows XP, when I right click on the zip file, there is no
option Extract All...

On Thu, Nov 6, 2008 at 4:41 PM, Jack Wootton [EMAIL PROTECTED] wrote:
 On Thu, Nov 6, 2008 at 4:36 PM, Maciej Stachowiak [EMAIL PROTECTED] 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'.


 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?

 Can this be corrected so that the instructions are meaningful and can
 someone advise me as to how I add the additional path?

 Does the above help?

  - Maciej





 --
 Regards
 Jack




-- 
Regards
Jack
___
webkit-dev mailing list
webkit-dev@lists.webkit.org
http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev


Re: [webkit-dev] website installation instructions correction

2008-11-06 Thread Maciej Stachowiak


On Nov 6, 2008, at 8:41 AM, Jack Wootton wrote:

On Thu, Nov 6, 2008 at 4:36 PM, Maciej Stachowiak [EMAIL PROTECTED]  
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.






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?


 - Maciej

___
webkit-dev mailing list
webkit-dev@lists.webkit.org
http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev


Re: [webkit-dev] website installation instructions correction

2008-11-06 Thread Jack Wootton
On Thu, Nov 6, 2008 at 5:18 PM, Maciej Stachowiak [EMAIL PROTECTED] wrote:

 On Nov 6, 2008, at 8:41 AM, Jack Wootton wrote:

 On Thu, Nov 6, 2008 at 4:36 PM, Maciej Stachowiak [EMAIL PROTECTED] 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
___
webkit-dev mailing list
webkit-dev@lists.webkit.org
http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev


Re: [webkit-dev] website installation instructions correction

2008-11-06 Thread Jack Wootton
On Thu, Nov 6, 2008 at 5:23 PM, Jack Wootton [EMAIL PROTECTED] wrote:
 On Thu, Nov 6, 2008 at 5:18 PM, Maciej Stachowiak [EMAIL PROTECTED] wrote:

 On Nov 6, 2008, at 8:41 AM, Jack Wootton wrote:

 On Thu, Nov 6, 2008 at 4:36 PM, Maciej Stachowiak [EMAIL PROTECTED] 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
___
webkit-dev mailing list
webkit-dev@lists.webkit.org
http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev