From 47add0262de9bbd849a0f7bea831bca3c435fd60 Mon Sep 17 00:00:00 2001
From: Jasper Chan <jasperchan515@gmail.com>
Date: Tue, 18 Jan 2022 03:21:01 -0800
Subject: [PATCH] Manual.md: Document unresolvable shlib issue
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Érico Nogueira Rolim <34201958+ericonr@users.noreply.github.com>
---
 Manual.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/Manual.md b/Manual.md
index da72bd97128d..e8e9dd0c621b 100644
--- a/Manual.md
+++ b/Manual.md
@@ -8,6 +8,8 @@ packages for XBPS, the `Void Linux` native packaging system.
 * [Introduction](#Introduction)
 	* [Quality Requirements](#quality_requirements)
 	* [Package build phases](#buildphase)
+	* [Common Build Problems](#common-build-problems)
+		* [Unresolvable shlib](#unresolvableshlib)
 	* [Package naming conventions](#namingconventions)
 		* [Libraries](#libs)
 		* [Language Modules](#language_modules)
@@ -192,6 +194,21 @@ via `make install` or any other compatible method.
 successfully, the phase will be skipped later (unless its work directory
 `${wrksrc}` is removed with `xbps-src clean`).
 
+### Common Build Problems
+
+#### Unresolvable shlib
+
+If you get an error like the following while building:
+
+```
+enchant2-2.2.15_4: broken, unresolvable shlib `libicudata.so.69'
+```
+
+It's likely that the Void Buildbot has recently rebuilt a library and has not rebuilt some packages that depend on it.
+You can check https://build.voidlinux.org/ for the current status of the builders.
+
+Once the dependent packages have finished building on Buildbot your build should succeed.
+
 <a id="namingconventions"></a>
 ### Package naming conventions