vscode-java icon indicating copy to clipboard operation
vscode-java copied to clipboard

unclear name/description for download sources

Open maxandersen opened this issue 3 years ago • 3 comments

the name and description for "download sources" is a bit confusing.

2022-08-10_10-02-56

  1. does turning this setting on enable or disable download of sources?
  2. what does "Eclipse:" refer to ? no other setting has this.

I would assume something like the following is more clear (based on how it seem to behave on my machine at least):

"Java > Download Sources Always Download of Maven sources will always happen not just on demand which is the default."

maxandersen avatar Aug 10 '22 08:08 maxandersen

checked == enabled

This setting is used for Eclipse projects specifically, as in no Maven nor Gradle, pure .project, .classpath eclipse projects. It basically brings the same download capabilities to Eclipse projects that Maven or Gradle have. Not turned on by default because it uses hard coded paths for source files in .classpath

fbricon avatar Aug 10 '22 08:08 fbricon

Looking under the VS Code settings I see :

"Enable ..." "Enable/disable ..." "Enable(s) or disable(s) ..." "Control(s) ..."

In some cases, skipping the above phrases and just saying what happens could also be very clear. I think its a matter of getting some upstream guidance on what terminology is preferred.

rgrunber avatar Aug 17 '22 19:08 rgrunber

Imo Just remove the prefix. They are either redundant (Enables) or ambigious (Enables/disables)

maxandersen avatar Aug 21 '22 06:08 maxandersen