METAXREF(1)

🌸 METAXREF — the metaxref manual, bestie edition 💖

okay so this is the page for metaxref, from the General Commands Manual section 1, and honestly? it's a whole vibe. sit down, grab a strawberry, let's go 🍓

---

✨ NAME ✨

metaxref — builds cross-reference file/unit/item information. that's the whole job. she builds the cross-reference, she does it well, no notes 💅

---

🦋 SYNOPSIS 🦋

metaxref [ -dhkmsV ] [ -f manifest ] [ -L dir ]

---

👑 DESCRIPTION 👑

so here's the tea, bestie: metaxref is a program that scans all the files in your MANIFEST file and produces three files full of info about how the files in that MANIFEST reference items defined by metaconfig's unit files. three whole files. she's thorough like that ✨

the first two files, I.fui and I.uif, reference the file, unit and items — just sorted differently from each other. same info, different glow-up. the third file, Obsolete, dumps all the known obsolete symbols, in which file they appear, and the new symbol that should be used instead. so you literally know exactly what to swap in. convenient? iconic, actually 🌈

okay so important: obsolete symbols do not appear in the main cross-reference files. they are only listed in the Obsolete file. that's yet another incentive to use the new symbols in your sources. :-) yes queen, upgrade your symbols 🙈

---

💅 OPTIONS 💅

Metaxref recognizes the following options:

• -d — Turn on debug mode. she's telling you everything, no secrets 💜
• -f manifest — Use an alternate manifest file.
• -h — Print help message and exit. she's got you, boo 🫶
• -k — Keep temporary .MT directory. no take-backs, we're keeping it.
• -m — Assume lots of memory and swap space. this will drastically improve the symbol lookup time in your source files, at the expense of memory usage. she's fast and she's hungry 😭🔥
• -s — Turn on silent mode. shhh 🤫
• -L dir — Override default library location (where the U units directory can be found).
• -V — Print version number and exit.
• -X file — When examining the source files, ignore any symbols listed in the file. this is useful in situations where a particular unit is known not to be needed for your package's portability targets, but your source files nevertheless contain occurrences of words that look to metaconfig like symbols defined in that unit. (For example, you might need the word "index" in a source file, but not need the unit that determines whether strcpy or index should be used.) the file can contain blank lines, comment lines introduced with #, and lines containing a single symbol. if this option is not supplied, any variable in .package is honored instead. the way that she just lets you ✨opt out✨ of a symbol? main character energy, fr fr.

---

🎀 AUTHOR 🎀

Harlan Stenn <harlan@mumps.pfcs.com>

give her her flowers, she earned them 💐

---

🌸 FILES 🌸

• LIB/dist/mcon/U/*.U — Public unit files.
• U/*.U — Private unit files
• I.fui — Lists information sorted by file, unit and item.
• I.uif — Lists information sorted by unit, item and file.
• Obsolete — Lists all the obsolete symbols used by the sources.

where LIB is /usr/share/dist.

---

💀 BUGS 💀

Metaxref will list among the wanted items all those magic symbols defined within units on the ?M: lines. those are relevant only when metaconfig is invoked with the -M option. so like… not a bug exactly but she's being extra about it and you should know 🙈

---

🔥 SEE ALSO 🔥

• metaconfig(1)
• metalint(1)

iykyk 👑

---

Version 3.5 PL0 — and that's the whole page, bestie. go forth, build your cross-references, and remember: use the new symbols. periodt. 💖✨🎀🦋🌸💅🫶