rootDir option documentation incorrect and confusing

[DeadMG]

I've recently started a new project with TS and run into some confusing behaviour. I've placed my files in an "app" folder, but the emitted TS (using AMD modules with --outFile) generates module names without the app prefix, breaking my JS references.

Turns out that I was supposed to use rootDir, instead of rootDirs.

The first issue is that since #5819, this actually does affect outFile as well, so the documentation clearly stating it only applies to outDir is wrong.
The second issue is that it's really confusing the difference between rootDirs and rootDir, and it's still unclear to me why rootDirs: ["./"] did not produce the same result as rootDir: "./". The written documentation is not very clear out this and potentially, one or both options neeed renaming.

This is referencing the current live version on https://www.typescriptlang.org/docs/handbook/compiler-options.html

[mhegazy]

rootDir and rootDirs have completely different meanings... I apologize for the bad choice of names. but that said. i am not sure what part of the docs you would like to be updated? can you elaborate? also PRs would be welcomed.

[shadow-light]

rootDir and rootDirs have completely different meanings

Thanks for pointing this out! Just lost a lot of time because I thought -rootDirs was an alternative to specifying multiple --rootDir options.

Renaming would be helpful!