From baa416b9197dc41f30a1891a585919098e2f69dd Mon Sep 17 00:00:00 2001
From: Pierre Nicolas <pierre.nicolas@savoirfairelinux.com>
Date: Tue, 22 Oct 2024 14:04:04 -0400
Subject: [PATCH] misc: update readme

Give a hint for `pkg-config` troubleshoot.

Change-Id: I0ffea826a011c7f0bc93d456b600134cf11ac11a
---
 README.md | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 97b2da371..e9d5ce03c 100644
--- a/README.md
+++ b/README.md
@@ -62,17 +62,28 @@ Make sure to have the Android SDK and NDK available.
 
 ## Build instructions
 
-With Android Studio:
+### With Android Studio:
+
 * Add 'jami-android' in Android Studio
 * Click on build
 * Enjoy!
 
-With the command line:
+### With the command line:
+
 ```sh
 cd jami-client-android/jami-android
 ./gradlew assembleDebug
 ```
 
+### Troubleshoot
+
+Jami Android doesn't use the system's `pkg-config`; it builds its own version with custom parameters to support cross-compilation. However, after cleaning the project, `pkg-config` may not be rebuilt, which could result in falling back to the system's version, leading to errors when trying to locate shared libraries.
+
+```sh
+cd jami-client-android/daemon/extras/tools
+./bootstrap && make
+```
+
 ## Update translations
 
 Update translations using the Transifex client (tx) :
@@ -80,14 +91,14 @@ Update translations using the Transifex client (tx) :
 ./update-translations.sh
 ```
 
-# Generate new release commit
+## Generate new release commit
 
 Generate a new release commit updating the version code and version string:
 ```sh
 ./update_version.py --commit
 ```
 
-# Report issues
+## Report issues
 
 Report issues on Gitlab:
 https://git.jami.net/savoirfairelinux/jami-client-android
-- 
GitLab