13.04.2025 14:36, Duncan пишет: > alexey+gentoo posted on Sat, 12 Apr 2025 20:20:38 +0000 as excerpted: > >> ## Example: >> ## >> ## # Dev E. Loper <develo...@gentoo.org> (2019-07-01) >> -## # Masked for removal in 30 days. Doesn't work >> -## # with new libfoo. Upstream dead, gtk-1, smells >> -## # funny. (bug #987654) >> +## # Doesn't work with new libfoo. Upstream dead, gtk-1, smells >> +## # funny. >> +## # Removal on 2019-08-01. Bug #987654. >> ## app-misc/some-package > OCD triggered: > > Two very optional (it's an example after all) suggestions given you're > already changing it: > > 1) Example-timeliness niggle: s/gtk-1/qt5/ (or pick other appropriate...) > > qt5 isn't out-of-tree yet but the effort is toward that /eventually/, > so it's a far more current example than gtk-1. (/How/ long has that been > out-of-tree?) > > 2) Style niggle: Wrapping a two-word phrase to put just one on a line by > itself... [grumble, grumble]. Sentence line-breaks are even better > so maybe (example in-point, "maybe:" wrapped to its own line...): > >> +## # Doesn't work with new libfoo. >> +## # Upstream dead, qt5, smells funny. > (Or maybe with the shorter qt5 it'll all fit on one line?) > > Again, both entirely optional, but that /would/ satisfy my OCD. YMMV. > >
As this message isn't supposed to be used as is, but only as an example, gtk-1 is not bad as the example. But fine, made it gtk-2 instead. Updated at https://github.com/gentoo/gentoo/pull/41563
