Add AMI Event Filtering documentation

[phoneben]

Add comprehensive guide for Advanced Event Filtering Include syntax, examples, and best practices
Document legacy filtering method with deprecation note Resolves #160

[phoneben]

jcolp disclaimer ai and hi was used

[phoneben]

https://docs.asterisk.org/Configuration/Interfaces/Asterisk-Manager-Interface-AMI/AMI-v2-Specification/?h=#general-settings
should this also be fixed ?

| eventfilter | Structured Expression or RegEx (deprecated) | This option may be present multiple times. This option allows clients to whitelist or blacklist events. See [ami-event-filtering](#ami-event-filtering) for details. | |

[jcolp]

It can be updated, yes, though would need explicit statement about which versions the new stuff was added to.

[phoneben]

can you point to me how i can check to which version this was applied ?
asterisk/asterisk#874

[jcolp]

What I would do is look at the date it was merged. I would then find the releases that occurred after such date and check the release notes to see if it was mentioned.

[phoneben]

https://downloads.asterisk.org/pub/telephony/asterisk/old-releases/

Asterisk 18: 18.25.0 (released October 17, 2024)
Asterisk 20: 20.10.0 (released October 17, 2024)
Asterisk 21: 21.5.0 (released October 17, 2024)
Asterisk 22: 22.0.0 (released October 17, 2024)

[jcolp]

Nope. It's not in those. It's in the releases after, as shown in the corresponding changelogs.

[phoneben]

| eventfilter | Structured Expression or RegEx (deprecated) | This option may be present multiple times. This option allows clients to whitelist or blacklist events. See [ami-event-filtering](#ami-event-filtering) for details. **Added in:** Structured Expression syntax added in 18.26.0, 20.11.0, 21.6.0, 22.1.0 (Nov 2024) | |

any good ?