You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@cloudstack.apache.org by "Paul Angus (JIRA)" <ji...@apache.org> on 2014/02/03 14:22:08 UTC

[jira] [Created] (CLOUDSTACK-6012) Error "Please specify input file(s) separated by coma using -f option" when creatign API documentation using build-apidoc.sh

Paul Angus created CLOUDSTACK-6012:
--------------------------------------

             Summary: Error "Please specify input file(s) separated by coma using -f option" when creatign API documentation using build-apidoc.sh
                 Key: CLOUDSTACK-6012
                 URL: https://issues.apache.org/jira/browse/CLOUDSTACK-6012
             Project: CloudStack
          Issue Type: Bug
      Security Level: Public (Anyone can view this level - this is the default.)
          Components: Doc
    Affects Versions: 4.2.0, Future
            Reporter: Paul Angus
            Priority: Minor


full build of cloudstack using

mvn -Dnoredist install

and then run

./build-apidoc.sh "/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib" "/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib" "/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib"

>From ../tools/apidoc/

I get an error "Please specify input file(s) separated by coma using -f option":

[root@localhost apidoc]# ./build-apidoc.sh "/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib" "/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib" "/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib"
2014-02-02 19:05:03,370{GMT} DEBUG [org.reflections.Reflections] (main:) going to scan these urls:
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-dedicated-resources-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-api-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-hypervisor-vmware-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-user-authenticator-ldap-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-hypervisor-baremetal-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-network-ssp-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-api-discovery-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-api-limit-account-based-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-hypervisor-ucs-4.3.0.jar!/

2014-02-02 19:05:04,047{GMT} INFO  [org.reflections.Reflections] (main:) Reflections took 669 ms to scan 9 urls, producing 35 keys and 1151 values
2014-02-02 19:05:04,415{GMT} DEBUG [org.reflections.Reflections] (main:) going to scan these urls:
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-api-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-network-nvp-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-network-cisco-vnmc-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-server-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-hypervisor-vmware-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-network-vns-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-network-netscaler-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-network-palo-alto-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-network-srx-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-netapp-4.3.0.jar!/
        jar:file:/usr/local/cloudstack/dist/rpmbuild/BUILD/cloudstack-4.3.0/client/target/cloud-client-ui-4.3.0/WEB-INF/lib/cloud-plugin-network-f5-4.3.0.jar!/

2014-02-02 19:05:04,563{GMT} INFO  [org.reflections.Reflections] (main:) Reflections took 147 ms to scan 11 urls, producing 56 keys and 356 values
Please specify input file(s) separated by coma using -f option

This seems to relate to the line:

java -cp $CP$PATHSEP$TARGETJARDIR/*$PATHSEP$DEPSDIR/* com.cloud.api.doc.ApiXmlDocWriter -d "$DISTDIR" $*

in build-apidoc.sh

Its the $DISTDIR causing the problem:

Code in /usr/local/cloudstack/server/src/com/cloud/api/doc/ApiXmlDocWriter:


        LinkedProperties preProcessedCommands = new LinkedProperties();
        String[] fileNames = null;

        List<String> argsList = Arrays.asList(args);
        Iterator<String> iter = argsList.iterator();
        while (iter.hasNext()) {
            String arg = iter.next();
            // populate the file names
            if (arg.equals("-f")) {
                fileNames = iter.next().split(",");
            }
            if (arg.equals("-d")) {
                dirName = iter.next();
            }
        }

        if ((fileNames == null) || (fileNames.length == 0)) {
            System.out.println("Please specify input file(s) separated by coma using -f option");
            System.exit(2);
        }

There seems to be some enumeration of the files in the directory missing?




--
This message was sent by Atlassian JIRA
(v6.1.5#6160)