svn commit: r385557 - in head: . net net/asterisk13 net/pjsip net/pjsip-extsrtp

[Guido Falsi]

On 05/07/15 00:25, Adam Weinberger wrote:
>> On 6 May, 2015, at 14:10, Guido Falsi <madpilot at FreeBSD.org> wrote:
>>
>> +20150506:
>> +  AFFECTS: users of net/asterisk13 with PJSIP (default on) and SRTP (default off) options enabled
>> +  AUTHOR: madpilot at FreeBSD.org
>> +
>> +  Due to asterisk13 requiring conflicting port options for the net/pjsip
>> +  dependency when the SRTP option is enabled together with the PJSIP
>> +  one I have created a new slave port to pjsip to enforce the
>> +  required option so asterisk can enforce that option with a
>> +  conditional dependency.
>> +
>> +  Users building custom packages with poudriere should have no
>> +  problems, since pkgng is able to handle the change automatically.
>> +
>> +  For users compiling from ports a simple update of asterisk will
>> +  keep it working because the already installed pjsip port will
>> +  satisfy the dependency. They anyway should, when convenient,
>> +  disinstall the pjsip port(this will also disinstall asterisk13)
>> +  and rebuild asterisk13 to force it to grab the correct dependency
>> +  to avoid problems with future updates.
>> +
>> +  Please check the 20150323 entry in this file which has some
>> +  background about this problem.
> 
> That is really, really wordy. The actual instruction that users are to follow is buried in the second sentence of the third paragraph, and follows the phrase "when convenient". Then, the instruction is split into two clauses separated by a parenthetical note.
> 
> The other info is great to have, but you should consider assuming that people will not read more than the first 4 words of each paragraph.
> 

Thanks a lot. I modified the entry with your suggestion, it's much
better than mine!

-- 
Guido Falsi <madpilot at FreeBSD.org>