From 97ee8e9b9dd799e6fec3176349b050a72629486c 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

---
 Manual.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/Manual.md b/Manual.md
index da72bd97128d..32dfbe6397b9 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](#commonbuildproblems)
+		* [Unresolvable shlib](#unresolvableshlib)
 	* [Package naming conventions](#namingconventions)
 		* [Libraries](#libs)
 		* [Language Modules](#language_modules)
@@ -192,6 +194,22 @@ 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`).
 
+<a id="commonbuildproblems"></a>
+### Common Build Problems
+
+<a id="unresolvableshlib"></a>
+#### 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