diff --git a/docs/user/locale/localeintro.dox b/docs/user/locale/localeintro.dox
index fd6ccc8b34..cfa11f74f1 100644
--- a/docs/user/locale/localeintro.dox
+++ b/docs/user/locale/localeintro.dox
@@ -15,4 +15,9 @@ use it with custom settings. For example, you may need to format a date with
 a fixed format in english for including in an e-mail header, as it is the only
 format accepted there.
 
+Unlike the other kits in Haiku, the Locale kit does not live in libbe. When
+building a localized application, you have to link it to liblocale.so. If you
+want to use the catalog macros, you also have to link each of your images
+(that is, applications, libraries and add-ons) to liblocalestub.a.
+
 */