retire custom manpage generator
"ellie timoney via SASL" <[email protected]> Wed, 30 Aug 2023 10:11:50 +1000
| Newsgroups | gmane.comp.security.cyrus.sasl |
|---|---|
| Message-ID | <[email protected]> |
--c7de816f53fb499ba3dcab0209f59334
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
Hi,
Cyrus-IMAP and Cyrus-SASL have been using a custom manpage generator, rathe=
r than the one built into Sphinx. But that custom generator is unmaintaine=
d, and keeps breaking when new Sphinx versions are released.
Cyrus-IMAP have retired the custom generator as of a few weeks ago, and we =
now just use the manpage generator that comes with Sphinx. It seems to do =
the same job -- I don't know why we had a custom one in the first place.
I've opened a PR to make the equivalent changes to Cyrus-SASL: https://git=
hub.com/cyrusimap/cyrus-sasl/pull/796. It works for me, but ought to be te=
sted by someone who publishes Cyrus-SASL releases, as that's who it ultimat=
ely needs to work for.
I've requested a review from Quanah, but I'm not sure who else to request o=
ne from. I'm not sure if this project makes much use of the PR review proc=
ess, and maybe the review request has simply gone unnoticed, so I thought I=
'd mention it on the list too just in case.
Cheers,
ellie
------------------------------------------
Cyrus: SASL
Permalink: https://cyrus.topicbox.com/groups/sasl/T0bf8029afd8f81a8-M9a0bdb=
7bf6e68abacde65236
Delivery options: https://cyrus.topicbox.com/groups/sasl/subscription
--c7de816f53fb499ba3dcab0209f59334
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
<!DOCTYPE html>
<html><html><html><head><title></title><style type=3D"text/css">p.MsoNormal=
,p.MsoNoSpacing{margin:0}</style></head><body><div>Hi,<br /></div><div><br =
/></div><div>Cyrus-IMAP and Cyrus-SASL have been using a custom manpage gen=
erator, rather than the one built into Sphinx. But that custom genera=
tor is unmaintained, and keeps breaking when new Sphinx versions are releas=
ed.<br /></div><div><br /></div><div>Cyrus-IMAP have retired the custom gen=
erator as of a few weeks ago, and we now just use the manpage generator tha=
t comes with Sphinx. It seems to do the same job -- I don't know =
why we had a custom one in the first place.<br /></div><div><br /></div><di=
v>I've opened a PR to make the equivalent changes to Cyrus-SASL: &=
nbsp;<a href=3D"https://github.com/cyrusimap/cyrus-sasl/pull/796">https://g=
ithub.com/cyrusimap/cyrus-sasl/pull/796</a>. It works for me, but oug=
ht to be tested by someone who publishes Cyrus-SASL releases, as that's=
who it ultimately needs to work for.<br /></div><div><br /></div><div>I=
9;ve requested a review from Quanah, but I'm not sure who else to reque=
st one from. I'm not sure if this project makes much use of the P=
R review process, and maybe the review request has simply gone unnoticed, s=
o I thought I'd mention it on the list too just in case.<br /></div><di=
v><br /></div><div>Cheers,<br /></div><div><br /></div><div>ellie<br /></di=
v><div><br /></div><div id=3D"topicbox-footer" style=3D"margin:10px 0 0;bor=
der-top:1px solid #ddd;border-color:rgba(0,0,0,.15);padding:7px 0;">
<strong><a href=3D"https://cyrus.topicbox.com/latest" style=3D"color:inheri=
t;text-decoration:none">Cyrus</a></strong>
/ SASL / see
<a href=3D"https://cyrus.topicbox.com/groups/sasl">discussions</a>
+
<a href=3D"https://cyrus.topicbox.com/groups/sasl/members">participants</a>
+
<a href=3D"https://cyrus.topicbox.com/groups/sasl/subscription">delivery&nb=
sp;options</a>
<a href=3D"https://cyrus.topicbox.com/groups/sasl/T0bf8029afd8f81a8-M9a0bdb=
7bf6e68abacde65236" style=3D"float:right">Permalink</a>
</div>
</body></html></html></html>=
--c7de816f53fb499ba3dcab0209f59334--