Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add JHBuild page in the tools. #143

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Add JHBuild page in the tools. #143

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 53 additions & 0 deletions tools/jhbuild/about.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
---
title: JHBuild
subsection: jhbuild
section: tools
description: Build tool for GNOME development which downloads, configures and builds the code while figuring out dependencies.
---

# What is JHBuild
[JHBuild](https://developer.gnome.org/jhbuild/stable/introduction.html.en) is the recommended way to build and run GNOME development code. It will download the code, configure and build it for you, in a way that does not interfere with or modify your existing system. JHBuild will also figure out which dependencies are required from your distribution, and it will build any development software that is needed.

## Installing JHBuild on Fedora

Install basic required packages
```
$ sudo dnf install gnome-common yelp-tools autoconf gettext-devel docbook-xsl perl-XML-Parser cvs flex bison svn glib glib-devel pygobject2 dbus-python redhat-rpm-config
```

Make directory ~/jhbuild/checkout where all the code will live and cd to it
```
$ mkdir ~/jhbuild/checkout
$ cd ~/jhbuild/checkout
```

Clone jhbuild
```
$ git clone --depth=1 git://git.gnome.org/jhbuild
```

Cd to the source directory and build it
```
$ cd ~/jhbuild/
$ ./autogen.sh
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This does not seem correct to me. It is not clear where jhbuild is cloned to. Please try to find another way of using jhbuild. Preferably without running any cloned scripts.

$ make
$ make install
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not a big fan of installing software this way. Do you think you/someone could package it as an RPM? At least in Copr.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@meghprkh Can you please update PR so that git clone is not used? Can JHBuild be packaged into Fedora?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@meghprkh Yes, copr seems like a good way to compile this code. Not on a users machine. I find it is actually quite easy, and it can build on github hooks too. Please consider it

```

Add the JHBuild installation path (.local/bin) to your PATH directory
```
$ echo 'PATH=$PATH:~/.local/bin' >> ~/.bashrc
$ source ~/.bashrc
```

Check build prerequisites
```
$ jhbuild sanitycheck
```
Install system dependencies
```
$ jhbuild sysdeps --install
```

## More
More details can be found in the [JHBuild manual](https://developer.gnome.org/jhbuild/stable/) or on [HowDoI/JHBuild](https://wiki.gnome.org/HowDoI/Jhbuild)