Fix up javadoc warnings

Package-Manager: portage-2.1.10.41/cvs/Linux x86_64

4 files changed, 45 insertions, 26 deletions

diff --git a/dev-lang/tuprolog/ChangeLog b/dev-lang/tuprolog/ChangeLog
index 31afb22a3f49..1436264a3bc0 100644
--- a/dev-lang/tuprolog/ChangeLog
+++ b/dev-lang/tuprolog/ChangeLog
@@ -1,6 +1,10 @@
 # ChangeLog for dev-lang/tuprolog
-# Copyright 1999-2011 Gentoo Foundation; Distributed under the GPL v2
-# $Header: /var/cvsroot/gentoo-x86/dev-lang/tuprolog/ChangeLog,v 1.38 2011/05/26 06:27:07 keri Exp $
+# Copyright 1999-2012 Gentoo Foundation; Distributed under the GPL v2
+# $Header: /var/cvsroot/gentoo-x86/dev-lang/tuprolog/ChangeLog,v 1.39 2012/01/14 20:41:11 keri Exp $
+
+  14 Jan 2012; <keri@gentoo.org> files/tuprolog-2.3.1_beta-javadocs.patch,
+  files/build.xml:
+  Fix up javadoc warnings
 
   26 May 2011; <keri@gentoo.org> tuprolog-2.3.1_beta.ebuild:
   Fix sedding typo in src_prepare
diff --git a/dev-lang/tuprolog/Manifest b/dev-lang/tuprolog/Manifest
index a563da0c5b28..fa4497462014 100644
--- a/dev-lang/tuprolog/Manifest
+++ b/dev-lang/tuprolog/Manifest
@@ -1,24 +1,24 @@
 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 
-AUX build.xml 2388 RMD160 022f9159fac0de7e7609bc6868997f0afb8e8ada SHA1 4c34133ae643e0fb7d5f5fc1a98610bf4f71a674 SHA256 a25dcbe42c235e2274c4cf16c1b70986df04d83513dd6573188214bce19933e3
+AUX build.xml 2384 RMD160 f9fa9dc84e7626939f41854e3f4e469bb378ccd8 SHA1 75af3d819f47aed9d8f6c8d26c6ecb1a39d12e13 SHA256 65eb4ee48b234c1b0e48d4920dbc8e109fd1ab725b3a35d353073d2e96329fdd
 AUX tuprolog-2.1.1-java1.4.patch 6318 RMD160 621aec83d6f77585f15d4d0109b085c380d6e001 SHA1 4b0a471bd4103270274c5cd7e417140c45f06e15 SHA256 35bb62c71b645289242b2bb610879a455f408eddb8f65b6ead7ac71ebdfe12bc
 AUX tuprolog-2.1.1-javadocs.patch 6573 RMD160 0cc1f044ada95113ae638a9cd48c920fa3903a31 SHA1 64206767a27e7fceea9b04f9e65d2846bcd56b9d SHA256 12bc23f7f9300cc6e6d3ca0d3ebac163acec01bc490ad08135127bcded883bef
 AUX tuprolog-2.3.0_alpha-generics.patch 682 RMD160 de3a8f7c9654937b61d15cd6345c87f057a61db1 SHA1 0ee58b501c8c591ccf744bd876f8fb10fa35d99b SHA256 22b7425a3dbd857084a141fd5068239ba79882f781bd0b3c9f6496f3b26e4193
 AUX tuprolog-2.3.0_alpha-javadocs.patch 9013 RMD160 23422b8594bc5961d51d66ef4beb968e467fda94 SHA1 486339da7d60b60e8c059c58f679a58ba3bb76dd SHA256 906bf26e74ce0b15af63917f2a95d5f7287f77ee0bf84eeebe1923101e4fd4a6
