Tamar Christina <[email protected]> writes: > Also please add "Undocumented" tag to the param. End users should not use > this and I > want to reserve the right to change it at any given time. And I'm not married > to the name.
Just to comment on this part: the --params documentation is now part of the internals manual rather than the user manual (thanks to Sandra for moving it). It's always been the case that --params are for experimentation and can be changed without notice. The move should make it more explicit. So I think we should document all --params if we can. There isn't really a distinction in principle between "user-facing --params that people can rely on" and "internal --params that can change at any time". All --params should belong to the second category. Things that users can rely on should be non-param options instead. Thanks, Richard
