🚀 go-pugleaf

On 11/14/2004 at 12:26:11 PM, G Hornet wrote:

> Does nayone know how to have JBuilder 2005 recognize the 5.0
> documentation?

It should do so for most functions.  If you have a JDK properly configured
(Tools | Configure | JDKs), and you press F1 when the cursor is on a class
or other identifier name, JBuilder will show the help for that name in the
help viewer from the project's current JDK.  Also, if you navigate to a
class and switch to the Doc tab in the content pane, it will show the
documentation for that class.  This does not affect the help available
from the "Help" menu.  As far as I know, there is no way to change that.

-- 
Regards,

John McGrath [TeamB]

---------------------------------------------------
Before sending me e-mail, please read:
    http://www.JPMcGrath.net/newsgroups/e-mail.html

The Java 5 API doc package breaks the JBuilder help viewer (F1 help) for
many classes.

Example:


Cannot parse file
URL:vfs:///zip:///[D:/java/jdk1.5.0_01/jdk-1_5_0-doc.zip]/docs/api/javax/swi
ng/JTable.html

Cannot load or parse the file

Parsing problem

On 1/26/2005 at 5:41:05 PM, M Evan Clark wrote:

> The Java 5 API doc package breaks the JBuilder help viewer (F1 help) for
> many classes.

Yes, I see that.  Although it looks like it is more appropriate to say
that the Java 5 API docs are broken.  If you look at the source of the API
docs, you will find that sometimes when templated classes are referenced,
the doc file contains the string '<?>', which AFAIK is not valid HTML.
Take the JTable JavaDoc that you mentioned.  It contains the text:

    <CODE>getDefaultRenderer(java.lang.Class<?>)</CODE>

This should be:

    <CODE>getDefaultRenderer(java.lang.Class&lt;?&gt;)</CODE>

FYI, I found a total of 43 occurrences of the string '<?>' in the
following files:

    api/java/beans/DefaultPersistenceDelegate.html
    api/java/beans/Encoder.html
    api/java/beans/Introspector.html
    api/java/beans/XMLEncoder.html
    api/java/lang/instrument/IllegalClassFormatException.html
    api/java/lang/reflect/Member.html
    api/java/security/cert/X509CertSelector.html
    api/java/security/cert/X509CRLSelector.html
    api/java/sql/Connection.html
    api/java/util/EnumSet.html
    api/javax/sql/RowSet.html
    api/javax/swing/JTable.html
    api/javax/swing/plaf/synth/package-summary.html
    api/javax/swing/plaf/synth/SynthLookAndFeel.html
    api/javax/swing/SpinnerListModel.html
    api/javax/swing/table/TableColumn.html
    api/javax/swing/text/AbstractDocument.AbstractElement.html
    api/javax/swing/text/AbstractDocument.AttributeContext.html
    api/javax/swing/text/html/StyleSheet.html
    api/javax/swing/text/InternationalFormatter.html
    api/javax/swing/text/NumberFormatter.html
    api/javax/swing/text/StyleContext.html
    api/javax/swing/text/StyleContext.NamedStyle.html

-- 
Regards,

John McGrath [TeamB]

---------------------------------------------------
Before sending me e-mail, please read:
    http://www.JPMcGrath.net/newsgroups/e-mail.html

I wrote a script to fix the 1.5 JavaDocs, and JBuilder now displays them
without any problems.

In case you are interested, here is the script.  This was run on a Windows
system using the CygWin toolkit.  I think it should run with any Bourne
compatible shell, such as bash.

   # Change occurrences of the string '<?>' to '&lt;?&gt;' in HTML files

   TmpFile="$TEMP/JavaDocFix$$"

   find . -name '*.htm*' | xargs grep -l '<?>' \
      | while read file ; do
         echo "$file"
         sed 's/<?>/\&lt;?\&gt;/g' < "$file" > "$TmpFile" \
            && mv "$TmpFile" $file
   done

-- 
Regards,

John McGrath [TeamB]

---------------------------------------------------
Before sending me e-mail, please read:
    http://www.JPMcGrath.net/newsgroups/e-mail.html

John,

Thanks!

I noticed this errant question mark as well, but I was too lazy to
investigate ;-)  I've made the changes to my local copy of the API and
things are working much better now.

Ciao,
Mike