diff --git a/src/js/utilsSlave.js b/src/js/utilsSlave.js
index 6b3bf0cdcd953a0cd4b6fa15b433d08cf1cc8eb5..3cc45175a183667e37728b6ee00206f877c1d8f5 100644
--- a/src/js/utilsSlave.js
+++ b/src/js/utilsSlave.js
@@ -1352,6 +1352,8 @@ App.Utils.setLocalPronouns = function(slave, suffix, pronouns) {
  * Fix nationalities as adjectives
  * @param {string} nation
  * @returns {string}
+ *
+ * Typical use case: "You have acquired one ${aNational(slave.nationality)} slave"
  */
 globalThis.aNational = function(nation) {
 	let country;
@@ -1373,6 +1375,8 @@ globalThis.aNational = function(nation) {
  * Fix nationalities as plurals
  * @param {string} nation
  * @returns {string}
+ *
+ * Typical use case: "You have acquired three ${moreNational(slave.nationality)} slaves"
  */
 globalThis.moreNational = function(nation) {
 	let country;
@@ -1398,6 +1402,8 @@ globalThis.moreNational = function(nation) {
  * Translate nationalities into the common name of the nation
  * @param {string} nation
  * @returns {string}
+ *
+ * Typical use case: "Your new slave is a refugee from ${nationOf(slave.nationality)}"
  */
 globalThis.nationOf = function(nation) {
 	let country;