DTHELPSETCATALOGNAME(3)

💖 DtHelpSetCatalogName (library call) 💖

🌸 NAME 🌸

DtHelpSetCatalogName — assign the name of the message catalog to use for help services. 🎀

✨ SYNOPSIS ✨

#include &<Dt/Help.h>
void DtHelpSetCatalogName(
char *catFile);

🦋 DESCRIPTION 🦋

The DtHelpSetCatalogName function is the interface apps use to set the name of the message catalog file that the help services library uses at runtime. 🫶 This message catalog contains all strings, messages, and button labels used in the help widgets that can be localized. It’s giving “all the localizable help-widget text lives here” energy, no cap. ✨

The catFile argument specifies the name of the message catalog file that the help services library accesses at runtime. For more info on the message catalog naming and location semantics for various environments, see catopen3C. 💅

💀 RETURN VALUE 💀

The DtHelpSetCatalogName function returns no value. That’s it — literally no value, bestie. 😭

🌈 APPLICATION USAGE 🌈

Okay so this function is only required if applications deliver localized online help information into a non-localized XCDE desktop environment. 🎀 In this case, applications must use this function and give the help message catalog file a unique name in order to avoid collision with other clients using and localizing their online-help user interface. Unique name = no chaotic catalog collisions, iykyk. 💖

For this call to properly affect the help services library, this call must be made prior to creation of any help widgets. 🚨

⭐ SEE ALSO ⭐

• Dt/Help.h - DtHelp(5), DtCreateHelpQuickDialog(3), DtCreateHelpDialog(3); catopen3C.

🎀 Footer/source-version-date sign-off: this page’s footer is just DtHelpSetCatalogName(library call) — no separate source/version or date line in the original, so that’s the whole footer vibe, bestie. 🎀