On Sun, Feb 19, 2017 at 03:17:26AM +0100, Matthias Andree wrote: > Can I propose a few changes to make this file more understandable?
Definitely. I may be a "native speaker", but I'll readily admit my writing skills are terrible. > The last one I've quoted above looks complicated to me with its passive > voice and its weasling around the subject. > How about "Mutt will look for the user's muttrc additionally in > $XDG_CONFIG_HOME/mutt/."? Okay. > > + ! OpenSSL certificate verification has been reworked to suppport > > alternative > > + chains. > I do not mean to offend anyone, but I've always been scratching my head > over this description. The "reworked" is a less important part because > we're not using magic; but even if the line read "OpenSSL certificate > verification now supports alternative certificate chains." I'd probably > scratch my head over it unless I were acquainted with how X.509 > certificate signing chains work. How about something like: "Mutt will now use the built-in OpenSSL SSL_set_verify() callback to verify certificates. This allows better support for verifying chains, including alternative chain support." > > + + <subjectrx> allows replacing matching subjects with something else. > > + This can be used to declutter subject lines in the index. > Is this to cure "Re: AW: Re: AW: Rép: AW: Re: WG: Re: Fw: Re^2: RE:" and > boil it down to "Re: Fw:"? Or would that be too hard to do? Or does it > serve a different purpose? The UPDATING note appears rather abstract to me. Well, I thought the second sentence would peak interest, leading them to look at the manual. https://dev.mutt.org/doc/manual.html#display-munging provides the details. > > + + <edit-label> can be used to add, change, or delete a message's X-Label. > > + ! Pattern expressions with ~y support label tab completion. > > + + LMDB backend support for the header cache. > > + + Kyoto Cabinet backend support for the header cache. > The final two seem rather very technically worded and also introduce the > new before picking up the reader with what he is likely familiar with > already. How about this instead: > > "The header cache now also supports Kyoto Cabinet and LMDB as backend > databases." Okay. -- Kevin J. McCarthy GPG Fingerprint: 8975 A9B3 3AA3 7910 385C 5308 ADEF 7684 8031 6BDA
signature.asc
Description: PGP signature