-AUX tuprolog-2.3.1_beta-javadocs.patch 9133 RMD160 fc1fa88ca472913c89287b738ab04bcdf4e0ff6e SHA1 776fdffb44d5f9a80889bc00807c030ebef60125 SHA256 01bbe0681bedbb2e0d77cc89870289e7d5e9b73027c947d23e239d221b30ed7b
+AUX tuprolog-2.3.1_beta-javadocs.patch 9848 RMD160 ac32a2d74cfbdbaaaf38b949e8f238547ebec207 SHA1 d0b946e29d0c989210406f32ebd099cd6f8482cf SHA256 1fe5fdc8e5ed4af7051e724d84795986cf57309402eeb748d56283f36c806cc5
 DIST 2p-2.1.1.zip 1879216 RMD160 4cb3c1505c78ac0c432a0369ca117244cf4a7bba SHA1 3477a5432a74e5d58fb9cdf1e227288025300be0 SHA256 fe49fbee0c22c3bb6799895f4e1694ead184a689ab753ebf56031c2891dab7b5
 DIST 2p-2.3.0alpha.zip 2757862 RMD160 c6fc771b8b236433de41e160ca1ebe5ea0605b12 SHA1 d379fd42db9f4accf75b5b9d4570854fd3e9dc46 SHA256 f8c1da73d0a5ca04267aec46e0636754dad747f4354069fad40e054aaacbfed2
 DIST 2p-2.3.1.zip 2534203 RMD160 6c97b9dc8f0b5b63746c133479d77803c640d649 SHA1 64a8869ee73938945fffd30c25bb45ef5f1a7cac SHA256 7f56638d0401805008155749fb4fa367e4d21eb0a1d9be7c2e7fbc77514864c4
 EBUILD tuprolog-2.1.1.ebuild 1158 RMD160 67d6af25e461d64096a82432bc5b5206d6566281 SHA1 fe843f7462451d1217bde223d68b518592ced492 SHA256 11a8bbcc8a7602ad1c5532c5bf3e82ea7d2d7c907f73dd68a0ab6230d909bb4d
 EBUILD tuprolog-2.3.0_alpha.ebuild 1065 RMD160 9c63c8c1a332fdfb55334faeddbae29bed9158ab SHA1 5b86e09ef811a7da7685d5f282e0a49251d54e3d SHA256 3b7c141c04d56221b9372c08c3647c9dbb68d6d43319f2bacd3c261d7ead1398
 EBUILD tuprolog-2.3.1_beta.ebuild 1190 RMD160 7e56bbc0bc0dbcc9576c7a3c322ce7978cc01a1e SHA1 1c4b2836115761d564648543f04810f92fe4b875 SHA256 81dd15c5e8d1f3ee32d56b862c49d6721c2989758cef378c605c3bb4c7e5291c
-MISC ChangeLog 5292 RMD160 ce640e213cca09552393abf7e88d89d6e66d2bbb SHA1 374327acf31faae64a03d11c3b08fbff8c979d4c SHA256 62024ff7db75869c1801fa74c78d5f40217c2d9779f033c034e1483c38c77216
+MISC ChangeLog 5413 RMD160 af746755d4bb9508ef4f6c75bb6f68b982f7842d SHA1 0f97a71ed672f1adf27589f9baaf6a5992009a20 SHA256 97c1676d89cafc82b0e73a86471001692d2e6ba525971b7c7979c670904fd59a
 MISC metadata.xml 159 RMD160 38d27fd1c5faabedefa5507dfd83cb4c952fbc8c SHA1 52b92682cf41e53e71bf432537a16215bd9546b1 SHA256 851bf218a4283a1d8ea6ef98af0119a40eaa78bfaaec49c2f3440437f52889ba
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v2.0.17 (GNU/Linux)
 
-iEYEARECAAYFAk3d8scACgkQrwS/tqE49e0dtQCgnRs01ZaTkDDChogjEicPIzbj
-ZlEAnRwegVsrY8NPm6sdb58CxrTptXMr
-=x1zM
+iEYEARECAAYFAk8R6HIACgkQrwS/tqE49e0uiwCePhT/QFFCOfigoxxJXIE++ZPr
+EhQAn2CVOU69cjlYUle1toVA8UcN6UGk
+=bbV2
 -----END PGP SIGNATURE-----
diff --git a/dev-lang/tuprolog/files/build.xml b/dev-lang/tuprolog/files/build.xml
index d7dd6af46c78..c24e956b9eb3 100644
--- a/dev-lang/tuprolog/files/build.xml
+++ b/dev-lang/tuprolog/files/build.xml
@@ -5,7 +5,7 @@
 	<property name="build.dir" value="build"/>
 	<property name="docs.dir" value="docs"/>
 	<property name="dist.dir" value="dist"/>
-	<property name="test.dir" value="test/unit"/>
+	<property name="test.dir" value="test"/>
 	<property name="test.build.dir" value="test.build"/>
 	<property name="jarfile" value="${ant.project.name}.jar"/>
 	<property file="build.properties"/>
@@ -43,7 +43,7 @@
 	<!-- generate javadocs -->
 	<target depends="init" name="javadoc">
 		<javadoc classpath="${gentoo.classpath}"
