Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 1 Apr 2015 18:55:49 +0000 (UTC)
From:      Eitan Adler <eadler@FreeBSD.org>
To:        doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org
Subject:   svn commit: r46414 - in head/en_US.ISO8859-1/htdocs/java: . dists
Message-ID:  <201504011855.t31ItnJS039881@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: eadler
Date: Wed Apr  1 18:55:49 2015
New Revision: 46414
URL: https://svnweb.freebsd.org/changeset/doc/46414

Log:
  htdocs/java: multiple
  
  - migrate individual pages from 16 and 17 into the main page
  - don't use the word 'absolute'
  - make the "I want to help" stuff look nicer
  
  quick review by jgh, discussed with allanjude

Deleted:
  head/en_US.ISO8859-1/htdocs/java/dists/
Modified:
  head/en_US.ISO8859-1/htdocs/java/Makefile
  head/en_US.ISO8859-1/htdocs/java/index.xml

Modified: head/en_US.ISO8859-1/htdocs/java/Makefile
==============================================================================
--- head/en_US.ISO8859-1/htdocs/java/Makefile	Wed Apr  1 18:37:57 2015	(r46413)
+++ head/en_US.ISO8859-1/htdocs/java/Makefile	Wed Apr  1 18:55:49 2015	(r46414)
@@ -7,9 +7,6 @@
 .include "../Makefile.inc"
 .endif
 
-SUBDIR =	dists
-
-DOCS+=  howhelp.xml
 DOCS+=  index.xml
 DOCS+=  install.xml
 

Modified: head/en_US.ISO8859-1/htdocs/java/index.xml
==============================================================================
--- head/en_US.ISO8859-1/htdocs/java/index.xml	Wed Apr  1 18:37:57 2015	(r46413)
+++ head/en_US.ISO8859-1/htdocs/java/index.xml	Wed Apr  1 18:55:49 2015	(r46414)
@@ -35,17 +35,23 @@
     <a href="http://www.FreeBSDFoundation.org/java">FreeBSD
     Foundation &java; Downloads</a> page.</p>
 
-  <h2>Software</h2>
+  <h2>Getting Java</h2>
 
-  <ul>
-    <li><a href="install.html">Getting &java; for FreeBSD</a></li>
-    <li><a href="dists/">Release Information</a></li>
-    <li><a href="dists/16.html">JDK 1.6.x</a></li>
-    <li><a href="dists/17.html">JDK 1.7.x</a></li>
-    <li><a href="../ports/java.html">Available Ports...</a></li>
-    <li><a href="howhelp.html">How can I help?</a></li>
-    <li><a href="howhelp.html#BUG">I found a bug!?!</a></li>
-  </ul>
+  <p><a href="install.html">Getting &java; for FreeBSD</a> describes
+    how to install &java;</p>
+    <p>
+    &openjdk; 7 is frequently updated, and it is suggested to refer to a
+    <a href="http://svnweb.freebsd.org/ports/head/java/openjdk7/Makefile?view=log">revision log</a> for
+    detailed release history. Additionally, one may choose to review more information at
+    <a href="http://www.freshports.org/java/openjdk7">FreshPorts</a>.
+    </p>
+
+    <p>
+    &openjdk; 6 is frequently updated, and it is suggested to refer to a
+    <a href="http://svnweb.freebsd.org/ports/head/java/openjdk6/Makefile?view=log">revision log</a> for
+    detailed release history. Additionally, one may choose to review more information at
+    <a href="http://www.freshports.org/java/openjdk6">FreshPorts</a>.
+    </p>
 
   <h2>Documentation</h2>
 
@@ -53,5 +59,26 @@
     <li><a href="&url.books;/porters-handbook/using-java.html">Creating Ports</a></li>
   </ul>
 
+
+  <h2>I want to help by...</h2>
+
+  <h3>... testing</h3>
+
+  <p>The best thing you can do is download the latest release, install it, and try all your favorite Java applications.  If they don't work, see below.</p>
+
+  <h3>... reporting a bug</h3>
+  <p>If you find an application that does not work, or crashes, here are the steps you should follow before reporting it:</p>
+  <ol>
+    <li>Try it again.</li>
+    <li>Check your settings for this application.  Check to see if you made a mistake in starting it up.</li>
+    <li>Try it on a different platform.  If you have access to a reference platform, try it there.  (We need to determine if it is an application error, a Java bug, or a FreeBSD specific bug.)</li>
+    <li>Narrow down the problem.  If it is your own code, narrow down the bug to the offending code.  Otherwise, determine the steps required to reproduce the problem.</li>
+    <li>Notify the JDK porting team.  Send email to <a href="mailto:freebsd-java@FreeBSD.org">freebsd-java@FreeBSD.org</a>.  Be sure to include the steps you have followed.</li>
+    <li>Finally, and most importantly, be willing to work with the team to fix the problem.</li>
+  </ol>
+
+  <h3>...writing documentation</h3>
+  <p>Everyone can help here.  If you have a suggestion to add to the documentation, write it up and send it to <a href="mailto:freebsd-java@FreeBSD.org">freebsd-java@FreeBSD.org</a></p>
+
   </body>
 </html>



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201504011855.t31ItnJS039881>