[webkit-dev] Purpose of script debug-safari?

Adam Roben aroben at apple.com
Mon Dec 1 08:43:18 PST 2008

On Nov 27, 2008, at 12:58 PM, Jack Wootton wrote:

> Apologies for the multiple questions, but this process seems to have
> presented a few problems for me:
> Point 1.  I don't know if this is the best way to do it but I would
> have thought most people load the webkit project into VS 2005, and
> then attempt to run safari and debug it.  However the webkit project
> cannot be loaded into VS 2005 without having already set
> WEBKITLIBRARIESDIR.  So I don't see how debug-safari precludes the

debug-safari sets the WEBKITLIBRARIESDIR environment variable just for  
the VS process it launches.

> Point 2. I don't know what value the system variable WEBKITOUTPUTDIR
> should have and can't find any instructions online, can someone help?

  explains this environment variable.

> Pont 3. Running debug-safari in cygwin results in VS 2005 opening for
> a second time even though I already have it opened with project code
> loaded.  This seems odd since I end up with two instances of VS 2005,
> one with project code and one with safari.exe listed in the project
> panel.  Am I using the command incorrectly?

The script is behaving as expected.

Perhaps your confusion comes from not knowing that it is possible to  
build WebKit without opening Visual Studio. The instructions that  
start at <http://webkit.org/building/tools.html> take you from  
installing Cygwin through building WebKit and running Safari, all  
without opening Visual Studio. The debug-safari script is meant to  
complement this workflow, by allowing Visual Studio to be launched  
correctly for debugging Safari/WebKit without the user having  
configured his/her environment for the WebKit VS project files.


> On Wed, Nov 26, 2008 at 4:14 PM, Adam Roben <aroben at apple.com> wrote:
>> On Nov 26, 2008, at 5:10 AM, Jack Wootton wrote:
>>> Can anyone clarify the purpose of the script debug-safari?
>> Sure:
>>> I loaded
>>> the webkit project into VS 2005, built it using cygwin, launched  
>>> using
>>> the script run-safari and then attached the safari process to the
>>> project imported into VS 2005.
>> One step you didn't mention was setting the WEBKITOUTPUTDIR and
>> WEBKITLIBRARIESDIR environment variables prior to opening  
>> WebKit.sln inside
>> Visual Studio.
>> The purpose of the script is to remove the need to perform these  
>> actions
>> manually. With the script, the sequence is:
>> Run debug-safari
>> Place breakpoints
>> Press F5
>>> I did not require the script debug-safari for this.  Am I doing  
>>> something
>>> wrong?
>> Nope, you're just duplicating manually the things the script does
>> automatically.
>> -Adam
> -- 
> Regards
> Jack

More information about the webkit-dev mailing list