You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@netbeans.apache.org by ge...@apache.org on 2020/12/10 15:49:17 UTC
[netbeans-website] branch master updated: Add a section to describe
the steps needed to start developing NetBeans using NetBeans.
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 <jo...@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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: commits-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists