GLA11Y(1)

💖 NAME 💖

okay bestie, meet gla11y — a User Command (formally GLA11Y(1), if we're being ✨proper✨ at the function) that checks the accessibility of glade .ui files. it literally reads your UI files and goes "girl… where is the label tho?" 💅 no cap.

---

🦋 SYNOPSIS 🦋

gla11y [-p] [-g SUPPR_FILE] [-s SUPPR_FILE] [-f SUPPR_FILE] [-P PREFIX]
[-o LOG_FILE] [file ...]

---

🌸 DESCRIPTION 🌸

gla11y checks accessibility of glade .ui files. that's the whole assignment. slay. ✨

here's the rundown of everything it takes, and yes we're doing all of them, i'm not skipping a single one:

• -p — print the XML class path instead of the line number. like, give me the whole lineage instead of just the address, iykyk.
• -g SUPPR_FILE — generate a suppression file called SUPPR_FILE. you're making the list, bestie.
• -s SUPPR_FILE — suppress the warnings that SUPPR_FILE tells you about, but still count them. muted, not deleted. 🙈
• -f SUPPR_FILE — suppress the warnings given by SUPPR_FILE completely. not just muted — fully ghosted. 💀
• -P PREFIX — remove PREFIX from file names in warnings. a little path glow-up, we love to see it. 🎀
• -o LOG_FILE — also prints errors and warnings to the given file. so you get the receipts. 🧾
• --widgets-FOO [+][CLASS1[,CLASS2[,...]]] — give or extend one of the lists of widget classes, where FOO can be:
  • toplevel — widgets to be considered toplevel windows
  • ignored — widgets which do not need labelling (e.g. GtkBox)
  • suffixignored — suffixes of widget classes which do not need labelling
  • needlabel — widgets which always need labelling (e.g. GtkEntry)
  • buttons — widgets which need their own label but not more (e.g. GtkButton)
  • labels — widgets which provide labels (e.g. GtkLabel)
• --widgets-print — print default widgets lists
• --enable-all — enable all warnings/dofatals. this is the default, bestie, it's already on. 👑
• --disable-all — disable all warnings/dofatals
• --fatal-all — make all warnings dofatals
• --not-fatal-all — do not make all warnings dofatals (also the default)
• --enable-type=TYPE — enable warning/fatal type TYPE
• --disable-type=TYPE — disable warning/fatal type TYPE
• --fatal-type=TYPE — make warning type TYPE a fatal
• --not-fatal-type=TYPE — make warning type TYPE not a fatal
• --enable-widgets=CLASS — enable warning/fatal type CLASS
• --disable-widgets=CLASS — disable warning/fatal type CLASS
• --fatal-widgets=CLASS — make warning type CLASS a fatal
• --not-fatal-widgets=CLASS — make warning type CLASS not a fatal
• --enable-specific=TYPE.CLASS — enable warning/fatal type TYPE for widget class CLASS
• --disable-specific=TYPE.CLASS — disable warning/fatal type TYPE for widget class CLASS
• --fatal-specific=TYPE.CLASS — make warning type TYPE a fatal for widget class CLASS
• --not-fatal-specific=TYPE.CLASS — make warning type TYPE not a fatal for widget class CLASS
• --disable-orphan-labels — only warn about orphan labels when there are orphan widgets in the same context. like, if nobody's around, the label can just vibe. 🦋

ok so important lore: by default, all warnings are considered fatal, except a few kinds (duplicate-mnemonic, labelled-by-and-mnemonic, orphan-label) which could be only doubtful. those ones are just like… maybe? possibly? we don't know her. 💅

---

🫶 REPORTING BUGS 🫶

found something cursed? report bugs to <bugs@hypra.fr> 💌

---

and that's the page, bestie!! this was gla11y 0.4, from July 2023, and honestly? iconic. periodt. 💖✨🎀