81 lines
2.2 KiB
Text
81 lines
2.2 KiB
Text
This file is licensed under the terms of the expat license, see the file EXPAT.
|
|
|
|
+++ Installing Midori +++
|
|
|
|
Building and installing Midori is straightforward.
|
|
|
|
Make sure you have Python 2.4 or higher installed.
|
|
|
|
Change to the Midori folder on your hard disk in a terminal.
|
|
|
|
Run './waf configure'
|
|
|
|
Run './waf build'
|
|
|
|
You can now run Midori from the build folder like so
|
|
|
|
'./waf build --run'
|
|
|
|
Using --run as shown above will make sure extensions as well as
|
|
localizations are used from the build folder.
|
|
|
|
You can install it with './waf install'
|
|
|
|
If you need to do a clean rebuild, you can do either './waf clean'
|
|
in order to remove binaries or './waf distclean' which deletes generated
|
|
configuration files as well.
|
|
|
|
For further options run './waf --help'
|
|
|
|
+++ Debugging Midori +++
|
|
|
|
Run './waf configure -d full' from the Midori folder.
|
|
|
|
Run './waf build'
|
|
|
|
Midori is now built with debugging symbols.
|
|
|
|
Make sure you have installed 'gdb', the GNU Debugger.
|
|
|
|
Run Midori as 'gdb _build/default/midori/midori'.
|
|
|
|
Inside gdb, type 'run'.
|
|
|
|
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.
|
|
|
|
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_DEBUG=soup:2 _build/default/midori/midori'
|
|
|
|
Where '2' can be a level between 1 and 3.
|
|
|
|
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'
|
|
|
|
If you want to "dry run" without WebKitGTK+ rendering, try this:
|
|
|
|
'MIDORI_UNARMED=1 _build/default/midori/midori'
|
|
|
|
If you want to test bookmarks, you can enable database tracing:
|
|
|
|
'MIDORI_BOOKMARKS_DEBUG=1 _build/default/midori/midori'
|
|
|
|
To disable Netscape plugins, use MOZ_PLUGIN_PATH=/.
|
|
|
|
When running from the build folder, extensions will also be located
|
|
in the build folder (setting MIDORI_EXTENSION_PATH is no longer needed).
|
|
|
|
For further information a tutorial for gdb and
|
|
reading up on how you can install debugging
|
|
symbols for libraries used by Midori are recommended.
|