DTDFORMAT(1p)

✨ dtdformat ✨

okay bestie, so this is dtdformat, a little Perl-era icon from the User Contributed Perl Documentation corner of manual page section 1p. she reads a DTDParse XML file and turns it into formatted documentation. she's giving very much "I take your weird XML and make it cute and readable" energy. 💅

---

🌸 NAME 🌸

dtdformat — read a DTDParse XML file and produce formatted documentation. literally that's the whole job. no cap. 💖

---

🦋 SYNOPSIS 🦋

dtdformat [options] xmlfile

---

✨ DESCRIPTION ✨

so dtdformat generates formatted documentation based upon a DTDParse XML file that was created by dtdparse. that's the pipeline, bestie — dtdparse does the parsing, dtdformat does the glow-up. 🎀

the following documentation formats are supported:

• HTML — designated by the --html option. 🌈
• DocBook Refentry — designated by the --refenty option. 📖

🚨 okay important: one of the above formats must be specified, or dtdformat will abort with an error. like, she will simply not proceed. no format, no service. 💀

---

👑 OPTIONS 👑

• --appears-in, --noappears-in — include what an entity and/or element appears in. the default is to include. 🫶
• --attributes, --noattributes — include, or not include, element attributes in documentation. the default is to include. ✨
• --base-dir — root directory to place documentation. 📁
• --base-id name — entity name prefix for entities defined in DocBook RefEntry, --refentry, output. if not specific, dtdparse is used. 🏷️
• --chilren, --nochilren — include, or not include, list of children for elements. the default is to include. (yes, the spelling is chilren. she said what she said. copy it exactly or she'll be confused. 🙈)
• --content-model — include, or not include, element content models in documentation. 🧩
• --debug — enable debugging output. 🐛
• --description — include, or not include, Description sections in documentation. the default is to include. 📝
• --examples, --noexamples — include, or not include, Example sections in documentation. the default is to include. 💡
• --exclusions, --noexclusions — include, or not include, element exclusions in documentation. the default is to include. 🚫
• --html — generate HTML documentation. 🌐
• --inclusions, --noinclusions — include, or not include, element inclusions in documentation. the default is to include. ➕
• --parents, --noparents — include, or not include, possible element parents in documentation. the default is to include. 👨‍👩‍👧
• --refentry — generate DocBook Refentry (manpage) documentation. 📜
• --synopsis, --nosynopsis — include, or not include, element synopses in documentation. the default is to include. 🔍
• --tag-minimization, --notag-minimization — include, or not include, element tag minization settings in documentation. the default is to include. ✂️
• --unexpanded, --nounexpanded — included, or not include, unexpanded content models in element documentation. the default is to include. 🫧
• --verbose, --noverbose — output progress (the default). 📢
• --version — print program version and synopsis. ⭐
• --help — print program synopsis and options available. 🆘
• --man — print program manual page. 📚

---

💜 SEE ALSO 💜

• dtdparse
• see SGML::DTDParse for an overview of the DTDParse package. 🧚

---

🍓 PREREQUISITES 🍓

Getopt::Long, XML::DOM

---

🔥 AVAILABILITY 🔥

<http://dtdparse.sourceforge.net/>

---

🌈 AUTHORS 🌈

originally developed by Norman Walsh, <ndw@nwalsh.com>.

Earl Hood <earl@earlhood.com> picked up support and maintenance. iconic handoff, honestly. 👑

---

💖 COPYRIGHT AND LICENSE 💖

see SGML::DTDParse for copyright and license information.

---

and that's the whole page, bestie!! 💅✨ this one came from perl v5.32.1, dated 2022-01-21, and it lives in section DTDFORMAT(1p) — go forth and format your DTDs, you absolute main character. 🎀🦋💜