OK,
the topic documentation may be worth a separate thread.
I can only give a little insight in that the german help was even less accurate than the english one. One reason for helps inaccuracy is the help writers are not the developers of the language and product itself, they are not techies. I'm sure they worked together with the VFP development team, but documentation is not tested and checked as thoroughly as the code itself.
Specifically about NVL, the help isn't wrong a single bit, it's just not complete, to tell you both parameters always are evaluated. In detail the NVL topic just makes the error to first tell you NVL returns a non-null value from two expressions, but it corrects itself in also telling, the return value of NVL can be null, if both expressions are null. And this was even not of any importance here and wasn't argued about at all. So the help is just not telling both expressions are evaluated, but that's not wrong, it's just a notice or warning missing. And as already said this isn't special at all. What is special is the optimisation of IIF and the optimisation of evaluation of logical terms overall. There is also a lot of rushmore that is not told, halfways secrets and halfways not told to be able to put the budget of the documentation to be more complete and balanced and an overall acceptable documentation. There is room for books about VFP and there are books, aren't there?
The help topic about IIF is more accurate and more of a shining example than the description of NVL, but where do you want to stop finishing a product and what should it cost?
In the end the help is written for developers, experts on programming, not for people trying to recode the language 100% compatible. Knowing known bugs and workarounds and knowing detail behaviour both from experience and own experiments is what is distinguishing the expert from the normal developer, technical user or end user. And there is giving back, it's not that experts keep their knowledge for themselves. You find many explanations, if you search for them.
If you want perfection, then go somewhere else, where perfection isn't really arguable, eg into nature, arts. Don't go for Foxpro, programming languages or computers in general.
Bye, Olaf.