You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by "Carlos Sanchez (JIRA)" <ji...@codehaus.org> on 2005/11/01 23:39:45 UTC

[jira] Closed: (MNG-1386) Failure to launch Javadoc correctly

     [ http://jira.codehaus.org/browse/MNG-1386?page=all ]
     
Carlos Sanchez closed MNG-1386:
-------------------------------

     Assign To: Carlos Sanchez
    Resolution: Duplicate

> Failure to launch Javadoc correctly
> -----------------------------------
>
>          Key: MNG-1386
>          URL: http://jira.codehaus.org/browse/MNG-1386
>      Project: Maven 2
>         Type: Bug
>   Components: maven-javadoc-plugin
>     Versions: 2.0
>  Environment: Windows XP Professional
>     Reporter: Peter Pilgrim
>     Assignee: Carlos Sanchez
>      Fix For: 2.0

>
>
> Running from the DOS command 
> % mvn javadoc:javadoc
> Produces
> [INFO] [javadoc:javadoc]
> [INFO] C:\opt\j2sdk1.4.2_04\jre\..\bin\javadoc.exe @options @files
> usage: javadoc [options] [packagenames] [sourcefiles] [classnames] [@files]
> -overview <file>          Read overview documentation from HTML file
> -public                   Show only public classes and members
> -protected                Show protected/public classes and members (default)
> -package                  Show package/protected/public classes and members
> -private                  Show all classes and members
> -help                     Display command line options and exit
> -doclet <class>           Generate output via alternate doclet
> -docletpath <path>        Specify where to find doclet class files
> -sourcepath <pathlist>    Specify where to find source files
> -classpath <pathlist>     Specify where to find user class files
> -exclude <pkglist>        Specify a list of packages to exclude
> -subpackages <subpkglist> Specify subpackages to recursively load
> -breakiterator            Compute 1st sentence with BreakIterator
> -bootclasspath <pathlist> Override location of class files loaded
>                           by the bootstrap class loader
> -source <release>         Provide source compatibility with specified release
> -extdirs <dirlist>        Override location of installed extensions
> -verbose                  Output messages about what Javadoc is doing
> -locale <name>            Locale to be used, e.g. en_US or en_US_WIN
> -encoding <name>          Source file encoding name
> -J<flag>                  Pass <flag> directly to the runtime system
> Provided by Standard doclet:
> -d <directory>                    Destination directory for output files
> -use                              Create class and package usage pages
> -version                          Include @version paragraphs
> -author                           Include @author paragraphs
> -docfilessubdirs                  Recursively copy doc-file subdirectories
> -splitindex                       Split index into one file per letter
> -windowtitle <text>               Browser window title for the documenation
> -doctitle <html-code>             Include title for the overview page
> -header <html-code>               Include header text for each page
> -footer <html-code>               Include footer text for each page
> -bottom <html-code>               Include bottom text for each page
> -link <url>                       Create links to javadoc output at <url>
> -linkoffline <url> <url2>         Link to docs at <url> using package list at <u
> rl2>
> -excludedocfilessubdir <name1>:.. Exclude any doc-files subdirectories with give
> n name.
> -group <name> <p1>:<p2>..         Group specified packages together in overview
> page
> -nocomment                        Supress description and tags, generate only de
> clarations.
> -nodeprecated                     Do not include @deprecated information
> -noqualifier <name1>:<name2>:...  Exclude the list of qualifiers from the output
> .
> -nosince                          Do not include @since information
> -nodeprecatedlist                 Do not generate deprecated list
> -notree                           Do not generate class hierarchy
> -noindex                          Do not generate index
> -nohelp                           Do not generate help link
> -nonavbar                         Do not generate navigation bar
> -quiet                            Do not display status messages to screen
> -serialwarn                       Generate warning about @serial tag
> -tag <name>:<locations>:<header>  Specify single argument custom tags
> -taglet                           The fully qualified name of Taglet to register
> -tagletpath                       The path to Taglets
> -charset <charset>                Charset for cross-platform viewing of generate
> d documentation.
> -helpfile <file>                  Include file that help link links to
> -linksource                       Generate source in HTML
> -stylesheetfile <path>            File to change style of the generated document
> ation
> -docencoding <name>               Output encoding name
> 1 error
> [INFO] -------------------------------------------------------------------------
> ---
> [ERROR] BUILD ERROR
> [INFO] -------------------------------------------------------------------------
> ---
> [INFO] An error has occurred in JavaDocs report generation.
> Embedded error: Exit code: 1 - javadoc: invalid flag: -J-Xmx512m
> [INFO] -------------------------------------------------------------------------
> ---
> [INFO] For more information, run Maven with the -e switch
> [INFO] -------------------------------------------------------------------------
> ---
> [INFO] Total time: 11 seconds
> [INFO] Finished at: Tue Nov 01 17:13:01 GMT 2005
> [INFO] Final Memory: 3M/6M
> [INFO] -------------------------------------------------------------------------
> ---
> Here is my the relevant extract of my pom.xml if that helps
> <project ... >
>    ...
>   <build>
>     ....
>     <plugins>
>             <plugin>
>                 <groupId>org.apache.maven.plugins</groupId>
>                 <artifactId>maven-javadoc-plugin</artifactId>
>                 <configuration>
>                     <minmemory>128m</minmemory>
>                     <maxmemory>512m</maxmemory>
>                     <breakiterator>true</breakiterator>
>                     <minmemory>128m</minmemory>
>                     <maxmemory>512</maxmemory>
>                     <bottom>Copyright me</bottom>
>                     <source>true</source>
>                     <link>
>                         http://java.sun.com/j2se/1.4.2/docs/api,
>                         http://maven.apache.org/apidocs/
>                     </link>
>                     <group>
>                         "Core Packages"
>                         "org.apache.maven.plugin.javadoc.test1",
>                         "Extension Packages"
>                         "org.apache.maven.plugin.javadoc.test2"
>                     </group>
>                     <bottom>Copyright me</bottom>
>                     <source>true</source>
>                     <link>
>                         http://java.sun.com/j2se/1.4.2/docs/api,
>                         http://maven.apache.org/apidocs/
>                     </link>
>                     <tag>
>                         .usage:a:Usage:, .todo:a:To do something:,
>                         .fixme:a:Fixme:
>                     </tag>
>                     <group>
>                         "Service-Oriented Architecture"
>                         "com.xenonsoft.bridgetown.soa"
>                         "com.xenonsoft.bridgetown.soa.config"
>                         "com.xenonsoft.bridgetown.soa.impl"
>                         "com.xenonsoft.bridgetown.soa.spi",
>                         "Service-Oriented Architecture Access"
>                         "com.xenonsoft.bridgetown.soa.access",
>                         "Resources &amp; Loaders"
>                         "com.xenonsoft.bridgetown.resources*"
>                         "com.xenonsoft.bridgetown.context*",
>                         "AOP Support" "com.xenonsoft.bridgetown.aop*",
>                         "Application Support"
>                         "com.xenonsoft.bridgetown.app*",
>                         "Examples" "com.xenonsoft.bridgetown.examples*",
>                         "Unit Test &amp; Verification"
>                         "com.xenonsoft.bridgetown.test*"
>                     </group>
>                 </configuration>
>             </plugin>
>        </plugins>
>     </build>
> ...
> </project>
> HTH
> Peter P

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org