~~NOTOC~~

====== xfce4-dev-tools ======
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

The Xfce development tools are a collection of tools and macros for
Xfce developers and people that want to build Xfce from Git. In addition,
it also contains the Xfce developer's handbook.


----

===== xfce-build Containerized Build Environment =====

This project also contains the code to build and deploy xfce-build to the
[[https://hub.docker.com/repository/docker/xfce/xfce-build/|xfce-build area on Docker Hub]].
This container is the build environment used by Xfce to build the various projects.
It can also be used as your own build environment as follows:

<code>
docker run --rm -u $(id -u ${USER}):$(id -g ${USER}) \
  --volume $(pwd):/tmp xfce/xfce-build:master /bin/bash \
  -c "cd /tmp; ./autogen.sh && make distcheck"
</code>

The steps to build the container are encoded in the [[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/Dockerfile?ref_type=heads|Dockerfile]] in
this repository, and is built via the build job in [[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/.gitlab-ci.yml?ref_type=heads|.gitlab-ci.yml]].

----

===== CI Templates for Xfce =====

The [[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/tree/master/ci?ref_type=heads|CI folder]] contains the [[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/ci/build_project.yml?ref_type=heads|build_project.yml]] template for building the various
Xfce projects, as well as supporting scripts such as [[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/ci/build_libs.sh?ref_type=heads|build_libs.sh]] which handles
building any needed dependencies. This helps us avoid repeating the same build
code in each project.

----

===== Latest Release =====

{{rss>https://archive.xfce.org/feeds/project/xfce4-dev-tools 1 date 2h}}

[[https://gitlab.xfce.org/xfce/xfce4-dev-tools/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/xfce/xfce4-dev-tools/|Download current release]]** (older versions of this component are also available here)

[[|Back to Top]]
----
===== Source Code Repository =====
[[https://gitlab.xfce.org/xfce/xfce4-dev-tools|]]

----
===== Reporting Bugs =====
  * **[[:xfce:xfce4-dev-tools:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports

[[|Back to Top]]
----
[[:start|Return to Xfce Main Documentation Page]]