UTRAC(1)

📦 version 0.3.0, in fedora 43, fedora 44

💖 utrac(1) — the manual page bestie 💖

okay so you're reading the utrac man page and honestly? good for you. this is the Alliance MCA girlie and she's here to help. let's get into it ✨

🌸 NAME 🌸

utrac — recognize and convert charset and end-of-line of text files. yeah that's the whole vibe. character sets AND line endings. iconic behavior honestly 💅

✨ SYNOPSIS ✨

utrac [OPTION] [FILE]

🦋 DESCRIPTION 🦋

so Utrac is a tool (and also a library, she contains multitudes 🫶) that recognize the charset and the end of line type used in a text file. and like. it can also convert it. slay.

but here's the tea bestie: in case of 8bits charsets, recognition is not sure. it's giving "idk maybe". so it can also assist the user to choose the correct charset — for instance by filtering the text and displaying only lines that matter. king behavior honestly 👑

👑 OPTIONS 👑

with no FILE, read standard input. with no OPTION, recognize and write converted text to standard output. no notes, perfect 💅

  • -p, --print-charset — print the name of the charset that suits best the input file. just the name. she's decisive.
  • -P, --print-all-charset — print ranked list of charsets. okay so the columns, let me break it down for you:
    • first column = the mark with locale bonus (language and system)
    • second = the mark brut
    • third = the checksum of all extended character (to know which charsets produce the same results)
    • fourth = the charset name — and it goes on the same line if their mark with bonus and their checksum are identical.

if the recognition is sure (ASCII or UTF-8), print only one name. periodt.

  • -f, --from — force input charset (disable recognition) and/or EOL. for instance, "UTF-8/CRLF". you're telling her what's up instead of letting her guess 🫶
  • -t, --to — select output charset and/or EOL. see above. same energy.
  • -L, --language — select language. all charsets that fit this language will get a bonus during recognition. if none specified, LC_* variables are used. she'll figure it out.
  • -S, --system — select system. all charsets that fit this language will get a bonus during recognition. (yes it says language, that's literally what it says, I'm not editing the queen's words)
  • -x, --ext-chars — print lines with extended characters (try to print each extended character not more than once). lowkey thoughtful of her.
  • -d, --distribution — print distribution, i.e. the count of each 8bits character. data girlie 📊
  • -a, --all-ext-chars — print each extended character of the file in each different charset (UTF-8 output is recommended). obsessed.
  • -c, --colors — (with -x or -a) use color. yes bestie, color 💖
  • -b, --bar — display a progress bar. we love a visual.
  • -i, --info — print default/chosen parameters. receipts ✨
  • -l, --list — list charsets/eol/languages/systems.
  • -h, --help — print some help. she's got you 🫶
  • -v, --version — print version.

🎀 FILES 🎀

  • charset.dat — this file should be located in /usr/local/share/utrac/ or /usr/share/utrac/. it contains informations about charsets and their related charmap. if you want to add new charsets (they must be 8bits and ASCII compatible, no exceptions), check the script merge.pl in Utrac source directory. go off, extend her 💅

💀 BUGS 💀

ngl Utrac is still a beta version, so you can expect to find some bugs... 😭 please report them to <antoine@alliancemca.net>. and if you have a text file that is not well recognize by Utrac, please send it to improve the recognition algorithm. help her grow fr fr 🫶

🌈 AUTHOR 🌈

written by Antoine Calando <antoine@alliancemca.net>. main character energy 👑

Copyright © 2004 Alliance MCA.

this is free software; see the source for copying conditions. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. read that again bestie. no cap. 🚨

🧚 SEE ALSO 🧚

you can find more documentation from http://utrac.sourceforge.net — go read, iykyk ✨

and that's the whole page bestie!! 💖 this was Utrac 0.3, dated January 2005, brought to you by Alliance MCA. vintage but still serving 🎀🦋💅

📦 where this page comes from