This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 229276

Summary: A proposal to change the text of default license
Product: projects Reporter: Martin Entlicher <mentlicher>
Component: Generic Projects UIAssignee: Martin Entlicher <mentlicher>
Status: RESOLVED FIXED    
Severity: normal CC: jlahoda
Priority: P2    
Version: 7.4   
Hardware: All   
OS: All   
Issue Type: ENHANCEMENT Exception Reporter:
Bug Depends on:    
Bug Blocks: 204221    

Description Martin Entlicher 2013-05-02 13:06:00 UTC
The default license at projectui/src/org/netbeans/modules/project/ui/resources/license-default.txt says:
"To change this template, choose Tools | Templates
and open the template in the editor."

After issue #226773 was implemented, it's preferred to set up project license. Therefore I'm proposing to change the text to:

"To change this license header, choose License Headers in Project Properties.
To change this template file, choose Tools | Templates
and open the template in the editor."

Any comments/suggestions?
Comment 1 Tomas Zezula 2013-05-02 14:41:34 UTC
Sounds OK to me.
Comment 2 Geertjan Wielenga 2013-05-06 20:21:47 UTC
I would prefer it if there were to be no text there at all. The web is full of files with that meaningless text. That text should not be found in the file, please remove it completely.
Comment 4 Martin Entlicher 2013-05-07 11:32:41 UTC
I've submitted this to make the text more accurate.
If it should be removed completely, someone from Java team should do it.
Comment 5 Jan Lahoda 2013-05-07 12:02:22 UTC
I don't think this has anything to do with the Java support. The Java templates (and other language templates) definitely should contain the reference to the license template. This reference is replaced by the actual project's license, and for e.g. NetBeans.org modules the nb.org license should be automatically generated.

This is more about the default license text (i.e. the text used when no license is selected). I wonder if the problem is in the fact that there is any text (btw, if there is no such text, how does a new user find out where to change the template and the license?), or in the fact the original text is confusing.
Comment 6 Martin Entlicher 2013-05-07 12:20:07 UTC
I'll change the text as proposed, to be more accurate.
Unfortunately, the documentation does not seem to be much descriptive about how to change the license.
If the text is to be removed, it will disappear from all kinds of files, therefore this should be discussed across all teams, as a separate issue.
Comment 7 Martin Entlicher 2013-05-07 13:34:52 UTC
Pushed as changeset:   252964:768588529170
http://hg.netbeans.org/core-main/rev/768588529170
Comment 8 Geertjan Wielenga 2013-05-07 13:43:43 UTC
"If there is no such text, how does a new user find out where to change
the template and the license?"


So what you're saying is that the source files of all my applications should include embedded inside them instructions for changing the template and the license? Really? Why don't you also include instructions for changing the font color? And what about the font size? Maybe you can also include instructions for where to go to change the font size? Or explain that the Alt key should be held down while scrolling up and down with the mouse. That's also something that could be included in the source file.

The point I'm making is that source files should simply not be the place where we document how to use NetBeans IDE.
Comment 10 Quality Engineering 2013-05-09 02:36:20 UTC
Integrated into 'main-golden', will be available in build *201305082300* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)
Changeset: http://hg.netbeans.org/main-golden/rev/768588529170
User: mentlicher@netbeans.org
Log: #229276: The text of default license is changed to be more accurate.