From 2a45e02a17cd16a95355bb26f21e10290ba2b92f Mon Sep 17 00:00:00 2001 From: Zac Spitzer Date: Mon, 12 Aug 2024 09:51:28 +0200 Subject: [PATCH] add compat category (#1451) * add compat category * cleanup * Update category.md * cross ref --- .../01.functions/arraycontains/_usageNotes.md | 1 + .../01.functions/arraycontains/function.md | 5 +++-- .../01.functions/gettimezone/function.md | 1 + .../120.deprecated/implementationStatus.md | 3 +++ .../02.migrate-from-railo/page.md | 3 +++ .../04.migrate-from-acf/page.md | 2 ++ .../01.language-syntax-differences/page.md | 1 + .../05.scope/page.md | 1 + docs/05.categories/048.compat/category.md | 17 +++++++++++++++++ 9 files changed, 32 insertions(+), 2 deletions(-) create mode 100644 docs/05.categories/048.compat/category.md diff --git a/docs/03.reference/01.functions/arraycontains/_usageNotes.md b/docs/03.reference/01.functions/arraycontains/_usageNotes.md index e69de29bb..44a3c3bc8 100644 --- a/docs/03.reference/01.functions/arraycontains/_usageNotes.md +++ b/docs/03.reference/01.functions/arraycontains/_usageNotes.md @@ -0,0 +1 @@ +Lucee returns the index of the match, while ACF returns a Boolean, both of which are truthy \ No newline at end of file diff --git a/docs/03.reference/01.functions/arraycontains/function.md b/docs/03.reference/01.functions/arraycontains/function.md index bbdec9dcc..cf185b566 100644 --- a/docs/03.reference/01.functions/arraycontains/function.md +++ b/docs/03.reference/01.functions/arraycontains/function.md @@ -2,9 +2,10 @@ title: ArrayContains id: function-arraycontains related: - - function-arraycontainsnocase +- function-arraycontainsnocase categories: - - array +- array +- compat --- Returns the position of the first element in the array that matches the item that we are searching for, or 0 if the item is not found. diff --git a/docs/03.reference/01.functions/gettimezone/function.md b/docs/03.reference/01.functions/gettimezone/function.md index 79d5781fa..5c818ec3d 100644 --- a/docs/03.reference/01.functions/gettimezone/function.md +++ b/docs/03.reference/01.functions/gettimezone/function.md @@ -4,6 +4,7 @@ id: function-gettimezone related: - function-settimezone categories: +- compat - datetime --- diff --git a/docs/03.reference/120.deprecated/implementationStatus.md b/docs/03.reference/120.deprecated/implementationStatus.md index 4c4010122..e4648af79 100644 --- a/docs/03.reference/120.deprecated/implementationStatus.md +++ b/docs/03.reference/120.deprecated/implementationStatus.md @@ -1,7 +1,10 @@ --- title: Deprecated Tags & Functions id: deprecated +categories: +- compat statusFilter: deprecated +description: Backwards compatibility is considered super important in Lucee. --- Backwards compatibility is considered super important in Lucee. diff --git a/docs/04.guides/03.updating-lucee/02.migrate-from-railo/page.md b/docs/04.guides/03.updating-lucee/02.migrate-from-railo/page.md index dbabd8934..4fe0dcaf4 100644 --- a/docs/04.guides/03.updating-lucee/02.migrate-from-railo/page.md +++ b/docs/04.guides/03.updating-lucee/02.migrate-from-railo/page.md @@ -1,7 +1,10 @@ --- title: Migrating from Railo to Lucee id: updating-lucee-migrate-from-railo +categories: +- compat menuTitle: Migrating from Railo +description: Lucee 4.5 is forked from the Railo CFML Server (version 4.2) so you can easily migrate an existing Railo installation as follows. --- # Migrate from Railo© # diff --git a/docs/04.guides/03.updating-lucee/04.migrate-from-acf/page.md b/docs/04.guides/03.updating-lucee/04.migrate-from-acf/page.md index dba7a745f..a07cfe5a5 100644 --- a/docs/04.guides/03.updating-lucee/04.migrate-from-acf/page.md +++ b/docs/04.guides/03.updating-lucee/04.migrate-from-acf/page.md @@ -3,6 +3,8 @@ title: Migrating to Lucee from ColdFusion id: updating-lucee-migrate-from-acf related: - language-syntax-differences +categories: +- compat description: How to migrate/port your code from Adobe ColdFusion to Lucee menuTitle: Migrating from ColdFusion --- diff --git a/docs/04.guides/11.developing-with-lucee-server/01.language-syntax-differences/page.md b/docs/04.guides/11.developing-with-lucee-server/01.language-syntax-differences/page.md index c16b4f481..f00b147ac 100644 --- a/docs/04.guides/11.developing-with-lucee-server/01.language-syntax-differences/page.md +++ b/docs/04.guides/11.developing-with-lucee-server/01.language-syntax-differences/page.md @@ -4,6 +4,7 @@ id: language-syntax-differences related: - lucee-5-unquoted-arguments categories: +- compat - core menuTitle: Language and Syntax --- diff --git a/docs/04.guides/11.developing-with-lucee-server/05.scope/page.md b/docs/04.guides/11.developing-with-lucee-server/05.scope/page.md index 619de71a0..bc4a633da 100644 --- a/docs/04.guides/11.developing-with-lucee-server/05.scope/page.md +++ b/docs/04.guides/11.developing-with-lucee-server/05.scope/page.md @@ -2,6 +2,7 @@ title: Scopes id: scopes categories: +- compat - core - scopes description: local, arguments, query, variables, this, cgi, cffile, url, form, cookie, client, thread, caller, request diff --git a/docs/05.categories/048.compat/category.md b/docs/05.categories/048.compat/category.md new file mode 100644 index 000000000..fab55cdb2 --- /dev/null +++ b/docs/05.categories/048.compat/category.md @@ -0,0 +1,17 @@ +--- +title: Compatibility / Migration with other CFML engines +id: category-compat +categories: +- category-core +- core +description: Whilst Lucee is broadly compatible with Adobe ColdFusion, there are some differences. +menuTitle: Compatibility / Migration +--- + +Whilst Lucee is broadly compatible with Adobe ColdFusion, there are some differences. + +Some are for performance reasons, others due to Adobe mis-adopting or adding features whch conflict with Lucee additions to the language. Sometimes it's a trade off between being compatible and respecting our existing users. + +Our issue tracker has an [acf-compat](https://luceeserver.atlassian.net/issues/?jql=labels%20%3D%20%22acf-compat%22) label which tracks all the known differences. + +In addition, with Lucee 6, we decided to change some incompatible implementations and also change some older insecure defaults to be more secure, please refer to the following epic [All Breaking changes in Lucee 6](https://luceeserver.atlassian.net/browse/LDEV-4534)