UPGRADE_SHARED_REPOSITORY(1)

✨ NAME ✨

upgrade_shared_repository, upgrade_shared_repository.pl — bestie, this is the lil script that migrates your shared repository when it was made by older versions 💖

---

🌸 SYNOPSIS 🌸

upgrade_shared_repository.pl --list LISTNAME --robot DOMAIN --all_lists
  [ --fix_qencode ]

---

🎀 DESCRIPTION 🎀

upgrade_shared_repository.pl renames file names inside shared repositories when those names might be encoded wrong because of previous Sympa versions. It's giving cleanup era, no cap 🧹✨

• As of Sympa 5.3a.8, file names in the shared repository are Q-encoded, which lowkey makes them way easier to store on any filesystem, with any encoding. iconic behaviour honestly.
• As of Sympa 6.1b.5, the encoding of shared documents was not consistent with the recent version of the MIME::EncWords module 😭 Like, MIME::EncWords::encode_mimewords() used to encode the characters "-!*+/". Now those characters are preserved, per RFC 2047 section 5. So we had to change how shared documents get encoded to match the new algorithm. periodt.

---

💅 OPTIONS 💅

• --list LISTNAME --robot DOMAIN — together with the next one, this specifies your target list(s) 🎯
• --all_lists — also specifies target list(s), but like… all of them. every single one. the whole group chat 🫶
• --fix_qencode — if you pass this, it fixes the Q-encoding that changed back on Sympa 6.1b.5 🔧 Otherwise, it applies the Q-encoding that Sympa 5.3a.8 introduced. So basically: new algo vs. old algo, pick your fighter ⚔️

---

🦋 HISTORY 🦋

upgrade_shared_repository.pl appeared as a separate executable on Sympa 6.2.17. glow-up moment fr fr ✨

---

okay that's the whole page bestie, you ate 💅 This lil manual comes from sympa version 6.2.70, dated 2026-07-13 — mwah, take care of your shared repositories and drink some water 🍓💜