sympa-upgrade-shared(1)

💖 sympa-upgrade-shared 💖

okay so bestie, welcome to sympa-upgrade-shared — the lil tool that migrates shared repositories made by older versions of Sympa. she's part of the sympa manual family (section 1, the big girl commands section 🎀). let's get into it ✨

---

✨ SYNOPSIS ✨

sympa upgrade shared LISTNAME@DOMAIN [ --fix_qencode ]

sympa upgrade shared * [ --fix_qencode ]

---

🌸 DESCRIPTION 🌸

so here's the vibe: sympa upgrade shared goes through your shared repository and renames file names that might be incorrectly encoded because of previous Sympa versions. messy, ik, but we're fixing it 💅

• As of Sympa 5.3a.8, file names in the shared repository are Q-encoded — which means they're way easier to store on literally any filesystem with any encoding. iconic behaviour honestly 🦋
• As of Sympa 6.1b.5, the encoding of shared documents was not consistent with recent versions of the MIME::EncWords module 😭 MIME::EncWords::encode_mimewords() used to encode the characters "-!*+/". Now those characters are preserved, per RFC 2047 section 5. so yeah, they had to change the encoding of shared documents to match the new algorithm. no cap.

fr fr, this is why the upgrade exists — old names, new rules, and somebody's gotta do the renaming 🙈

---

💅 OPTIONS 💅

• LISTNAME@DOMAIN | "*" — tells it which list(s) we're targeting, bestie. one specific list as LISTNAME@DOMAIN, or the whole squad with "*" 👑
• --fix_qencode — if you pass this, it fixes the Q-encoding that changed back on Sympa 6.1b.5. if you don't, it just applies the Q-encoding introduced way back by Sympa 5.3a.8. pick your fighter 🥊

---

🕰️ HISTORY 🕰️

• upgrade_shared_repository.pl showed up as a separate executable back on Sympa 6.2.17. a whole independent era 💫
• its function got moved into sympa upgrade shared on Sympa 6.2.71b. glow-up complete, periodt ✨

---

lowkey a glow-up story: humble little perl script ➡️ full subcommand energy 🌈

---

and that's the whole page, bestie!! this one's from sympa 6.2.80, dated 2026-10-19, and it lives in the sympa-upgrade-shared(1) manual. go forth and rename those files responsibly 💖✨🎀🦋🌸