Re: NetBeans Design
Indeed. I've found it handy to create a shell alias for searching java sources - dirt simple, but handy in your .bashrc: alias jfind='find . -name "*.java" | xargs grep -i ' will find any java source containing whatever string you pass to it. -Tim
RE: NetBeans Design
> How does anyone know where anything is? It's actually quite easy--just find a user-visible text string somewhere in the viscinity of what you're looking for, and grep for it in the git repository. For example, some days ago I wanted to know which class implements the dropdown button component that can be seen in some of the NetBeans toolbar. I hovered over the one in the Java editor, and got a tooltip that said "Go back to StringUtil.java". This meant that somewhere in the NetBeans codebase, there is a string called "Go back to", which should bring me in the right direction. Then, from the checked-out netbeans sources, I do: git grep 'Go back to' This shows me a few results, with one being relevant: ide/editor/src/org/netbeans/modules/editor/impl/actions/Bundle.properties:NavigationHistoryBackAction_Tooltip=Go back to {0} Then I do: git grep 'NavigationHistoryBackAction_Tooltip' This takes me to ide/editor/src/org/netbeans/modules/editor/impl/actions/NavigationHistoryBackAction.java . In that file I find a method call DropDownButtonFactory.createDropDownButton, which is in the class org.openide.awt.DropDownButtonFactory. And that's the class I was looking for. In the end, you usually just end up having to open up one or two NetBeans modules in the IDE to work on a particular bug, or inspect a particular feature. -- Eirik -Original Message- From: Jeremy Cavanagh Sent: Thursday, November 7, 2019 3:47 AM To: dev@netbeans.apache.org Subject: Re: NetBeans Design Hi Tim, That is most impressive, and yet terrifying at the same time. It raises even more questions for me. How does anyone know where anything is? Probably not for discussion here but, what use is software engineering, design methodologies etc., is software development just an enormous hackathon? Food for thought. Many thanks to everyone who replied to my original post. Jeremy On 07/11/2019 03:29, Tim Boudreau wrote: > A few people asked for a visual representation. I pulled this together > a few years ago. Mostly it just illustrates why those kinds of > representations are useless at scale. > > Package dependencies: > > https://timboudreau.com/files/nb-packagegraph/ > > Classes (IIRC trimmed down a LOT): > > https://timboudreau.com/files/netbeans-classes/ > > On Wed, Nov 6, 2019 at 7:57 PM Eric Bresie wrote: > >> Is this a reason to push for the UML plugin ;-) > > > There are no reasons to push for uml, ever :-) > > -Tim > > > >> >> Eric Bresie >> ebre...@gmail.com >>> On November 6, 2019 at 9:02:49 AM CST, Eric Barboni >>> >> wrote: >>> Hi, >>> Not sure that is what you want. >>> >>> ((A small help can be >>> If you get the sources, do a first build: >>> ant >>> you can then do >>> ant index-layer-paths >>> >>> this will create in nbbuild/build/generated layers.txt and >>> services.txt where given a " UI element" " mimetype" "project type" >>> you can find >> which module provide it (this is a bit too textual). >>> )) >>> >>> Maybe you want a more complex visualization, with rectangle and edge >>> but >> I guess should be some layout and "dynamic page" to filter ( or 8K >> monitors :p). Modules are legion. >>> >>> Best Regards >>> Eric >>> -Message d'origine- >>> De : Christian Lenz Envoyé : mercredi 6 >>> novembre 2019 15:43 À : dev@netbeans.apache.org Objet : AW: NetBeans >>> Design >>> >>> ➢ And this IMHO continues to be the best book on the NetBeans Platform: >>> >>> ➢ https://leanpub.com/nbp4beginners >>> >>> ➢ Gj >>> >>> Hey Geertjan, >>> >>> how does that fit in the reworked/categorized structure. Is the book >> still up to date? Just asking. >>> >>> >>> Cheers >>> >>> Chris >>> >>> >>> Von: Geertjan Wielenga >>> Gesendet: Mittwoch, 6. November 2019 15:34 >>> An: dev >>> Betreff: Re: NetBeans Design >>> >>> On Wed, Nov 6, 2019 at 3:09 PM Christoph Theis wrote: >>> >>>> I have the same problem: >>>> E.g., NB doesn't accept a current javahl. So, where would I find >>>> the module where the check happened (I grep'ed for the error >>>> message and found it). Are there dependencies? If I want to improve >>>> the error message (right now it is hidden in the log files), how to do it? >>>> >>>> So, summarizing, an eagles view of what NB is composed of, would be >&
Re: NetBeans Design
That is most impressive, and yet terrifying at the same time. It raises > even more questions for me. How does anyone know where anything is? You learn. Learn the basics of how things In NetBeans are put together - Lookup, the system filesystem, MimeLookup, what DataObjects are - and you can look at unfamiliar parts of the system do and think “I bet there’s a things that provides X and it’s probably found here.” And look and see if it is. Learn the difference between API and SPI and expect them to be separate things. After that, you just pick the functionality you want to implement, look up what APIs might be helpful for that (google, the Javadoc, and grepping the sources are your friends), and start coding. In this way, you incrementally learn your way around - it’s not necessary to know everything to be productive. Probably not for discussion here but, what use is software engineering, > design methodologies etc., is software development just an enormous > hackathon? Most “methodologies” are frauds designed to inflate consultants’ billable hours, or guarantee a product broken enough that they have a long term revenue strram. Usually both. Don’t mistake size for lack of discipline. There are modules I wrote fifteen or more years ago and use daily, unmodified. Welcome to the wonderful world of non-trivial software :-) -Tim > > Food for thought. > > Many thanks to everyone who replied to my original post. > > Jeremy > > > On 07/11/2019 03:29, Tim Boudreau wrote: > > A few people asked for a visual representation. I pulled this together a > > few years ago. Mostly it just illustrates why those kinds of > > representations are useless at scale. > > > > Package dependencies: > > > > https://timboudreau.com/files/nb-packagegraph/ > > > > Classes (IIRC trimmed down a LOT): > > > > https://timboudreau.com/files/netbeans-classes/ > > > > On Wed, Nov 6, 2019 at 7:57 PM Eric Bresie wrote: > > > >> Is this a reason to push for the UML plugin ;-) > > > > > > There are no reasons to push for uml, ever :-) > > > > -Tim > > > > > > > >> > >> Eric Bresie > >> ebre...@gmail.com > >>> On November 6, 2019 at 9:02:49 AM CST, Eric Barboni > >> wrote: > >>> Hi, > >>> Not sure that is what you want. > >>> > >>> ((A small help can be > >>> If you get the sources, do a first build: > >>> ant > >>> you can then do > >>> ant index-layer-paths > >>> > >>> this will create in nbbuild/build/generated layers.txt and services.txt > >>> where given a " UI element" " mimetype" "project type" you can find > >> which module provide it (this is a bit too textual). > >>> )) > >>> > >>> Maybe you want a more complex visualization, with rectangle and edge > but > >> I guess should be some layout and "dynamic page" to filter ( or 8K > monitors > >> :p). Modules are legion. > >>> > >>> Best Regards > >>> Eric > >>> -Message d'origine- > >>> De : Christian Lenz > >>> Envoyé : mercredi 6 novembre 2019 15:43 > >>> À : dev@netbeans.apache.org > >>> Objet : AW: NetBeans Design > >>> > >>> ➢ And this IMHO continues to be the best book on the NetBeans Platform: > >>> > >>> ➢ https://leanpub.com/nbp4beginners > >>> > >>> ➢ Gj > >>> > >>> Hey Geertjan, > >>> > >>> how does that fit in the reworked/categorized structure. Is the book > >> still up to date? Just asking. > >>> > >>> > >>> Cheers > >>> > >>> Chris > >>> > >>> > >>> Von: Geertjan Wielenga > >>> Gesendet: Mittwoch, 6. November 2019 15:34 > >>> An: dev > >>> Betreff: Re: NetBeans Design > >>> > >>> On Wed, Nov 6, 2019 at 3:09 PM Christoph Theis wrote: > >>> > >>>> I have the same problem: > >>>> E.g., NB doesn't accept a current javahl. So, where would I find the > >>>> module where the check happened (I grep'ed for the error message and > >>>> found it). Are there dependencies? If I want to improve the error > >>>> message (right now it is hidden in the log files), how to do it? > >>>> > >>>> So, summarizing, an eagles view of what NB is composed of, would be a > >>>> start. Sthg., that would help newcom
Re: NetBeans Design
On Thu, Nov 7, 2019 at 9:47 AM Jeremy Cavanagh wrote: > Hi Tim, > > That is most impressive, and yet terrifying at the same time. It raises > even more questions for me. How does anyone know where anything is? > > You've had several responses to that question already in this thread. The NetBeans source code is structured in functional areas -- called clusters, each cluster containing modules that together provide the features defining the cluster. E.g., the 'java' cluster provides all the modules defining the Java features, the 'php' cluster provides all the modules defining the PHP features. Take a look at the GitHub repo -- the clusters are the top level folders: https://github.com/apache/netbeans Gj > Probably not for discussion here but, what use is software engineering, > design methodologies etc., is software development just an enormous > hackathon? > > Food for thought. > > Many thanks to everyone who replied to my original post. > > Jeremy > > > On 07/11/2019 03:29, Tim Boudreau wrote: > > A few people asked for a visual representation. I pulled this together a > > few years ago. Mostly it just illustrates why those kinds of > > representations are useless at scale. > > > > Package dependencies: > > > > https://timboudreau.com/files/nb-packagegraph/ > > > > Classes (IIRC trimmed down a LOT): > > > > https://timboudreau.com/files/netbeans-classes/ > > > > On Wed, Nov 6, 2019 at 7:57 PM Eric Bresie wrote: > > > >> Is this a reason to push for the UML plugin ;-) > > > > > > There are no reasons to push for uml, ever :-) > > > > -Tim > > > > > > > >> > >> Eric Bresie > >> ebre...@gmail.com > >>> On November 6, 2019 at 9:02:49 AM CST, Eric Barboni > >> wrote: > >>> Hi, > >>> Not sure that is what you want. > >>> > >>> ((A small help can be > >>> If you get the sources, do a first build: > >>> ant > >>> you can then do > >>> ant index-layer-paths > >>> > >>> this will create in nbbuild/build/generated layers.txt and services.txt > >>> where given a " UI element" " mimetype" "project type" you can find > >> which module provide it (this is a bit too textual). > >>> )) > >>> > >>> Maybe you want a more complex visualization, with rectangle and edge > but > >> I guess should be some layout and "dynamic page" to filter ( or 8K > monitors > >> :p). Modules are legion. > >>> > >>> Best Regards > >>> Eric > >>> -Message d'origine- > >>> De : Christian Lenz > >>> Envoyé : mercredi 6 novembre 2019 15:43 > >>> À : dev@netbeans.apache.org > >>> Objet : AW: NetBeans Design > >>> > >>> ➢ And this IMHO continues to be the best book on the NetBeans Platform: > >>> > >>> ➢ https://leanpub.com/nbp4beginners > >>> > >>> ➢ Gj > >>> > >>> Hey Geertjan, > >>> > >>> how does that fit in the reworked/categorized structure. Is the book > >> still up to date? Just asking. > >>> > >>> > >>> Cheers > >>> > >>> Chris > >>> > >>> > >>> Von: Geertjan Wielenga > >>> Gesendet: Mittwoch, 6. November 2019 15:34 > >>> An: dev > >>> Betreff: Re: NetBeans Design > >>> > >>> On Wed, Nov 6, 2019 at 3:09 PM Christoph Theis wrote: > >>> > >>>> I have the same problem: > >>>> E.g., NB doesn't accept a current javahl. So, where would I find the > >>>> module where the check happened (I grep'ed for the error message and > >>>> found it). Are there dependencies? If I want to improve the error > >>>> message (right now it is hidden in the log files), how to do it? > >>>> > >>>> So, summarizing, an eagles view of what NB is composed of, would be a > >>>> start. Sthg., that would help newcomers to understand the code of NB. > >>>> > >>> > >>> > >>> In many ways, the current GitHub structure provides the eagle's view > you > >>> seek: > >>> > >>> https://github.com/apache/netbeans > >>> > >>> Rather than it being a long list of modules, the above categorizes them > >> into their clusters, reflecting what you see in your NetB
Re: NetBeans Design
Hi Tim, That is most impressive, and yet terrifying at the same time. It raises even more questions for me. How does anyone know where anything is? Probably not for discussion here but, what use is software engineering, design methodologies etc., is software development just an enormous hackathon? Food for thought. Many thanks to everyone who replied to my original post. Jeremy On 07/11/2019 03:29, Tim Boudreau wrote: A few people asked for a visual representation. I pulled this together a few years ago. Mostly it just illustrates why those kinds of representations are useless at scale. Package dependencies: https://timboudreau.com/files/nb-packagegraph/ Classes (IIRC trimmed down a LOT): https://timboudreau.com/files/netbeans-classes/ On Wed, Nov 6, 2019 at 7:57 PM Eric Bresie wrote: Is this a reason to push for the UML plugin ;-) There are no reasons to push for uml, ever :-) -Tim Eric Bresie ebre...@gmail.com On November 6, 2019 at 9:02:49 AM CST, Eric Barboni wrote: Hi, Not sure that is what you want. ((A small help can be If you get the sources, do a first build: ant you can then do ant index-layer-paths this will create in nbbuild/build/generated layers.txt and services.txt where given a " UI element" " mimetype" "project type" you can find which module provide it (this is a bit too textual). )) Maybe you want a more complex visualization, with rectangle and edge but I guess should be some layout and "dynamic page" to filter ( or 8K monitors :p). Modules are legion. Best Regards Eric -Message d'origine- De : Christian Lenz Envoyé : mercredi 6 novembre 2019 15:43 À : dev@netbeans.apache.org Objet : AW: NetBeans Design ➢ And this IMHO continues to be the best book on the NetBeans Platform: ➢ https://leanpub.com/nbp4beginners ➢ Gj Hey Geertjan, how does that fit in the reworked/categorized structure. Is the book still up to date? Just asking. Cheers Chris Von: Geertjan Wielenga Gesendet: Mittwoch, 6. November 2019 15:34 An: dev Betreff: Re: NetBeans Design On Wed, Nov 6, 2019 at 3:09 PM Christoph Theis wrote: I have the same problem: E.g., NB doesn't accept a current javahl. So, where would I find the module where the check happened (I grep'ed for the error message and found it). Are there dependencies? If I want to improve the error message (right now it is hidden in the log files), how to do it? So, summarizing, an eagles view of what NB is composed of, would be a start. Sthg., that would help newcomers to understand the code of NB. In many ways, the current GitHub structure provides the eagle's view you seek: https://github.com/apache/netbeans Rather than it being a long list of modules, the above categorizes them into their clusters, reflecting what you see in your NetBeans installation directory. Indeed, grepping is a good approach to find the code you need to work with. You can also search directly in the GitHub repo on-line in the web interface. The dependencies of any modules are always listed in the project.xml file of a module. And this IMHO continues to be the best book on the NetBeans Platform: https://leanpub.com/nbp4beginners Gj @Jeremy: I hope I got your point. Best regards Christoph On 06.11.2019 14:24, Geertjan Wielenga wrote: What specific things are you looking for? Gj On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh wrote: Hi All, I was just wondering if there was a design document for NetBeans which shows how all the pieces fit together? I ask this because whenever I look at incubator-netbeans I have no idea of what I'm looking at, or where to find things. I really hope there is, particularly if it includes structure diagrams etc. Regards Jeremy - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: RE: NetBeans Design
A few people asked for a visual representation. I pulled this together a few years ago. Mostly it just illustrates why those kinds of representations are useless at scale. Package dependencies: https://timboudreau.com/files/nb-packagegraph/ Classes (IIRC trimmed down a LOT): https://timboudreau.com/files/netbeans-classes/ On Wed, Nov 6, 2019 at 7:57 PM Eric Bresie wrote: > Is this a reason to push for the UML plugin ;-) There are no reasons to push for uml, ever :-) -Tim > > Eric Bresie > ebre...@gmail.com > > On November 6, 2019 at 9:02:49 AM CST, Eric Barboni > wrote: > > Hi, > > Not sure that is what you want. > > > > ((A small help can be > > If you get the sources, do a first build: > > ant > > you can then do > > ant index-layer-paths > > > > this will create in nbbuild/build/generated layers.txt and services.txt > > where given a " UI element" " mimetype" "project type" you can find > which module provide it (this is a bit too textual). > > )) > > > > Maybe you want a more complex visualization, with rectangle and edge but > I guess should be some layout and "dynamic page" to filter ( or 8K monitors > :p). Modules are legion. > > > > Best Regards > > Eric > > -Message d'origine- > > De : Christian Lenz > > Envoyé : mercredi 6 novembre 2019 15:43 > > À : dev@netbeans.apache.org > > Objet : AW: NetBeans Design > > > > ➢ And this IMHO continues to be the best book on the NetBeans Platform: > > > > ➢ https://leanpub.com/nbp4beginners > > > > ➢ Gj > > > > Hey Geertjan, > > > > how does that fit in the reworked/categorized structure. Is the book > still up to date? Just asking. > > > > > > Cheers > > > > Chris > > > > > > Von: Geertjan Wielenga > > Gesendet: Mittwoch, 6. November 2019 15:34 > > An: dev > > Betreff: Re: NetBeans Design > > > > On Wed, Nov 6, 2019 at 3:09 PM Christoph Theis wrote: > > > > > I have the same problem: > > > E.g., NB doesn't accept a current javahl. So, where would I find the > > > module where the check happened (I grep'ed for the error message and > > > found it). Are there dependencies? If I want to improve the error > > > message (right now it is hidden in the log files), how to do it? > > > > > > So, summarizing, an eagles view of what NB is composed of, would be a > > > start. Sthg., that would help newcomers to understand the code of NB. > > > > > > > > > In many ways, the current GitHub structure provides the eagle's view you > > seek: > > > > https://github.com/apache/netbeans > > > > Rather than it being a long list of modules, the above categorizes them > into their clusters, reflecting what you see in your NetBeans installation > directory. > > > > Indeed, grepping is a good approach to find the code you need to work > with. > > > > You can also search directly in the GitHub repo on-line in the web > interface. > > > > The dependencies of any modules are always listed in the project.xml > file of a module. > > > > And this IMHO continues to be the best book on the NetBeans Platform: > > > > https://leanpub.com/nbp4beginners > > > > Gj > > > > > > > > > > > > > > > > @Jeremy: I hope I got your point. > > > > > > > > > Best regards > > > > > > Christoph > > > > > > On 06.11.2019 14:24, Geertjan Wielenga wrote: > > > > What specific things are you looking for? > > > > > > > > Gj > > > > > > > > On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh > > > > > > > > wrote: > > > > > > > > > Hi All, > > > > > > > > > > I was just wondering if there was a design document for NetBeans > > > > > which shows how all the pieces fit together? I ask this because > > > > > whenever I look at incubator-netbeans I have no idea of what I'm > > > > > looking at, or where to find things. > > > > > > > > > > I really hope there is, particularly if it includes structure > > > > > diagrams > > > etc. > > > > > > > > > > Regards > > > > > > > > > > Jeremy > > > > > > - > > > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > > > For additional commands, e-mail: dev-h...@netbeans.apache.org > > > > > > For further information about the NetBeans mailing lists, visit: > > > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > > > > > > > > > > > > > > > > > > - > > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > > For additional commands, e-mail: dev-h...@netbeans.apache.org > > > > For further information about the NetBeans mailing lists, visit: > > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > > > > > -- http://timboudreau.com
Re: RE: NetBeans Design
Is this a reason to push for the UML plugin ;-) Eric Bresie ebre...@gmail.com > On November 6, 2019 at 9:02:49 AM CST, Eric Barboni wrote: > Hi, > Not sure that is what you want. > > ((A small help can be > If you get the sources, do a first build: > ant > you can then do > ant index-layer-paths > > this will create in nbbuild/build/generated layers.txt and services.txt > where given a " UI element" " mimetype" "project type" you can find which > module provide it (this is a bit too textual). > )) > > Maybe you want a more complex visualization, with rectangle and edge but I > guess should be some layout and "dynamic page" to filter ( or 8K monitors > :p). Modules are legion. > > Best Regards > Eric > -Message d'origine- > De : Christian Lenz > Envoyé : mercredi 6 novembre 2019 15:43 > À : dev@netbeans.apache.org > Objet : AW: NetBeans Design > > ➢ And this IMHO continues to be the best book on the NetBeans Platform: > > ➢ https://leanpub.com/nbp4beginners > > ➢ Gj > > Hey Geertjan, > > how does that fit in the reworked/categorized structure. Is the book still up > to date? Just asking. > > > Cheers > > Chris > > > Von: Geertjan Wielenga > Gesendet: Mittwoch, 6. November 2019 15:34 > An: dev > Betreff: Re: NetBeans Design > > On Wed, Nov 6, 2019 at 3:09 PM Christoph Theis wrote: > > > I have the same problem: > > E.g., NB doesn't accept a current javahl. So, where would I find the > > module where the check happened (I grep'ed for the error message and > > found it). Are there dependencies? If I want to improve the error > > message (right now it is hidden in the log files), how to do it? > > > > So, summarizing, an eagles view of what NB is composed of, would be a > > start. Sthg., that would help newcomers to understand the code of NB. > > > > > In many ways, the current GitHub structure provides the eagle's view you > seek: > > https://github.com/apache/netbeans > > Rather than it being a long list of modules, the above categorizes them into > their clusters, reflecting what you see in your NetBeans installation > directory. > > Indeed, grepping is a good approach to find the code you need to work with. > > You can also search directly in the GitHub repo on-line in the web interface. > > The dependencies of any modules are always listed in the project.xml file of > a module. > > And this IMHO continues to be the best book on the NetBeans Platform: > > https://leanpub.com/nbp4beginners > > Gj > > > > > > > > > @Jeremy: I hope I got your point. > > > > > > Best regards > > > > Christoph > > > > On 06.11.2019 14:24, Geertjan Wielenga wrote: > > > What specific things are you looking for? > > > > > > Gj > > > > > > On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh > > > > > > wrote: > > > > > > > Hi All, > > > > > > > > I was just wondering if there was a design document for NetBeans > > > > which shows how all the pieces fit together? I ask this because > > > > whenever I look at incubator-netbeans I have no idea of what I'm > > > > looking at, or where to find things. > > > > > > > > I really hope there is, particularly if it includes structure > > > > diagrams > > etc. > > > > > > > > Regards > > > > > > > > Jeremy > > > > - > > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > > For additional commands, e-mail: dev-h...@netbeans.apache.org > > > > For further information about the NetBeans mailing lists, visit: > > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > > > > > > > > > > - > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > For additional commands, e-mail: dev-h...@netbeans.apache.org > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > >
RE: NetBeans Design
Hi, Not sure that is what you want. ((A small help can be If you get the sources, do a first build: ant you can then do ant index-layer-paths this will create in nbbuild/build/generated layers.txt and services.txt where given a " UI element" " mimetype" "project type" you can find which module provide it (this is a bit too textual). )) Maybe you want a more complex visualization, with rectangle and edge but I guess should be some layout and "dynamic page" to filter ( or 8K monitors :p). Modules are legion. Best Regards Eric -Message d'origine- De : Christian Lenz Envoyé : mercredi 6 novembre 2019 15:43 À : dev@netbeans.apache.org Objet : AW: NetBeans Design ➢ And this IMHO continues to be the best book on the NetBeans Platform: ➢ https://leanpub.com/nbp4beginners ➢ Gj Hey Geertjan, how does that fit in the reworked/categorized structure. Is the book still up to date? Just asking. Cheers Chris Von: Geertjan Wielenga Gesendet: Mittwoch, 6. November 2019 15:34 An: dev Betreff: Re: NetBeans Design On Wed, Nov 6, 2019 at 3:09 PM Christoph Theis wrote: > I have the same problem: > E.g., NB doesn't accept a current javahl. So, where would I find the > module where the check happened (I grep'ed for the error message and > found it). Are there dependencies? If I want to improve the error > message (right now it is hidden in the log files), how to do it? > > So, summarizing, an eagles view of what NB is composed of, would be a > start. Sthg., that would help newcomers to understand the code of NB. > In many ways, the current GitHub structure provides the eagle's view you seek: https://github.com/apache/netbeans Rather than it being a long list of modules, the above categorizes them into their clusters, reflecting what you see in your NetBeans installation directory. Indeed, grepping is a good approach to find the code you need to work with. You can also search directly in the GitHub repo on-line in the web interface. The dependencies of any modules are always listed in the project.xml file of a module. And this IMHO continues to be the best book on the NetBeans Platform: https://leanpub.com/nbp4beginners Gj > > @Jeremy: I hope I got your point. > > > Best regards > > Christoph > > On 06.11.2019 14:24, Geertjan Wielenga wrote: > > What specific things are you looking for? > > > > Gj > > > > On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh > > > > wrote: > > > >> Hi All, > >> > >> I was just wondering if there was a design document for NetBeans > >> which shows how all the pieces fit together? I ask this because > >> whenever I look at incubator-netbeans I have no idea of what I'm > >> looking at, or where to find things. > >> > >> I really hope there is, particularly if it includes structure > >> diagrams > etc. > >> > >> Regards > >> > >> Jeremy > > - > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > For additional commands, e-mail: dev-h...@netbeans.apache.org > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > > - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: NetBeans Design
On Wed, Nov 6, 2019 at 3:43 PM Christian Lenz wrote: > ➢ And this IMHO continues to be the best book on the NetBeans Platform: > > ➢ https://leanpub.com/nbp4beginners > > ➢ Gj > > Hey Geertjan, > > how does that fit in the reworked/categorized structure. Is the book still > up to date? Just asking. > Get the book. You'll see that aspect is unchanged and not discussed in that way in the book in the first place. Gj > > > Cheers > > Chris > > > Von: Geertjan Wielenga > Gesendet: Mittwoch, 6. November 2019 15:34 > An: dev > Betreff: Re: NetBeans Design > > On Wed, Nov 6, 2019 at 3:09 PM Christoph Theis wrote: > > > I have the same problem: > > E.g., NB doesn't accept a current javahl. So, where would I find the > > module where the check happened (I grep'ed for the error message and > > found it). Are there dependencies? If I want to improve the error > > message (right now it is hidden in the log files), how to do it? > > > > So, summarizing, an eagles view of what NB is composed of, would be a > > start. Sthg., that would help newcomers to understand the code of NB. > > > > > In many ways, the current GitHub structure provides the eagle's view you > seek: > > https://github.com/apache/netbeans > > Rather than it being a long list of modules, the above categorizes them > into their clusters, reflecting what you see in your NetBeans installation > directory. > > Indeed, grepping is a good approach to find the code you need to work with. > > You can also search directly in the GitHub repo on-line in the web > interface. > > The dependencies of any modules are always listed in the project.xml file > of a module. > > And this IMHO continues to be the best book on the NetBeans Platform: > > https://leanpub.com/nbp4beginners > > Gj > > > > > > > > > @Jeremy: I hope I got your point. > > > > > > Best regards > > > > Christoph > > > > On 06.11.2019 14:24, Geertjan Wielenga wrote: > > > What specific things are you looking for? > > > > > > Gj > > > > > > On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh < > jeremy.cavan...@orange.fr> > > > wrote: > > > > > >> Hi All, > > >> > > >> I was just wondering if there was a design document for NetBeans which > > >> shows how all the pieces fit together? I ask this because whenever I > > >> look at incubator-netbeans I have no idea of what I'm looking at, or > > >> where to find things. > > >> > > >> I really hope there is, particularly if it includes structure diagrams > > etc. > > >> > > >> Regards > > >> > > >> Jeremy > > > > - > > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > > For additional commands, e-mail: dev-h...@netbeans.apache.org > > > > For further information about the NetBeans mailing lists, visit: > > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > > > > > > > >
AW: NetBeans Design
➢ And this IMHO continues to be the best book on the NetBeans Platform: ➢ https://leanpub.com/nbp4beginners ➢ Gj Hey Geertjan, how does that fit in the reworked/categorized structure. Is the book still up to date? Just asking. Cheers Chris Von: Geertjan Wielenga Gesendet: Mittwoch, 6. November 2019 15:34 An: dev Betreff: Re: NetBeans Design On Wed, Nov 6, 2019 at 3:09 PM Christoph Theis wrote: > I have the same problem: > E.g., NB doesn't accept a current javahl. So, where would I find the > module where the check happened (I grep'ed for the error message and > found it). Are there dependencies? If I want to improve the error > message (right now it is hidden in the log files), how to do it? > > So, summarizing, an eagles view of what NB is composed of, would be a > start. Sthg., that would help newcomers to understand the code of NB. > In many ways, the current GitHub structure provides the eagle's view you seek: https://github.com/apache/netbeans Rather than it being a long list of modules, the above categorizes them into their clusters, reflecting what you see in your NetBeans installation directory. Indeed, grepping is a good approach to find the code you need to work with. You can also search directly in the GitHub repo on-line in the web interface. The dependencies of any modules are always listed in the project.xml file of a module. And this IMHO continues to be the best book on the NetBeans Platform: https://leanpub.com/nbp4beginners Gj > > @Jeremy: I hope I got your point. > > > Best regards > > Christoph > > On 06.11.2019 14:24, Geertjan Wielenga wrote: > > What specific things are you looking for? > > > > Gj > > > > On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh > > wrote: > > > >> Hi All, > >> > >> I was just wondering if there was a design document for NetBeans which > >> shows how all the pieces fit together? I ask this because whenever I > >> look at incubator-netbeans I have no idea of what I'm looking at, or > >> where to find things. > >> > >> I really hope there is, particularly if it includes structure diagrams > etc. > >> > >> Regards > >> > >> Jeremy > > - > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > For additional commands, e-mail: dev-h...@netbeans.apache.org > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > >
Re: NetBeans Design
Well as you see the dependencies are quite extensive, I would judge that probably it won't even worth to try io represent it in 2D. Someone made some visualization earlier which was more for fun than useful. If you find something that you would like to explore, the best way is to search on some string the UI has or the log reports in the source code. I still use that technique when I would like to find something I haven't worked on. Beside of that you need to know how the Lookups are working and the Layer filesystem registration. BTW if there were a Noble prize in the Java World, I'd definitely nominate Jaroslav Tulach for the Lookup API. So it is worth to check out. On 11/6/19 6:31 AM, Geertjan Wielenga wrote: https://cwiki.apache.org/confluence/display/NETBEANS/NetBeans+Platform+Architecture Please write to the mailing list, not to me, so others can join in. Gj On Wed, Nov 6, 2019 at 2:43 PM Jeremy Cavanagh wrote: Hi Geertjan, First, it's just general interest and understanding of the NetBeans package. Secondly, It was related to the list of small (but somewhat irritating) problems that I posted. I was trying, for instance, to find the code that starts NetBeans to see if I could understand why the boot process resulted in a grey square and not show the logo and progress bar, but, the first boot after install it worked okay. It's things like that which would provide me with a better understanding of what's going on and help me when i restart my efforts on the Java tutorials. Regards Jeremy On 06/11/2019 14:24, Geertjan Wielenga wrote: What specific things are you looking for? Gj On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh wrote: Hi All, I was just wondering if there was a design document for NetBeans which shows how all the pieces fit together? I ask this because whenever I look at incubator-netbeans I have no idea of what I'm looking at, or where to find things. I really hope there is, particularly if it includes structure diagrams etc. Regards Jeremy - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: NetBeans Design
On Wed, Nov 6, 2019 at 3:09 PM Christoph Theis wrote: > I have the same problem: > E.g., NB doesn't accept a current javahl. So, where would I find the > module where the check happened (I grep'ed for the error message and > found it). Are there dependencies? If I want to improve the error > message (right now it is hidden in the log files), how to do it? > > So, summarizing, an eagles view of what NB is composed of, would be a > start. Sthg., that would help newcomers to understand the code of NB. > In many ways, the current GitHub structure provides the eagle's view you seek: https://github.com/apache/netbeans Rather than it being a long list of modules, the above categorizes them into their clusters, reflecting what you see in your NetBeans installation directory. Indeed, grepping is a good approach to find the code you need to work with. You can also search directly in the GitHub repo on-line in the web interface. The dependencies of any modules are always listed in the project.xml file of a module. And this IMHO continues to be the best book on the NetBeans Platform: https://leanpub.com/nbp4beginners Gj > > @Jeremy: I hope I got your point. > > > Best regards > > Christoph > > On 06.11.2019 14:24, Geertjan Wielenga wrote: > > What specific things are you looking for? > > > > Gj > > > > On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh > > wrote: > > > >> Hi All, > >> > >> I was just wondering if there was a design document for NetBeans which > >> shows how all the pieces fit together? I ask this because whenever I > >> look at incubator-netbeans I have no idea of what I'm looking at, or > >> where to find things. > >> > >> I really hope there is, particularly if it includes structure diagrams > etc. > >> > >> Regards > >> > >> Jeremy > > - > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > For additional commands, e-mail: dev-h...@netbeans.apache.org > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > >
Re: NetBeans Design
https://cwiki.apache.org/confluence/display/NETBEANS/NetBeans+Platform+Architecture Please write to the mailing list, not to me, so others can join in. Gj On Wed, Nov 6, 2019 at 2:43 PM Jeremy Cavanagh wrote: > Hi Geertjan, > > First, it's just general interest and understanding of the NetBeans > package. Secondly, It was related to the list of small (but somewhat > irritating) problems that I posted. > > I was trying, for instance, to find the code that starts NetBeans to see > if I could understand why the boot process resulted in a grey square and > not show the logo and progress bar, but, the first boot after install it > worked okay. > > It's things like that which would provide me with a better understanding > of what's going on and help me when i restart my efforts on the Java > tutorials. > > Regards > > Jeremy > > On 06/11/2019 14:24, Geertjan Wielenga wrote: > > What specific things are you looking for? > > > > Gj > > > > On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh > > wrote: > > > >> Hi All, > >> > >> I was just wondering if there was a design document for NetBeans which > >> shows how all the pieces fit together? I ask this because whenever I > >> look at incubator-netbeans I have no idea of what I'm looking at, or > >> where to find things. > >> > >> I really hope there is, particularly if it includes structure diagrams > etc. > >> > >> Regards > >> > >> Jeremy > >> > >> - > >> To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > >> For additional commands, e-mail: dev-h...@netbeans.apache.org > >> > >> For further information about the NetBeans mailing lists, visit: > >> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > >> > >> > >> > >> > > >
Re: NetBeans Design
http://wiki.netbeans.org/DevFaqApiSpi Gj On Wed, Nov 6, 2019 at 2:46 PM Jeremy Cavanagh wrote: > P.S., what does spi stand for? It's all over the place and I can't find > a definition that makes sense. > > On 06/11/2019 14:24, Geertjan Wielenga wrote: > > What specific things are you looking for? > > > > Gj > > > > On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh > > wrote: > > > >> Hi All, > >> > >> I was just wondering if there was a design document for NetBeans which > >> shows how all the pieces fit together? I ask this because whenever I > >> look at incubator-netbeans I have no idea of what I'm looking at, or > >> where to find things. > >> > >> I really hope there is, particularly if it includes structure diagrams > etc. > >> > >> Regards > >> > >> Jeremy > >> > >> - > >> To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > >> For additional commands, e-mail: dev-h...@netbeans.apache.org > >> > >> For further information about the NetBeans mailing lists, visit: > >> https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > >> > >> > >> > >> > > >
Re: NetBeans Design
I have the same problem: E.g., NB doesn't accept a current javahl. So, where would I find the module where the check happened (I grep'ed for the error message and found it). Are there dependencies? If I want to improve the error message (right now it is hidden in the log files), how to do it? So, summarizing, an eagles view of what NB is composed of, would be a start. Sthg., that would help newcomers to understand the code of NB. @Jeremy: I hope I got your point. Best regards Christoph On 06.11.2019 14:24, Geertjan Wielenga wrote: What specific things are you looking for? Gj On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh wrote: Hi All, I was just wondering if there was a design document for NetBeans which shows how all the pieces fit together? I ask this because whenever I look at incubator-netbeans I have no idea of what I'm looking at, or where to find things. I really hope there is, particularly if it includes structure diagrams etc. Regards Jeremy - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
Re: NetBeans Design
What specific things are you looking for? Gj On Wed, 6 Nov 2019 at 14:05, Jeremy Cavanagh wrote: > Hi All, > > I was just wondering if there was a design document for NetBeans which > shows how all the pieces fit together? I ask this because whenever I > look at incubator-netbeans I have no idea of what I'm looking at, or > where to find things. > > I really hope there is, particularly if it includes structure diagrams etc. > > Regards > > Jeremy > > - > To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org > For additional commands, e-mail: dev-h...@netbeans.apache.org > > For further information about the NetBeans mailing lists, visit: > https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists > > > >
NetBeans Design
Hi All, I was just wondering if there was a design document for NetBeans which shows how all the pieces fit together? I ask this because whenever I look at incubator-netbeans I have no idea of what I'm looking at, or where to find things. I really hope there is, particularly if it includes structure diagrams etc. Regards Jeremy - To unsubscribe, e-mail: dev-unsubscr...@netbeans.apache.org For additional commands, e-mail: dev-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists