[Bug libgcj/32028] Make fails at gjdoc - gnu.classpath.tools.gjdoc.ParseException: unmatched input in line 1: @Retention(SOURCE) @Target(METHOD)

["rob1weld at aol dot com" <gcc-bugzilla@gcc.gnu.org>]

------- Comment #3 from rob1weld at aol dot com  2007-05-25 09:55 -------
Ran accros this interesting post, seems we've had this a while ...

gjdoc in libgcj
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=19612


After some messing with trying to access the gjdoc SVN according to the above
advice from those links (without a password); I went elsehere.


Here are some programs I had already (from gcc 4.2.0 install);

# gcj --version
gcj (GCC) 4.2.0 20070501 (prerelease)
# gij --version
java version "1.4.2"
gij (GNU libgcj) version 4.2.0 20070501 (prerelease)


Here is what worked and what it looked like:


# wget ftp://ftp.gnu.org/gnu/classpath/gjdoc-0.7.8.tar.gz
# gunzip -d gjdoc-0.7.8.tar.gz
# tar -xf gjdoc-0.7.8.tar.gz
# cd gjdoc-0.7.8
# ./configure
...
checking if gij works... yes
checking for gcj... gcj -C
checking if gcj -C works... yes
configure: WARNING:
The build seems to be using gcj for bytecode generation.  Some
versions of gcj are known to produce bad bytecode.  See here for a
list of bugs that may be relevant:

http://gcc.gnu.org/bugzilla/buglist.cgi?component=java&keywords=wrong-code&order=default

At least bug 19921 is known to affect gjdoc (in Feb 2005).

You may want to set the environment variable JAVAC to an alternate
compiler, such as jikes, to make sure that you end up with valid
bytecode.
...
checking for antlr 2.7.1 or better... 2.7.6
checking for java.util.regex.Pattern class... yes
configure: creating ./config.status
config.status: creating gjdoc.sh
config.status: WARNING:  gjdoc.sh.in seems to ignore the --datarootdir setting
# make
# make install

works OK despite warnings.



Now getting this screen output:

make[4]: Leaving directory
`/opt/gcc-4_3-build/i686-pc-linux-gnu/libjava/classpath/lib'
Making all in doc
make[4]: Entering directory
`/opt/gcc-4_3-build/i686-pc-linux-gnu/libjava/classpath/doc'
Making all in api
make[5]: Entering directory
`/opt/gcc-4_3-build/i686-pc-linux-gnu/libjava/classpath/doc/api'
/bin/mkdir html > /dev/null 2>&1
/usr/local/bin/gjdoc \
        -use \
        -sourcepath
"../..:/root/downloads/gcc-4_3-trunk/libjava/classpath:/root/downloads/gcc-4_3-trunk/libjava/classpath/vm/reference:/root/downloads/gcc-4_3-trunk/libjava/classpath/external/w3c_dom:/root/downloads/gcc-4_3-trunk/libjava/classpath/external/sax"
\
        -encoding UTF-8 \
        -breakiterator \
        -licensetext \
        -linksource \
        -splitindex \
        -validhtml \
        -d html \
        -doctitle "GNU Classpath 0.94-pre" \
        -windowtitle "GNU Classpath 0.94-pre Documentation" \
        -header "<span class='logo'><a
href='http://www.gnu.org/software/classpath' target='_top'>GNU Classpath</a>
(0.94-pre)" -footer "<span class='logo'><a
href='http://www.gnu.org/software/classpath' target='_top'>GNU Classpath</a>
(0.94-pre)" \
        -subpackages java:javax:org
WARNING: unknown modifier '@Retention(SOURCE)'
WARNING: unknown modifier '@Target(METHOD)'
WARNING: unknown modifier '@Retention(SOURCE)'
WARNING: unknown modifier '@Target({TYPE, FIELD, METHOD, PARAMETER,
CONSTRUCTOR, LOCAL_VARIABLE})'
WARNING: unknown modifier '@Documented'
WARNING: unknown modifier '@Retention(RUNTIME)'
ARGH! public
ARGH! static
ARGH! <S
ARGH! extends
ARGH! Enum<S>>
ARGH! S
ARGH! valueOf(Class<S>
ARGH! String
ARGH! s)
Loading classes for package java.sql...
Loading classes for package java.lang...
Loading classes for package java.lang.reflect...
Loading classes for package java.lang.instrument...
Loading classes for package java.lang.ref...
Loading classes for package java.lang.annotation...
WARNING: unknown modifier '@Documented'
WARNING: unknown modifier '@Retention(RUNTIME)'
WARNING: unknown modifier '@Target(ANNOTATION_TYPE)'
WARNING: unknown modifier '@Documented'
WARNING: unknown modifier '@Retention(RUNTIME)'
WARNING: unknown modifier '@Documented'
WARNING: unknown modifier '@Retention(RUNTIME)'
WARNING: unknown modifier '@Target(ANNOTATION_TYPE)'
WARNING: unknown modifier '@Documented'
WARNING: unknown modifier '@Retention(RUNTIME)'
WARNING: unknown modifier '@Target(ANNOTATION_TYPE)'
Loading classes for package java.lang.management...
Loading classes for package java.text...
Loading classes for package java.applet...
Loading classes for package java.nio...
Loading classes for package java.nio.charset...


According to some web pages those errors are to be expected.

Which version _should_ we use so that we don't get any warnings or errors?


The "fix" for this bug is that gcc 4.2.0 and 4.2.1 main configure MUST test for
gjdoc version 0.7.7 _minimum_ and gcc 4.3.0 main configure MUST test for gjdoc
0.7.8 _minimum (a newer version, it easily available would be better).

A version that worked properly in directory ftp://ftp.gnu.org/gnu/classpath/
would be a good idea. Would you be allowed to do that Tom?

Thanks


-- 


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=32028