[JasmineFeng]

Does anybody think the OpenFOAM documentation (esp. the CFD Direct version) is somewhat inadequate?

I'm now using OpenFOAM-V9 of CFD Direct. Take the command mapFields for example. It has an option `mapMethod` to specify the mapping method. But I cannot find any description from the User Guide or the command `mapFields -help`.

Under protest, I came to the C++ source code of OpenFOAM, and found the valid choices are `mapNearest`, `interpolate`, `cellPointInterpolate`.



Notwithstanding, I still know nothing about the difference between `interpolate` and `cellPointInterpolate`. I cannot find any description of these choices.

The OpenCFD version seems better from this angle, since it provides valid choices at least, though without any detailed descriptions.


Personally I think, a mature software must provide detailed API documentation, to make the users find the valid choices of some arguments conveniently. How do you think about it? Or simply, where can I find the choices of `mapFields` and its description conveniently