jing(1)

📦
this version · 2 versions
  • debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • opensuse-leap 16.0
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ jing(1) — the vibe check for your XML ✨

okay so bestie, this is the jing manual page, living in the General Commands Manual section. If you've got an XML document and a RELAX NG schema and you need them to get along, this is your girl. 🫶

🌸 NAME 🌸

jing — validate an XML document using a RELAX NG schema 💅

🎀 SYNOPSIS 🎀

jing [-cfit] [-e encoding] rng-file [xml-file...]

that's the whole shape of it, no notes, periodt.

🦋 DESCRIPTION 🦋

okay so here's the tea, fr fr. You hand jing an rng-file and one or more xml-files. If rng-file is a correct RELAX NG schema and every single xml-file is a well-formed XML document that is valid with respect to rng-file, then jing says absolutely nothing — silent, iconic, no commentary — and terminates with a status of 0. 😌✨

but if that's not the case? she will speak up. jing reports one or more errors to the standard output and terminates with a status of 1. 💀 Not a crash, not a tantrum, just receipts.

Also important, bestie: both rng-file and xml-file can be filenames or URIs. She's flexible like that. 🌈

💖 OPTIONS 💖

  • -c — uses the compact syntax for the schema. cute and short, just how we like it. 🎀
  • -e enc — uses the encoding enc to read the schema. tell her what language the bytes are speaking, she'll listen. 🦋
  • -f — checks that the document is feasibly valid. A document is feasibly valid if it could be transformed into a valid document by inserting any number of attributes and child elements anywhere in the tree. This is equivalent to transforming the schema by wrapping every data, list, element and attribute element in an optional element and then validating against the transformed schema. This option may be useful while a document is still under construction. 🚧 This option also disables checking that for every IDREF there is a corresponding ID.
  • -i — disables checking of ID/IDREF/IDREFS. By default, Jing enforces the constraints imposed by RELAX NG DTD Compatibility with respect to ID/IDREF/IDREFS. so like, this is the "pls stop policing my references" flag. 🙈
  • -t — prints the time used by Jing for loading the schema and for validation. ⏱️ she's timed, she's transparent, she's showing her work.
heads up bestie: -f and -i are the two that turn off checking. Not "broken", just ✨ looser ✨. Know what you're doing before you flip them. 💅

👑 SEE ALSO 👑

💜 AUTHOR 💜

James Clark (jjc@jclark.com) — king behavior, honestly. 👑

This product includes software developed by the Apache Software Foundation (http://www.apache.org/). 🫶

and that's the whole page, bestie. this version was <rainbow>@VERSION@</rainbow> and it's the jing(1) page from the General Commands Manual, dated whenever this build got shipped. go validate something and slay. 💅✨🎀

📦 where this page comes from