Command Assistant [PSARC/2008/772 FastTrack timeout 12/16/2008]

[chenpu]

Hi Mark,

Please see my comments inline.

Mark Martin 写道:
> Comments inline...
>
> On Mon, Dec 15, 2008 at 7:48 PM, Yong Young Sun
> <ys148558 at sac.sfbay.sun.com> wrote:
>   
> [snip]
>   
>>        Command Assistant has the ability to parse the actual contents, that
>>        means it knows,
>>           * which is "command"
>>           * which is "command descriptions"
>>           * which is "examples of command"
>>           * ....
>>
>>        The source(contents), that Command Assistant parsed/indexed, are not
>>        only the html files. Those html documents published on docs.sun.com
>>        were generated from SGML provided by IPG. Compare to the final html
>>        file, SGML can provides us more informations. Please see the SGML
>>        segment below,
>>     
>
> What content is being indexed?  
All the "command" and "user input" are indexed. You know Solairs book 
privides a lot of examples on how to use Solairs commands as I decribed 
above.
> docs.sun.com?
>   
The source files, which we used to generate index files, are not from 
docs.sun.com. They are SGML files.

Files(html/pdf) on docs.sun.com are compiled from SGML.
> [snip]
>   
>>    4.5. Interfaces:
>>         Client Interfaces: All of the following interfaces are marked
>>         as "Committed"
>>
>>         /usr/bin/commandassistant
>>         /usr/lib/commandassistant/CommnadAssistant.jar
>>         /usr/lib/commandassistant/lib/jaxb-api.jar
>>         /usr/lib/commandassistant/lib/sjsxp.jar
>>         /usr/lib/commandassistant/lib/jsr173_api.jar
>>         /usr/lib/commandassistant/lib/jaxws-api.jar
>>         /usr/lib/commandassistant/lib/jsr250-api.jar
>>         /usr/lib/commandassistant/lib/FastInfoset.jar
>>         /usr/lib/commandassistant/lib/jaxb-xjc.jar
>>         /usr/lib/commandassistant/lib/streambuffer.jar
>>         /usr/lib/commandassistant/lib/jaxws-rt.jar
>>         /usr/lib/commandassistant/lib/http.jar
>>         /usr/lib/commandassistant/lib/saaj-api.jar
>>         /usr/lib/commandassistant/lib/jsr181-api.jar
>>         /usr/lib/commandassistant/lib/jaxws-tools.jar
>>         /usr/lib/commandassistant/lib/saaj-impl.jar
>>         /usr/lib/commandassistant/lib/stax-ex.jar
>>         /usr/lib/commandassistant/lib/jaxb-impl.jar
>>         /usr/lib/commandassistant/lib/activation.jar
>>     
>
> Do you really want all of these committed?  I suspect you really want
> the "bin/commandassistant" interface as committed and the rest of
> those are project private.  I'll have to research further, but I
> suspect there may be some duplication going on in those support jars.
> Would you mind showing the command interface to /bin/commandassistant
> or explain what is output?
>   
Command Assistant is a java GUI program. So there is no ouput for this 
command. And /bin/comandassistant is a warper of executing 
lib/commandassistant/CommnadAssistant.jar .

And you are right, seems it's not good to include all of J2EE Web 
Service related jar files under /usr/lib/commandassistant/lib/ 
directory. But problem is there is no existing separated package from it.
>
>   
>>         WebServices Interface: "Committed"
>>         http://ww.opensolaris.org/commandassistant/service?wsdl
>>     
>
> Is the service endpoint configurable?
>   
Yes.
> [snip]
>   
>>    4.10. Packaging & Delivery:
>>
>>        SERVER SIDE COMPONENTS         VERSION   LICENSE TERMS
>>        -----------------------------------------------------------
>>        Assistant Tool Web Service     1.0.0     CDDL
>>        Apache Lucene 2.4.0            2.4.0     Apache LicenseV2.0
>>
>>        Server side components will be hosted on OpenSolaris.org.
>>        CommandAssistantWebService.war
>>
>>        CLIENT SIDE COMPONENTS         VERSION   LICENSE TERMS
>>        -----------------------------------------------------------
>>        Assistant Tool Client          1.0.0     CDDL
>>
>>        Client side components will be shipped with OpenSolairs in
>>        OpenSolairs package repository.
>>     
>
> And SysV packaging too?
>   
Actually we just consider to support OpenSolaris(package repository).

Thanks.

Regards,
Jeffrey