cfdocs
cfdocs copied to clipboard
foundeo
getLocale functions
I have been unable to find anything on the functions getLocaleCountry and getLocaleLanguage added in #581. All of the engine links are for getLocaleDisplayName and the examples do not work on TryCF for any of the engines.
You can find information about it in the Lucee update docs. When I added them, they seemed to work as far as I remember.
@shaedrich Can you please verify which version of Lucee that you tried that supports these functions? None of the engines hosted on TryCF support these functions.
As stated in the update docs, they were added and removed in the same version only for internal proposes. So they do not work in any version. Don't ask me for reasons, ask them :D
I didn't see anything in the update docs stating they were added and removed in the same version. They were included in a list with no further information on them other than that they were deprecated (which is not the same as being removed). I thought you said you had gotten them to work. That doesn't really make much sense if they were added and removed in the same version, but even if that's the case my previous question regarding which version exactly still needs an answer.
Otherwise, is it even worth it to keep them documented? The current documentation seems useless as it is -- no useful external references, no way to test, inaccurate engines information.
Oh, sorry. You're right. They are deprecated. That's all I know. We both read the document. That's all we have. The version is written in the update docs and on cfdocs as well: Lucee 5. Why is that engine information inaccurate. Sorry but I don't see your point.
The question of keeping it documented may be addressed to @pfreitag. But for me it doesn't really matter matter if we keep it. I just tried to get rid of the open issue where the update docs were linked.
@shaedrich The engines is inaccurate because it says that all 4 of the engines support it and have no indication of when it was added or removed from any engine, when we now know that if it was ever added to any that it must have been removed since it does not work in any recent versions of those engines. It is also inaccurate because the docs links are for a different function that make no mention of the relevant function.
If the only documentation of its existence is one sentence in a Lucee update document, then that's pretty scarce. I don't know the context of the document since Lucee has many versions within 5, so it might only refer to 5.0 or it might be updated for point releases. The version prior to 5.0 is 4.5, which does not support those functions on TryCF either. Regardless, there would be no reason to assume just from that sentence that any other engine supports the functions. I would just ask that when adding a function to exercise due diligence by confirming these things.
It was added in one of the 5.* versions. But you're right: ACF and BD did and do not at any time, that's my fault. But many functions only have Lucee5 for engine version.