[Ltrace-devel] Addition to the manpage
Dima Kogan
lists at dima.secretsauce.net
Wed Jun 4 19:50:16 UTC 2014
Petr Machata <pmachata at redhat.com> writes:
> Dima Kogan <lists at dima.secretsauce.net> writes:
>
>> Do you think this is better? I can go either way.
>
> Well, this only adds the "exited" messages, and I find it better that
> you don't hide anything from the user. The added "exited" is no
> distraction at all, I think.
>
>>> I would also put the whole example in a section of its own, presumably
>>> named "EXAMPLE", or maybe "SYMBOL FILTERING EXAMPLE". That should only
>>> come after the "FILTERING EXPRESSIONS", as conceptually it builds on
>>> what's written there. It would however be good to refer to this new
>>> section from -e, -x and -l.
>>
>> Sure? I think the way it is now is better. Both putting the examples
>> first (all perl docs do that, and they tend to be very good) and putting
>> them into the same section (but different subsections). If you don't
>> have strong feelings here, I'd rather leave it.
>
> In my opinion, explanations of differences between -x, -e and -l don't
> belong in a section that describes filtering expressions, which is a
> logically lower-level topic. I don't have particularly strong feelings
> about ordering though, so if you think it's better to put examples
> first, then so be it.
OK. New patch pushed up.
More information about the Ltrace-devel
mailing list