From 59b9a51f2c11623dcbb8652e9e8b2995a79916ea Mon Sep 17 00:00:00 2001 From: Daniel-Constantin Mierla Date: Mon, 9 Dec 2024 21:12:39 +0100 Subject: [PATCH] cookbooks/devel/core: section for compatibility modes --- docs/cookbooks/devel/core.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/cookbooks/devel/core.md b/docs/cookbooks/devel/core.md index 626839ec..c61274d9 100644 --- a/docs/cookbooks/devel/core.md +++ b/docs/cookbooks/devel/core.md @@ -5502,6 +5502,21 @@ event_route[tm:branch-failure:myroute] { } ``` +## Compatibility Modes + +With the merge of source trees from `Kamailio` and `SER` in 2008, there were +some different behaviours in various module parameters and functions. To control +the behaviour, the compatibility mode can be specified with `#!KAMAILIO` or +`#!SER` at the beginning (first line) of the configuration file. + +The default mode is `#!KAMAILIO`. + +The parameters and functions that behave differently should have a note in their +documentation. + +Note: the first line having `#!KAMAILIO` is also used to set the file type by +extenssions in editors like `vim`, `vscode`, `atom`, `mcedit` or `emacs`. + ## Script Statements ### if