CIFPARSE(1)

✨ CIFPARSE ✨

okay bestie, listen up 💖 this is cifparse, a lil command from the General Commands Manual section of your Unix system, and she's here to parse CIF file(s), check syntax, and optionally output pretty-printed data. that's literally the whole job. and she ate. 💅

---

🌸 NAME 🌸

cifparse — parse CIF file(s), check syntax, and optionally output pretty-printed data. no cap, that's it. that's the girl. 🎀

---

🦋 SYNOPSIS 🦋

src/components/codcif/cifparse --options < input.cif

src/components/codcif/cifparse --options input.cif

src/components/codcif/cifparse --options input1.cif input2.cif
inputs*.cif

so you can pipe stuff in, hand her one file, or hand her a whole lil squad of files and let the shell glob do its thing. options first, files after. slay. ✨

---

💜 DESCRIPTION 💜

Parse CIF file(s), check syntax, and optionally output pretty-printed data.

yeah. that's the vibe check. she reads your CIF, makes sure it's not a mess, and if you ask nicely she'll print it back out all glowed up and pretty. 👑

---

🎀 OPTIONS 🎀

• -c, --compile-only — only compile the CIF (check syntax). she prints out the filename plus OK or FAILED to STDOUT, and any error messages go to STDERR. no pretty printing, just the ✨judgement✨.
• -f, --fix-syntax — attempt to fix some errors in input CIF files, such as missing data_ headers or unterminated quoted strings. she's being nice about it. 🫶
• -f-, --dont-fix-syntax — do not attempt to fix syntax errors in input CIF files. leave the chaos exactly as you found it. 💀
• -p, --print — print out data in CIF format. it's giving CIF pretty-printer, and honestly? iconic. 🦋
• -d, --debug lex,yacc — specify one or several (comma-separated) debugging options. currently supported debugging options are:
  • dump — dump internal data structures for inspection. 🕵️‍♀️
  • lex — switch on (F)LEX token printout. every token, out loud, main character energy.
  • yacc — ask YACC/BISON to report which rules they reduce. 🧚
  • yylval — print out YACC/BISON's yylval.
  • text — dump the perceived input file text.
  • code — dump intermediate CIF code representation.
• -l, --line-length-limit 80 — set the maximum line length for --report-long checks. so she knows when a line is being extra. 📏
• -w, --dataname-length-limit 74 — set the maximum tag length for --report-long checks. same energy, but for the data names this time. ✨
• -q, --quiet — be quiet, only output error messages and data. she's not gonna yap. 🎀
• -q-, --no-quiet, --verbose — produce verbose output of the parsing process. now she WILL yap. every step. you asked for this. 💅
• -r, --report-long-items — report CIF items (lines, data names) that are longer than mandated by the standard. snitch behaviour, but make it helpful. 🔥
• -r-, --do-not-report-long-items — ignore long items in CIF, process all data. no snitching today, we're chill. 🌈
• -s, --suppress-errors — suppress error messages from the parser. she's pretending she didn't see that. 🙈
• -s-, --do-not-suppress-errors — print parser messages to STDERR (default). yeah, she's telling you everything. 😭
• -M, --dump-messages — do not use accumulated CIF messages (default). that's the default setting btw, keep that in mind. 💜
• -M-, --do-not-dump-messages — dump accumulated message texts from the CIF object. yes bestie, the - flipped the whole meaning, that's just how this girl works. 🌸
• -u, --unfold-lines — unfold long lines (default). she likes them stretched out and readable. ⭐
• -u-, --do-not-unfold-lines — leave folded lines as they are. respect the fold. 🧚
• --version — print program version (SVN Id) and exit. cute lil flex, then she's gone. 👑
• --help — print short usage message (this message) and exit. she'll tell you how to use her, then dip. 💖

---

💀 REPORTING BUGS 💀

found a bug? report cifparse bugs using e-mail: cod-bugs@ibt.lt

bestie pls don't just suffer in silence, the maintainers genuinely wanna know. 📧

---

okay that's the whole page 💅 this was cifparse, from the General Commands Manual — aka CIFPARSE(1), section 1, which is the classic Unix section number that shows up in her header and then shows up again at the bottom as the footer, bc that's just how manpages dress themselves. 🎀 go parse something gorgeous. 🦋✨🌸💖