Building netbeans source question

[ha...@use.startmail.com]

Hi all,

I have a couple question and a suggestion for improvement.

First the suggestion for whomever maintains the page 
https://netbeans.apache.org/download/dev/index.html.

 I found  that it was necessary to do two more things for a clean 
build.
(Using:       Ubuntu 19.04          JDK 8 (v222)        Ant 
1.10.5        and Netbeans master downloaded from: 
https://github.com/apache/netbeans)

I had to type in a terminal: 
javac -source 1.7 -bootclasspath "$JAVA_HOME/jre/lib/rt.jar"
This was so I wouldn't have a lot of  warnings about Java 7. I took 
some searching and reading up to understand what this does and why it 
makes a big difference. 

I also had to download (from somewhere) and add the jar:  jfxrt.jar 
to:  <JDK_HOME>/jre/lib/ext
This is because Java 8 doesn't ship with jfxrt.jar (and doesn't really 
advertise that fact) but NB's build  acts as though it does.

If those two steps were added to the instructions , it would save 
people situated as I was someconsiderable  time and confusion.

After that was done I got a successful build which is a pretty 
impressive achievement on the NB team part .




My questions are:

1) When I open up the same source files I just built using ant, in this 
case I opened the Editor module and all its dependencies, I discover 
that it won't build, where" build" means Run->Build Project (Editor) or 
right clicking and selecting build. 

Is that normal and expected ?   I get hundreds of warnings starting 
with:
No HEAD found starting from /home/johndoe/nb/netbeans-master/ide/editor
then huundreds of deprecations, raw types and unchecked warnings  then 
this :

email: api-changes@netbeans.org
SignatureTest report
Base version: 1.92.0
Tested version: 1.93.0
Check mode: bin [throws removed]
Constant checking: on
Class org.netbeans.modules.editor.NbCodeFoldingAction$CodeFoldsMenu
  "E1.2 - API type removed" : method public java.awt.peer.ComponentPeer 
java.awt.Component.getPeer()
 anno 0 java.lang.Deprecated()
/home/johndoe/nb/netbeans-master/nbbuild/templates/projectized.xml:766: 
Signature tests return code is wrong (1), check the messages above
BUILD FAILED (total time: 9 seconds)

Indicating the build failed.

What I expected is that the build would succeed since the same classes 
just built under ant. But maybe this is wrong.




2) The second issue I have  is some modules, are red in the IDE project 
view indicating they're not even syntactically ok:

Module: Common Annotations
package : org.netbeans.api.annotations.commons
files : all of them CheckForNull.java NullAllowed.java etc.

error: (in the import section) "cannot find symbol
                                                  symbol: Documented
                                                  
package:java.lang.annotation"

The suggestion dialog to fix it  is :
Add Module Dependency
Filter: java.lang.annotation.Documented
Cluster: All clusters

but I don't say OK to this because I don't want to get the source into 
an unknown state and I am not sure it's the right thing to do or if it 
would even work.
                                         
The thing is, this module still builds, which surprises me since it 
can't find the clases it definess in its own import statements.
What this means to me is, if I were authoring a new file of the same 
general description in this package, I would worry that the import 
statement is telling me it can't find anything past "java.lang" (it 
can't even find annotation or anything in annotation of course). I 
would think I had a problem.

So there's a disconnect betweeen the buildability of the package (it 
still builds) and the errors I see in the IDE and in the editor, which 
ought to be fatal. I rely on those errors to be more or less  inerrant 
....because I know I'm not!!! LOL...

Can anyone explain what's going on? 

Thank you!!!!!!!

Re: Building netbeans source question

[Neil C Smith <ne...@apache.org>]

Hi,

On Fri, 30 Aug 2019, 23:40 , <ha...@use.startmail.com> wrote:

> If those two steps were added to the instructions , it would save people
> situated as I was someconsiderable  time and confusion.
>

The steps you've outlined seem wrong and shouldn't be required. The
instructions are correct, and work fine on at least Ubuntu 18.04 (I stick
with LTS).

Best wishes,

Neil

>