List Of data.table Options

[drag05]

I am trying to find an up-to-date list of data.table options along with their default and optional values and meaning.

I think such list should be available in User Manual rather than mentioned in discussions or, in function documentation.

This should be a requirement for any published R package, with the mention "no options available for this package" stated clarly when true. Package pander offers a good start.

Thank you!

[MichaelChirico]

Thanks! It's a reasonable request & good idea.

The "hard" part will be in ensuring such a doc page is kept up to date. We will want to write some static analysis code comparing the package code with the Rd file to ensure they are in sync.

[TysonStanley]

Re the keeping it updated: Seems like a good place for a release check, honestly. I do other checks like this in that process so we could add this to the list if there are no objections.

[MichaelChirico]

I hear you, but

• I think any place requiring manually combing through the codebase is prone to mistakes
• Once we come up with code to help automate the process, it might as well apply as part of CI -- the author best able to adjust the docs if need be is the one that made the change in the first place.

That said, it will be hard to capture "valid values & their meanings" automatically -- that part could still go for a quick check at release time to ensure it's still up-to-date. What's "easy" to do automatically is populate the universe of option names.

[TysonStanley]

Yes, agreed