2008-10-11 05:27:52 +00:00
|
|
|
This file is licensed under the terms of the expat license, see the file EXPAT.
|
|
|
|
|
2008-07-27 05:43:30 +00:00
|
|
|
+++ Installing Midori +++
|
|
|
|
|
|
|
|
Building and installing Midori is straightforward.
|
|
|
|
|
|
|
|
Make sure you have Python 2.4 or higher installed.
|
2008-04-16 23:40:15 +00:00
|
|
|
|
2008-07-27 05:43:30 +00:00
|
|
|
Change to the Midori folder on your hard disk in a terminal.
|
2008-04-16 23:40:15 +00:00
|
|
|
|
2008-07-27 05:43:30 +00:00
|
|
|
Run './waf configure'
|
2008-04-16 23:40:15 +00:00
|
|
|
|
2008-07-27 05:43:30 +00:00
|
|
|
Run './waf build'
|
2008-04-16 23:40:15 +00:00
|
|
|
|
2009-01-22 00:59:23 +00:00
|
|
|
You can now run Midori from the build folder like so
|
|
|
|
|
|
|
|
'./waf build --run'
|
|
|
|
|
|
|
|
This is a convenience that will load extensions as well as
|
|
|
|
localizations from the build folder.
|
2008-04-16 23:40:15 +00:00
|
|
|
|
2008-07-27 05:43:30 +00:00
|
|
|
You can install it with './waf install'
|
2007-12-16 22:20:24 +00:00
|
|
|
|
2008-07-27 05:43:30 +00:00
|
|
|
For further options run './waf --help'
|
2007-12-16 22:20:24 +00:00
|
|
|
|
2008-10-27 21:57:28 +00:00
|
|
|
+++ Debugging Midori +++
|
|
|
|
|
2009-01-22 00:59:23 +00:00
|
|
|
Run './waf configure -d full' from the Midori folder.
|
2008-10-27 21:57:28 +00:00
|
|
|
|
|
|
|
Run './waf build'
|
|
|
|
|
|
|
|
Midori is now built with debugging symbols.
|
|
|
|
|
|
|
|
Make sure you have installed 'gdb', the GNU Debugger.
|
|
|
|
|
2009-02-21 21:34:50 +00:00
|
|
|
Run Midori as 'gdb _build_/default/midori/midori'.
|
2008-10-27 21:57:28 +00:00
|
|
|
|
|
|
|
Try to reproduce a crash that you experienced earlier,
|
|
|
|
this time Midori will freeze at the point of the crash.
|
|
|
|
Switch to your terminal, type bt ('backtrace') and hit Return.
|
|
|
|
What you obtained now is a backtrace that should include
|
|
|
|
function names and line numbers.
|
|
|
|
|
2009-02-24 21:49:51 +00:00
|
|
|
If the problem is a warning and not a crash, try this:
|
|
|
|
|
|
|
|
'G_DEBUG=all gdb _build_/default/midori/midori'
|
|
|
|
|
|
|
|
If you are interested in HTTP communication, try this:
|
|
|
|
|
|
|
|
'MIDORI_SOUP_DEBUG=2 _build_/default/midori/midori'
|
|
|
|
|
|
|
|
Where '2' can be a level between 0 and 3.
|
|
|
|
|
2009-10-28 19:38:09 +00:00
|
|
|
If you are interested in (non-) touchscreen behaviour, try this:
|
|
|
|
|
|
|
|
'MIDORI_TOUCHSCREEN=1 _build_/default/midori/midori', or
|
|
|
|
|
|
|
|
'MIDORI_TOUCHSCREEN=0 _build_/default/midori/midori'
|
|
|
|
|
2008-10-27 21:57:28 +00:00
|
|
|
For further information a tutorial for gdb and
|
|
|
|
reading up on how you can install debugging
|
|
|
|
symbols for libraries used by Midori are recommended.
|