Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
thunar:dev:build_and_run [2020/09/17 01:21] – grammar and punctuation improvements kevinbowenthunar:dev:build_and_run [2025/01/19 09:08] (current) – alexxcons
Line 1: Line 1:
 ~~NOTOC~~ ~~NOTOC~~
-{{ :thunar:dev:thunar.png?nolink|}}+{{ :thunar:dev:xfce.thunar.png?nolink|}}
 ====== Thunar - build, test, and debugging suggestions ===== ====== Thunar - build, test, and debugging suggestions =====
 +
 +  * **[[#Building Thunar|Building Thunar]]**
 +  * **[[#Debugging Thunar|Debugging Thunar]]**
 +  * **[[#Thunar Build Flags|Thunar Build Flags]]**
  
 ---- ----
  
 === Building Thunar === === Building Thunar ===
 +
 +First of all, check the [[https://gitlab.xfce.org/xfce/thunar/-/blob/master/README.md|Thunar README]] !
  
 Clone the sources (required packages: git): Clone the sources (required packages: git):
Line 13: Line 19:
   cd thunar   cd thunar
  
-Execute autogen (required packages: build-essential, automake):+Execute autogen (required packages: build-essential, automake, gobject-introspection):
   ./autogen.sh   ./autogen.sh
      
Line 22: Line 28:
   make   make
  
-You don't need to install Thunar for testing, you can run it directly from the source folder.+For testing only thunar itself, you don't need to install it. You can run it directly from the source folder. (Though if you want to test thunar plugins, you will need to install)
 Here is my personal script for starting thunar from source: Here is my personal script for starting thunar from source:
  
Line 31: Line 37:
   echo "./thunar/thunar -q;./thunar/thunar $THUNAR_TEST_FOLDER"   echo "./thunar/thunar -q;./thunar/thunar $THUNAR_TEST_FOLDER"
   ./thunar/thunar -q;G_MESSAGES_DEBUG=all ./thunar/thunar $THUNAR_TEST_FOLDER   ./thunar/thunar -q;G_MESSAGES_DEBUG=all ./thunar/thunar $THUNAR_TEST_FOLDER
 +
 +Here a workaround to as well test thunar plugin changes (thunar-sbr in this example) without the need to install thunar:
 +
 +  ./autogen.sh --with-custom-thunarx-dirs-enabled
 +  make
 +  THUNARX_DIRS=~/git/thunar/plugins/thunar-sbr/.libs ./thunar/thunar
  
 ---- ----
Line 41: Line 53:
   echo "./thunar/thunar -q; gdb thunar/.libs/thunar"   echo "./thunar/thunar -q; gdb thunar/.libs/thunar"
   ./thunar/thunar -q; gdb thunar/.libs/thunar   ./thunar/thunar -q; gdb thunar/.libs/thunar
 +
 +On a freeze, get a backtrace of all threads via
 +
 +  thread apply all bt
  
 If you want to test thunar-plugins, it is required to install thunar. If you want to test thunar-plugins, it is required to install thunar.
Line 53: Line 69:
 For more infoormation, check the INSTALL file in the source code! For more infoormation, check the INSTALL file in the source code!
  
-=== Build Flags === +=== Thunar Build Flags === 
-Here is a small collection of flags which often needs to be passed to ''./autogen.sh'' :+Here is a small collection of useful flags which can be passed to ''./autogen.sh'' :
  
-<code>--enable-gtk-doc : Creates html documentation inside /doc+<code>--enable-gtk-doc : Creates html documentation inside /doc/reference/thunarx/html
 --enable-introspection : for usage of the GtkInspector --enable-introspection : for usage of the GtkInspector
 --prefix <install_dir>: install thunar to install_dir --prefix <install_dir>: install thunar to install_dir
Line 62: Line 78:
 --enable-debug=full|yes|minimum|no</code> --enable-debug=full|yes|minimum|no</code>
  
 +Some flags need to be passed to the thunar binary:
 +<code>--g-fatal-warnings : Lets thunar crash an any warning/error. Useful to get a backtrace / locate a warning/error/critical</code>
 +
 +You might want to run that via gdb to get a backtrace:
 +<code>gdb --args thunar/.libs/thunar --g-fatal-warnings</code>
 [[|Back To Top]] [[|Back To Top]]
 ---- ----
-[[ :xfce:thunar:|Return to Main thunar documentation page]]+[[ https://docs.xfce.org/xfce/thunar/start|Return to Main thunar documentation page]]