This is an automated email from the ASF dual-hosted git repository. geertjan pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/netbeans-website.git
The following commit(s) were added to refs/heads/master by this push: new 8241eb8 Add a section to describe the steps needed to start developing NetBeans using NetBeans. new 0670e8e Merge pull request #505 from jostle/jostle-howto-debug-netbeans 8241eb8 is described below commit 8241eb8b0f5ffb679d57d363c26457bc59950866 Author: John Lemcke <jos...@jostlesoft.com> AuthorDate: Thu Dec 10 12:59:05 2020 +1100 Add a section to describe the steps needed to start developing NetBeans using NetBeans. This is intended to complement the existing tutorial videos. --- .../src/content/participate/submit-pr.asciidoc | 64 +++++++++++++++++++++- 1 file changed, 63 insertions(+), 1 deletion(-) diff --git a/netbeans.apache.org/src/content/participate/submit-pr.asciidoc b/netbeans.apache.org/src/content/participate/submit-pr.asciidoc index 4dd068a..09d6d85 100644 --- a/netbeans.apache.org/src/content/participate/submit-pr.asciidoc +++ b/netbeans.apache.org/src/content/participate/submit-pr.asciidoc @@ -58,7 +58,7 @@ We appreciate new contributors to adhere to the following guidelines, to make th . Try to keep the code *readable, maintainable, easy to debug* and *performant*. == Learn to run and debug NetBeans IDE or Platform applications -link:/participate/build-run-debug-tutorials.html[Watch a series of 5 short videos] (2 minutes on average) showing how to build, run and debug the NetBeans IDE or any NetBeans platform application from sources. +link:/participate/build-run-debug-tutorials.html[Watch a series of 5 short videos] (2 minutes on average) or see link:#develop[Developing NetBeans with NetBeans] for help on how to build, run and debug the NetBeans IDE or any NetBeans platform application from sources. == Contributing to Apache NetBeans in GitHub @@ -70,6 +70,21 @@ the "fork" button on the top right of the GitHub page. You then need to clone the forked repository in your computer. +[source, shell] +---- +cd <your-project-dir> +git clone https://github.com/<your-username>/netbeans.git +---- + +At this stage it is a good idea to check that you can build and run NetBeans. + +[source, shell] +---- +cd netbeans +ant +ant tryme +---- + Finally, in your computer, you need to setup your name and email in GitHub. This will also help git to rebase in order to fulfill its task. @@ -135,6 +150,53 @@ https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History After submission (and certainly after someone starts reviewing the PR) you shouldn't touch the PR's history. +[[develop]] +== Developing NetBeans with NetBeans +These steps assume you have already forked, cloned and configured your NetBeans development repository. + +. Configure NetBeans + * Open your currently installed NetBeans + * Enable the _Developing NetBeans_ plugin. + ** Open the _Plugins_ dialog (_Tools->Plugins_) + ** Find _Developing NetBeans_ in either the _Available_ or _Installed_ list + ** If it is _Available_ select its checkbox and click _Install_ + ** If it is _Installed_ but not _Active_, select its checkbox and click _Activate_ + +. Add your development repository as a NetBeans Platform + * Open the _NetBeans Platform Manager_ (_Tools->NetBeans Platforms_) + * Click _Add Platform ..._ + * Navigate to `<your-project-dir>/netbeans/nbbuild/` and select `netbeans` + * Click _Next >_ + * Click _Finish_ + * Select the _Sources_ tab + * Click _Add ZIP/Folder ..._ + * Select `<your-project-dir>/netbeans` and click _Open_ + * Close _NetBeans Platform Manager_ + +. Create a new project (_File->New Project..._) + * In _Categories:_ select _Java with Ant / NetBeans Modules_ + * In _Projects:_ select _Module Suite_ + * Click _Next >_ + * Enter a _Project Name:_ (e.g. NB-IDE-DEV) + * Optionally change the _Project Location:_ + * Click _Finish_ + +. Locate the source code for your development repository + * Open the _Favorites_ window (_Window->Favorites_) + * Select _Add to Favorites..._ in the right-click context menu + * Select `<your-project-dir>/netbeans` and click _Add_ + +. Set a breakpoint in the source code. As a start try the entry point `public static void main (String args[])` + * In the _Favorites_ tab navigate to `platform/o.n.bootstrap/src/org/netbeans` and open `Main.java` + * Set a breakpoint + +. Start the debugger + * Select your IDE project (e.g. NB-IDE-DEV) from the _Run->Set Main Project_ menu + * Start the debugger : + ** _Debug->Debug Main Project_ menu, + ** *or* Click the Debug toolbar item + ** *or* Ctrl+F5 + [[donating-code]] == Donating Code --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@netbeans.apache.org For additional commands, e-mail: commits-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists