doctools::msgcat(3tcl)

✨ NAME ✨

doctools::msgcat — message catalog management for the various document parsers 💖

(it's a 3tcl manual page, bestie, from the tcllib crew 🫶)

---

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require msgcat

package require doctools::msgcat ?0.2?

::doctools::msgcat::init prefix

---

💅 DESCRIPTION 💅

okay so listen. The package doctools::msgcat is a support module that handles the selection of message catalogs for all the document processing packages in the doctools system version 2. That's the whole job, and it does it gorgeously. ✨

but here's the tea: it is an internal package. A regular user (developer) should not be in direct contact with it. it's giving backstage pass, not front row seats. 💀

If you are such a person, please go read the documentation of either:

1. doctools::doc,
2. doctools::toc, or
3. doctools::idx

Within the system architecture this package resides under the various parser packages, and is shared by them. Underneath it — but not explicit dependencies — are the packages providing the message catalogs for the various languages. so it's lowkey the middle child holding the whole group chat together 🧚

---

👑 API 👑

• ::doctools::msgcat::init prefix — the command locates and loads the message catalogs for all the languages returned by msgcat::mcpreferences, provided that they could be found. It returns an integer number describing how many packages were found and loaded. 🔥

The names of the packages the command will look for have the form "doctools::msgcat::prefix::langcode", with prefix being the argument to the command, and the langcode supplied by the result of msgcat::mcpreferences. iykyk 💅

---

😭 BUGS, IDEAS, FEEDBACK 😭

This document, and the package it describes, will undoubtedly contain bugs and other problems. no cap. 🙈

Please report such in the category doctools of the Tcllib Trackers at http://core.tcl.tk/tcllib/reportlist. Please also report any ideas for enhancements you may have for either the package and/or the documentation. we want the good ideas too, not just the oopsie ones 🫶

When proposing code changes, please provide unified diffs, i.e the output of diff -u. periodt.

Note further that attachments are strongly preferred over inlined patches. Attachments can be made by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar. the way that whole flow works... iconic. ✨

---

🌈 KEYWORDS 🌈

catalog package, docidx, doctoc, doctools, i18n, internationalization, l10n, localization, message catalog, message package

---

🎀 CATEGORY 🎀

Documentation tools

---

💜 COPYRIGHT 💜

Copyright (c) 2009 Andreas Kupries <andreas_kupries@users.sourceforge.net>

---

k bye bestie, that's the whole page — brought to you by tcllib, version 0.2, and yeah it's literally doctools::msgcat(3tcl). slay, go read the docs, mwah 💖🦋🌸