Module...ngeSets(3pm)

🦋 Module::Install::DOAPChangeSets 🦋

okay so bestie, this is a 3pm page — that's User Contributed Perl Documentation energy, the kind of manual you find when you're deep in CPAN at 2am and honestly? iconic.

---

✨ NAME ✨

Module::Install::DOAPChangeSets — the way that you can write your distribution change log in RDF. no cap. 💅

---

🌸 DESCRIPTION 🌸

This package lets you write your Changes file in Turtle or RDF/XML, and then it autogenerates a human-readable text file for you. literally the whole glow-up, automated. ✨

So here's the vibe: you make an RDF file called meta/changes.ttl (or like, something in that lane — whatever you want honestly) and you describe your distribution's changes in RDF using the Dublin Core, DOAP, and DOAP Change Sets vocabularies. then, in your Makefile.PL, you include this:

write_doap_changes "meta/changes.ttl", "Changes", "turtle";

and this line will:

1. read your data from the file named as the first argument 🥇
2. parse it using either the Turtle or RDFXML parsers (that's the third argument) 🥉
3. output a human-readable changelog to the file named as the second argument 🥈

the defaults are meta/changes.ttl, Changes, turtle — so if you name your files exactly like that, you can just dip on all the arguments entirely and drop this into your Makefile.PL:

write_doap_changes;

so clean. so minimal. we love a zero-argument moment. 🫶

there's also a line you can use to output a Changes.xml file, if that's more your thing:

write_doap_changes_xml "meta/changes.ttl", "Changes.xml", "turtle";

💜 Integration with Module::Install::RDF 💜

okay so Module::Install::RDF reads all the RDF it can find in 'meta'. and here's the tea: if you invoke Module::Install::RDF before invoking Module::Install::DOAPChangeSets, then this module will use Module::Install::RDF's copy of the data. sharing is caring, bestie. 💖

---

👑 WHY? 👑

why not?

(i mean. periodt.)

---

💀 BUGS 💀

Please report any bugs to <http://rt.cpan.org/>. don't be shy, they wanna hear it fr fr. 🙈

---

🌈 SEE ALSO 🌈

• Module::Install
• Module::Install::DOAPChangeSets::Format
• Module::Install::RDF
• <http://www.perlrdf.org/>

---

🎀 AUTHOR 🎀

Toby Inkster <tobyink@cpan.org>. king behavior. 👑

---

💖 COPYRIGHT AND LICENSE 💖

Copyright (C) 2010-2011 by Toby Inkster

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

and that's the whole page, bestie!! this was perl v5.34.0, dated 2022-06-15, from the Module::Install::DOAPChangeSets 3pm manual — mwah, slay, go write your changelog in RDF, you absolute main character. 💅✨🦋