-			author="true"
+			author="false"
 			destdir="${docs.dir}"
 			encoding="ISO-8859-1"
 			packagenames="alice.*"
diff --git a/dev-lang/tuprolog/files/tuprolog-2.3.1_beta-javadocs.patch b/dev-lang/tuprolog/files/tuprolog-2.3.1_beta-javadocs.patch
index decbdd3cc3eb..aa1f3dcbab2f 100644
--- a/dev-lang/tuprolog/files/tuprolog-2.3.1_beta-javadocs.patch
+++ b/dev-lang/tuprolog/files/tuprolog-2.3.1_beta-javadocs.patch
@@ -1,6 +1,6 @@
 diff -ur 2p-deploy.orig/src/alice/tuprolog/ChoicePointStore.java 2p-deploy/src/alice/tuprolog/ChoicePointStore.java
 --- 2p-deploy.orig/src/alice/tuprolog/ChoicePointStore.java	2010-01-21 21:29:24.000000000 +1300
-+++ 2p-deploy/src/alice/tuprolog/ChoicePointStore.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/tuprolog/ChoicePointStore.java	2012-01-15 09:20:48.000000000 +1300
 @@ -35,7 +35,6 @@
  	

  	/**

@@ -19,7 +19,7 @@ diff -ur 2p-deploy.orig/src/alice/tuprolog/ChoicePointStore.java 2p-deploy/src/a
  		if (pointer == null) return false;

 diff -ur 2p-deploy.orig/src/alice/tuprolog/ClauseStore.java 2p-deploy/src/alice/tuprolog/ClauseStore.java
 --- 2p-deploy.orig/src/alice/tuprolog/ClauseStore.java	2010-11-04 11:55:42.000000000 +1300
-+++ 2p-deploy/src/alice/tuprolog/ClauseStore.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/tuprolog/ClauseStore.java	2012-01-15 09:20:48.000000000 +1300
 @@ -62,8 +62,6 @@
  	
  	/**
@@ -29,10 +29,9 @@ diff -ur 2p-deploy.orig/src/alice/tuprolog/ClauseStore.java 2p-deploy/src/alice/
  	 * @return true if compatible or false otherwise.
  	 */
  	protected boolean existCompatibleClause() {
-Only in 2p-deploy/src/alice/tuprolog: ClauseStore.java.orig
 diff -ur 2p-deploy.orig/src/alice/tuprolog/EngineManager.java 2p-deploy/src/alice/tuprolog/EngineManager.java
 --- 2p-deploy.orig/src/alice/tuprolog/EngineManager.java	2010-01-21 21:29:24.000000000 +1300
-+++ 2p-deploy/src/alice/tuprolog/EngineManager.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/tuprolog/EngineManager.java	2012-01-15 09:20:48.000000000 +1300
 @@ -87,7 +87,7 @@
  	/**

  	 *  Solves a query

@@ -44,7 +43,7 @@ diff -ur 2p-deploy.orig/src/alice/tuprolog/EngineManager.java 2p-deploy/src/alic
  	 **/

 diff -ur 2p-deploy.orig/src/alice/tuprolog/PrimitiveManager.java 2p-deploy/src/alice/tuprolog/PrimitiveManager.java
 --- 2p-deploy.orig/src/alice/tuprolog/PrimitiveManager.java	2010-01-21 21:29:24.000000000 +1300
-+++ 2p-deploy/src/alice/tuprolog/PrimitiveManager.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/tuprolog/PrimitiveManager.java	2012-01-15 09:20:48.000000000 +1300
 @@ -87,7 +87,7 @@
  	 * This involves identifying structs representing builtin
  	 * predicates and functors, and setting up related structures and links
@@ -56,7 +55,7 @@ diff -ur 2p-deploy.orig/src/alice/tuprolog/PrimitiveManager.java 2p-deploy/src/a
  	public Term identifyDirective(Term term) {
 diff -ur 2p-deploy.orig/src/alice/tuprolog/lib/BasicLibrary.java 2p-deploy/src/alice/tuprolog/lib/BasicLibrary.java
 --- 2p-deploy.orig/src/alice/tuprolog/lib/BasicLibrary.java	2011-01-28 16:31:44.000000000 +1300
-+++ 2p-deploy/src/alice/tuprolog/lib/BasicLibrary.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/tuprolog/lib/BasicLibrary.java	2012-01-15 09:20:48.000000000 +1300
 @@ -109,7 +109,7 @@
  	/**

  	 * Loads a library constructed from a theory.

@@ -68,7 +67,7 @@ diff -ur 2p-deploy.orig/src/alice/tuprolog/lib/BasicLibrary.java 2p-deploy/src/a
  	 *            name of the library

 diff -ur 2p-deploy.orig/src/alice/tuprolog/lib/IOLibrary.java 2p-deploy/src/alice/tuprolog/lib/IOLibrary.java
 --- 2p-deploy.orig/src/alice/tuprolog/lib/IOLibrary.java	2011-01-19 16:34:24.000000000 +1300
-+++ 2p-deploy/src/alice/tuprolog/lib/IOLibrary.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/tuprolog/lib/IOLibrary.java	2012-01-15 09:20:48.000000000 +1300
 @@ -372,7 +372,7 @@
  	/**

  	 * Sets an arbitrary seed for the Random object.

@@ -80,7 +79,7 @@ diff -ur 2p-deploy.orig/src/alice/tuprolog/lib/IOLibrary.java 2p-deploy/src/alic
  	public boolean set_seed_1(Term t) throws PrologError {

 diff -ur 2p-deploy.orig/src/alice/tuprolog/lib/JavaLibrary.java 2p-deploy/src/alice/tuprolog/lib/JavaLibrary.java
 --- 2p-deploy.orig/src/alice/tuprolog/lib/JavaLibrary.java	2010-01-21 21:29:24.000000000 +1300
-+++ 2p-deploy/src/alice/tuprolog/lib/JavaLibrary.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/tuprolog/lib/JavaLibrary.java	2012-01-15 09:20:48.000000000 +1300
 @@ -1390,8 +1390,6 @@
  
  	/**
@@ -92,7 +91,7 @@ diff -ur 2p-deploy.orig/src/alice/tuprolog/lib/JavaLibrary.java 2p-deploy/src/al
  		return new Struct("$obj_" + id++);
 diff -ur 2p-deploy.orig/src/alice/tuprologx/ide/LibraryDialogFrame.java 2p-deploy/src/alice/tuprologx/ide/LibraryDialogFrame.java
 --- 2p-deploy.orig/src/alice/tuprologx/ide/LibraryDialogFrame.java	2010-01-21 21:29:22.000000000 +1300
-+++ 2p-deploy/src/alice/tuprologx/ide/LibraryDialogFrame.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/tuprologx/ide/LibraryDialogFrame.java	2012-01-15 09:20:48.000000000 +1300
 @@ -317,7 +317,6 @@
          displayLibraryManagerStatus();

      }

@@ -103,7 +102,7 @@ diff -ur 2p-deploy.orig/src/alice/tuprologx/ide/LibraryDialogFrame.java 2p-deplo
      	onClose();

 diff -ur 2p-deploy.orig/src/alice/tuprologx/ide/ToolBar.java 2p-deploy/src/alice/tuprologx/ide/ToolBar.java
 --- 2p-deploy.orig/src/alice/tuprologx/ide/ToolBar.java	2010-01-21 21:29:22.000000000 +1300
-+++ 2p-deploy/src/alice/tuprologx/ide/ToolBar.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/tuprologx/ide/ToolBar.java	2012-01-15 09:20:48.000000000 +1300
 @@ -232,8 +232,6 @@
  

      /**

@@ -115,7 +114,7 @@ diff -ur 2p-deploy.orig/src/alice/tuprologx/ide/ToolBar.java 2p-deploy/src/alice
  	{

 diff -ur 2p-deploy.orig/src/alice/tuprologx/pj/lib/PJLibrary.java 2p-deploy/src/alice/tuprologx/pj/lib/PJLibrary.java
 --- 2p-deploy.orig/src/alice/tuprologx/pj/lib/PJLibrary.java	2010-01-21 21:29:48.000000000 +1300
-+++ 2p-deploy/src/alice/tuprologx/pj/lib/PJLibrary.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/tuprologx/pj/lib/PJLibrary.java	2012-01-15 09:20:48.000000000 +1300
 @@ -1252,7 +1252,6 @@
  	
  	/**
@@ -124,9 +123,25 @@ diff -ur 2p-deploy.orig/src/alice/tuprologx/pj/lib/PJLibrary.java 2p-deploy/src/
  	 */
  	protected Struct generateFreshId() {
  		return new Struct("$obj_" + id++);        
+diff -ur 2p-deploy.orig/src/alice/util/ReadOnlyLinkedList.java 2p-deploy/src/alice/util/ReadOnlyLinkedList.java
+--- 2p-deploy.orig/src/alice/util/ReadOnlyLinkedList.java	2010-03-17 18:14:10.000000000 +1300
++++ 2p-deploy/src/alice/util/ReadOnlyLinkedList.java	2012-01-15 09:32:03.000000000 +1300
+@@ -12,10 +12,10 @@
+ import java.util.ListIterator;
+ 
+ /**
+- * ReadOnlyLinkedList<E> encapsulate a {@link LinkedList<E>}
++ * ReadOnlyLinkedList<E> encapsulate a {@link LinkedList}
+  * and ensures that the given list is navigated only.
+  *
+- * Even if ReadOnlyLinkedList<E> implements {@link List<E>} it doesn't
++ * Even if ReadOnlyLinkedList<E> implements {@link List} it doesn't
+  * support modifiers methods, and throws {@link UnsupportedOperationException}
+  * if invoked.
+  *
 diff -ur 2p-deploy.orig/src/alice/util/jedit/InputHandler.java 2p-deploy/src/alice/util/jedit/InputHandler.java
 --- 2p-deploy.orig/src/alice/util/jedit/InputHandler.java	2010-01-21 21:29:24.000000000 +1300
-+++ 2p-deploy/src/alice/util/jedit/InputHandler.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/util/jedit/InputHandler.java	2012-01-15 09:20:48.000000000 +1300
 @@ -24,7 +24,7 @@
   *
   * @author Slava Pestov
@@ -147,7 +162,7 @@ diff -ur 2p-deploy.orig/src/alice/util/jedit/InputHandler.java 2p-deploy/src/ali
  	{
 diff -ur 2p-deploy.orig/src/alice/util/jedit/JEditTextArea.java 2p-deploy/src/alice/util/jedit/JEditTextArea.java
 --- 2p-deploy.orig/src/alice/util/jedit/JEditTextArea.java	2010-01-21 21:29:24.000000000 +1300
-+++ 2p-deploy/src/alice/util/jedit/JEditTextArea.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/util/jedit/JEditTextArea.java	2012-01-15 09:20:48.000000000 +1300
 @@ -1389,7 +1389,7 @@
  
  	/**
@@ -159,7 +174,7 @@ diff -ur 2p-deploy.orig/src/alice/util/jedit/JEditTextArea.java 2p-deploy/src/al
  	public final void setSelectionRectangular(boolean rectSelect)
 diff -ur 2p-deploy.orig/src/alice/util/jedit/KeywordMap.java 2p-deploy/src/alice/util/jedit/KeywordMap.java
 --- 2p-deploy.orig/src/alice/util/jedit/KeywordMap.java	2010-01-21 21:29:22.000000000 +1300
-+++ 2p-deploy/src/alice/util/jedit/KeywordMap.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/util/jedit/KeywordMap.java	2012-01-15 09:20:48.000000000 +1300
 @@ -75,7 +75,7 @@
  	/**
  	 * Adds a key-value mapping.
@@ -171,7 +186,7 @@ diff -ur 2p-deploy.orig/src/alice/util/jedit/KeywordMap.java 2p-deploy/src/alice
  	{
 diff -ur 2p-deploy.orig/src/alice/util/jedit/TextAreaPainter.java 2p-deploy/src/alice/util/jedit/TextAreaPainter.java
 --- 2p-deploy.orig/src/alice/util/jedit/TextAreaPainter.java	2010-01-21 21:29:24.000000000 +1300
-+++ 2p-deploy/src/alice/util/jedit/TextAreaPainter.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/util/jedit/TextAreaPainter.java	2012-01-15 09:20:48.000000000 +1300
 @@ -75,7 +75,7 @@
  	/**
  	 * Returns the syntax styles used to paint colorized text. Entry <i>n</i>
@@ -201,7 +216,7 @@ diff -ur 2p-deploy.orig/src/alice/util/jedit/TextAreaPainter.java 2p-deploy/src/
  	{
 diff -ur 2p-deploy.orig/src/alice/util/jedit/TokenMarker.java 2p-deploy/src/alice/util/jedit/TokenMarker.java
 --- 2p-deploy.orig/src/alice/util/jedit/TokenMarker.java	2010-01-21 21:29:22.000000000 +1300
-+++ 2p-deploy/src/alice/util/jedit/TokenMarker.java	2011-05-21 11:38:55.000000000 +1200
++++ 2p-deploy/src/alice/util/jedit/TokenMarker.java	2012-01-15 09:20:48.000000000 +1300
 @@ -24,7 +24,7 @@
   * @author Slava Pestov
   * @version $Id: TokenMarker.java,v 1.32 1999/12/13 03:40:30 sp Exp $