m17nDebug(3m17n)

📦
version 1.8.4 · 2 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🦋 m17nDebug — bestie edition (from the m17n manual, section 3m17n) 🦋

okay so this is m17nDebug from The m17n Library, and it's literally the debug support page. it's giving "your code is misbehaving and you need receipts" energy 💅

✨ NAME ✨

m17nDebug_ - Debug - support for m17n library users to debug their programs. that's the whole vibe. it's here to help you, the person writing m17n code, figure out what on earth is going on 🫶

🌸 SYNOPSIS 🌸

🎀 Functions

  • MFace * mdebug_dump_face (MFace *face, int indent) — dump a face 💖
  • MInputMethod * mdebug_dump_im (MInputMethod *im, int indent) — dump an input method 🌈
  • int mdebug_hook () — hook function called on an error 👀
  • MText * mdebug_dump_mtext (MText *mt, int indent, int fullp) — dump an M-text 🦋
  • MSymbol mdebug_dump_symbol (MSymbol symbol, int indent) — dump a symbol ⭐
  • MSymbol mdebug_dump_all_symbols (int indent) — dump all symbol names 👑

💜 Detailed Description 💜

Support for m17n library users to debug their programs. fr fr, that's the mission statement.

the m17n library provides the following facilities to support the library users to debug their programs. not me handing you a whole toolkit 🧰✨

  • Environment variables to control printing of various information to stderr.
    • MDEBUG_INIT -- if set to 1, print information about the library initialization on the call of M17N_INIT().
    • MDEBUG_FINI -- if set to 1, print counts of objects that are not yet freed on the call of M17N_FINI().
    • MDEBUG_CHARSET -- if set to 1, print information about charsets being loaded from the m17n database.
    • MDEBUG_CODING -- if set to 1, print information about coding systems being loaded from the m17n database.
    • MDEBUG_DATABASE -- if set to 1, print information about data being loaded from the m17n database.
    • MDEBUG_FONT -- if set to 1, print information about fonts being selected and opened.
    • MDEBUG_FLT -- if set to 1, 2, or 3, print information about which command of Font Layout Table are being executed. the bigger number prints the more detailed information. 🔍
    • MDEBUG_INPUT -- if set to 1, print information about how an input method is running.
    • MDEBUG_ALL -- setting this variable to 1 is equivalent to setting all the above variables to 1. the "select all" of debug flags, iconic behavior, no notes 💅
    • MDEBUG_OUTPUT_FILE -- if set to a file name, the above debugging information is appended to the file. if set to 'stdout', the information is printed to stdout.
  • Functions to print various objects in a human readable way. see the documentation of mdebug_dump_XXXX() functions. 🎀
  • The hook function called on an error. see the documentation of mdebug_hook(). 👀

🌟 Author 🌟

Generated automatically by Doxygen for The m17n Library from the source code. yes bestie, a robot wrote this, we're all just living in its world 🤖💖

Copyright (C) 2001 Information-technology Promotion Agency (IPA)

Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License <http://www.gnu.org/licenses/fdl.html>.

lowkey important: those copyright lines and the license grant are the real deal, don't skip them 🫶

and that's a wrap, bestie!! this page is from Version 1.8.4, dated Mon Sep 25 2023, living its best life in section 3m17n of The m17n Library manual. go debug something iconic ✨💅

📦 where this page comes from