MYTOOL(1)

🌸 NAME 🌸

ok so bestie, meet mytool — she's the one who manipulates map files for yudit, uniconv and uniprint. 💅

She lives in the LINUX COMMANDS manual, section 1, and she is lowkey iconic for it.

---

✨ SYNOPSIS ✨

mytool [ -info ] [ -test ] [ -showkeys ] [ -decode ] [ -encode ] [ -strip ] [ -benchmark ] [ -name new-name ] [ -comment new-comment ] [ -type new-type ] [ -write output-file ] [ -my input-file ] [ -mys input-file ] [ -rmys input-file ] [ -kmap input-file ] [ -rkmap input-file ] [ -uni:l,u input-file [ -8 ] [ -high ] [ -low ] [ -runi:l,u input-file [ -8 ] [ -high ] [ -low ] ] [ -convert out-file-format ]

no cap, that's the whole vibe check right there 💖

---

🦋 DESCRIPTION 🦋

mytool is a my map file manipulation program in the yudit distribution. She can generate a so-called binary nbit ( my ) map file that can map any sequences of bytes into any sequences of bytes. Those sequences of bytes can be grouped into 1, 2, 4 and 8 bytes long words. The input sequence length may be different from the matched sequence length. 'i / 'n -> 'b specifies that the word 'in' produces 'b' but only the 'i is consumed from the input buffer. 😭 (yes she's like that, she's precise)

She can also generate a so-called binary umap file, that maps 8 or 16 bit single words into 16 bit single words — and it contains the reverse map too. 🔥

She can also disassemble the input map and produce a mys source file. ✨

The input can be a binary umap file, a my file, a mys file, a uni and a kmap file for yudit. It is recommended that all kmap files use the new mys format because it gives more freedom to define the mapping. 👑

The yudit distribution has a simple document yudit/doc/my.doc on the binary map formats, and a source file example file yudit/mytool/my/example.mys — please refer to this for more details. 🫶

---

💅 OPTIONS 💅

• -info — prints out a small information on the current map. a lil peek, a lil tea ☕
• -test — lets you test the map interactively. play with it, bestie 🎀
• -showkeys — show all the keys in the map file. 🔑
• -encode — builds a state machine in the encoding part of the map file. The resulting map file can be written to disk with the -write option. The resulting my files can contain state machines to speed-up conversion. A state machine based my file can manifest 10%-70% performance improvement, so it may be desirable for encoding fontmaps. For fontmaps the bumap format might be better suited where only one character and not a sequence of characters need to be mapped. 🔥
• -decode — builds a state machine in the decoding part of the map file. 🌀
• -strip — strips off the state machines from the map files. The -write option can be used to save the new map file. ✂️
• -benchmark — option performs a simple benchmark test on the map file, to compare speed of simple, state machine based and binary map based map files. ⏱️
• -nocomment — option strips all comments from an input source file of format mys kmap uni. It does not strip comments from a binary file. 🙈
• -name new-name — assigns a name to the map file. 🏷️
• -comment new-comment — assigns a comment to the map file. 💬
• -type new-type — assigns a map file a distinctive type, that can be kmap or fontmap but it is only informative. Keymaps can be used as fontmaps and vice versa. iykyk
• -write output-file — writes the data into an output file. mytool never modifies the original file. All modifications should be explicitly saved with the this option.

🚨 Never specify the same file for input and output. fr fr, do not do that.

• -my input-file — load a binary map file. Only one of this option can be specified. one (1) only, bestie 💀
• -mys input-source-file — load a source file. 📄
• -rmys input-source-file — load a source file and reverse it - make encoding from decoding and vice versa. 🔄
• -kmap input-source-file — load a source file in kmap format. 🗺️
• -rkmap input-source-file — load a source file and reverse it - make encoding from decoding and vice versa. 🔁
• -uni:l,u input-source-file — load a source file in Unicode Consortium format. This format has the local code in column l, and unicode in column u. The numbering of columns start from 0. 🌈
• -runi:l,u input-source-file — load a source file in Unicode Consortium format and reverses it. Make encoding from decoding and vice versa. 💫
• -8 — option can be used with the -uni or -runi options. It specifies that the input is 8 bit and not 16 bit. 8️⃣
• -high — option can be used with the -uni or -runi options. It specifies that the key should be or'ed with 0x8080. ⬆️
• -low — option can be used with the -uni or -runi options. It specifies that the key should be and'ed with 0x7f7f. ⬇️
• -convert output-file-format — converts the map file to a format. It is useful only when combined with -write option. The possible formats are my -binary, mys -source, myc -my-c-source, umap -umap-c-source, bumap -binary-umap formats. For maps where only a single 8 or 16 bit local code should be converted into 16 bit unicode and vice versa, the umap file formats are recommended. The c-source files are provided so that you can inlucde a full map into the c program. 👑

---

😭 DIAGNOSTICS 😭

mytool prints out an error message and exits with a non-zero status on error. If there is no error the exit status is zero. she tells you when something's wrong, she's not gonna ghost you 💖

---

🫶 SEE ALSO 🫶

• uniconv

---

👑 AUTHOR 👑

This program was written by gsinai@iname.com (Gaspar Sinai). ✨

Tokyo, 03 January, 2000.

---

and that's the whole page, bestie 💜 this one came out of the LINUX COMMANDS manual, dated Jan 03 2000, under the MYTOOL(1) name — she ate and left no crumbs, periodt 🎀🦋🌸