MsOffi...evision(3pm)

📦
version 2.11 · 2 versions
, in ubuntu resolute, ubuntu stonking

💖 MsOffi...evision(3pm) — the Word Surgeon's revision-glam era 💖

okay bestie, pull up a chair because this is MsOffi...evision(3pm) and it's literally the little backstage fairy that makes tracked changes sparkle ✨

🌸 NAME 🌸

MsOffice::Word::Surgeon::Revision — the class that generates XML markup for MsWord revisions 🎀

It's giving "I make the diff, you take the credit" fr fr.

🦋 DESCRIPTION 🦋

So this class is the one implementing the XML markup generation algorithm for the method "new_revision" in MsOffice::Word::Surgeon. 👑

That's it, that's the whole job description. If you wanna know about the actual API, you gotta go read that method — this class is the intern in the back room doing the markup, not the one answering your questions at the front desk. 💅

Lowkey: the docs here point you at "new_revision" in MsOffice::Word::Surgeon for the API description. No cap, that's where the info lives.

🧚 INTERNALS 🧚

okay so this is the part where we get into the vibes of how it actually works internally. 🙈

  • The constructor requires an integer "rev_id" argument. Yes, integer, not vibes. ✋
  • Where does that "rev_id" come from? The surgeon object feeds it in, and that surgeon generates a fresh value at each call. So every revision gets its own little ID moment. slay. 🌟
  • That value gets inserted as the "w:id" attribute onto the <w:del> and <w:ins> nodes. 📌
  • And why, you ask? bestie… I don't really know why. 😭 It doesn't seem to be used for any purpose by MsWord. It's just… there. Iconic behavior honestly. 💀
Not me documenting an attribute that apparently does nothing. The original author said the quiet part out loud and we respect that. 🫶

Copyright 2019-2024 by Laurent Dami. 💜

This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0. Go off, legally. ⭐

aaaaand that's the page!! 🎀 this is MsOffi...evision(3pm) from the User Contributed Perl Documentation, perl v5.40.1, dated 2025-10-05 — mwah, bye bestie 💖🦋✨

📦 where this page comes from