[netbeans] 11/15: Add README.source file and try to explain how Netbeans can be maintained.

[Markus Koschany]

This is an automated email from the git hooks/post-receive script.

apo-guest pushed a commit to branch master
in repository netbeans.

commit b0661d3c87a1a60f8658a4371ab1b7a4e5284daa
Author: Markus Koschany <apo at debian.org>
Date:   Thu Dec 31 07:39:04 2015 +0100

    Add README.source file and try to explain how Netbeans can be maintained.
---
 debian/README.source | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..a33fd33
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,48 @@
+How to maintain Netbeans
+========================
+
+1. Update libnb-platform18-java first.
+
+    Due to historical and practical reasons the platform modules are packaged
+    separately. libnb-platform18-java is easier to maintain and less error
+    prone which reduces the maintenance work as a whole. src:netbeans builds
+    exactly the same modules but depends on binary packages from
+    libnb-platform18-java in the end. You can simply copy&paste the patches
+    from libnb-platform18-java and be done with it.
+
+    Download the sources for libnb-platform18-java from:
+    https://netbeans.org/downloads/zip.html
+    Run the orig-tar.sh script on *-platform-src.zip and create a DFSG
+    compliant tarball.
+
+2. Download the sources for Netbeans from:
+    https://netbeans.org/downloads/zip.html
+    Run the orig-tar.sh script on *-src.zip and create a DFSG compliant
+    tarball.
+
+3. Refresh all Netbeans patches as necessary.
+
+    The patches are labeled netbeans-platform-* for platform specific patches
+    and netbeans-[module|or_another_descriptive_phrase] for src:netbeans
+    specific patches that work around various issues with the build system
+    because we have to replace all embedded jar files with system jar files and
+    because we only build the core features and not everything. All other
+    patches are Debian specific because of either outdated or too recent
+    dependencies.
+
+4. You can empty the binaries-list files with this command to avoid that the
+   build system starts to download jar files from the internet.
+
+    find . -type f -name "binaries-list" -exec sh -c '> {}' \;
+
+5. Fix build failures by disabling modules in nbbuild/cluster.properties or by
+   adding new build-dependencies to debian/control.
+
+6. Update debian/linked-jars accordingly. In most cases it is sufficient to
+   update version numbers. A quick look at netbeans-empty-binaries-list.patch
+   will tell you what kind of version the build system expects.
+
+
+TODO:
+
+    * It would be nice to support HTML5/Javascript and Maven out-of-the box.

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-java/netbeans.git