CDIST-TYPE__LOCALEDEF(7)

✨ cdist-type__localedef ✨

ok so bestie, this is a cdist type — section 7 of the manual, cdist-type__localedef — and it's literally here to handle your system locales for you. 💖

---

🌸 NAME 🌸

cdist-type__localedef — define and remove system locales 🦋

---

💅 DESCRIPTION 💅

This cdist type lets you define locales on your system using localedef(1), or remove them. That's it, that's the gig. 👑

but heads up: on systems that don't support defining new locales, this type will raise an error. so like, if your system can't do the thing, it's not gonna pretend it can, it's gonna yell at you. 😭

NB: this type respects the glibc locale.alias file — i.e. it defines alias locales, or deletes aliases of a locale when that locale gets removed. it's giving considerate. 🫶

However — and this is the part where you go "oh 😳" — it is not possible to:

• use alias names to define locales, or
• only remove certain aliases of a locale.

so close, yet so far. 🎀

---

✨ OPTIONAL PARAMETERS ✨

• state — present or absent. Defaults to present. that's the whole list, she's a simple queen. 💅

---

🎀 EXAMPLES 🎀

# Add locale de_CH.UTF-8
__localedef de_CH.UTF-8

# Same as above, but more explicit
__localedef de_CH.UTF-8 --state present

# Remove colourful British English
__localedef en_GB.UTF-8 --state absent

ok but "remove colourful British English" is sending me 💀🇬🇧

---

👀 SEE ALSO 👀

locale(1), localedef(1), cdist-type__locale_system(7)

go read those, they're the supporting cast. 🌈

---

🌟 AUTHORS 🌟

• Dennis Camera <dennis.camera--@--ssrq-sds-fds.ch>
• Nico Schottelius <nico-cdist--@--schottelius.org>

(yes the --@-- is really in there, it's not a typo, don't @ me 🙈)

---

💜 COPYING 💜

Copyright (C) 2013-2019 Nico Schottelius, 2020 Dennis Camera. Free use of this software is granted under the terms of the GNU General Public License version 3 or later (GPLv3+).

---

👑 COPYRIGHT 👑

ungleich GmbH 2021

---

and that's the whole page bestie!! this was cdist version 7.0.0, dated Jul 31, 2022, and it's the CDIST-TYPE__LOCALEDEF(7) page. slay, go forth and localedef responsibly. 💖✨🦋