Hi Mr. Berkema,
I had some questions in PSI spec (July 21, 2004).
So could you give me answers ?
--------------------------------------------------------------------
P.57
5.6.2 FetchNextJob
Returns: sendJobNotifications : JobEvents
'A collection of Job Events as defined by the JobEvents element
in the Semantic Model [PWG5105.1] Events.xsd.'
'FetchNextJob' is for a single Job. Because the return of this method
'jobURI' indicates a sigle job. But the description of the return
is 'A collection of Job Events ...' to explain that there is not a
SINGLE job, but are plural jobs.
I think a 'collection' does not exist. If a 'collection' exists,
that is not a collection of job events ('events' is a plural form),
but of job event. ('event' is a singular form.)
(The type 'JobEvents' is defined like a collection of Job Event in
'Events.xsd'.)
So I think it is good 'A jobEvents element of type JobEvents as defined
by the Semantic Model [PWG5105.1] Events.xsd' in that description.
--------------------------------------------------------------------
P.60
5.6.4 FetchNextDocumentByPull
Returns: sendDocumentNotifications : DocumentEvents
'A collection of Document Events as defined by the DocumentEvents
element in Semantic Model [PWG5105.1] Events.xsd.'
'FetchNextDocumentByPull' is for a single Document.
If this single method deals with plural documents, how a document
can be correspond to its event in a collection of document events ?
I think a 'collection' does not exist. If a 'collection' exists,
that is not a collection of document events ('events' is a plural form),
but of document event. ('event' is a singular form.)
(The type 'DocumentEvents' is defined like a collection of Document
Event in 'Events.xsd'.)
So I think it is good 'A DocumentEvents element of type DocumentEvents
as defined by the Semantic Model [PWG5105.1] Events.xsd' in that
description.
--------------------------------------------------------------------
P.62
5.6.6 FetchNextDocumentByValue
Returns: sendDocumentNotifications : DocumentEvents
'A collection of Document Events as defined by the DocumentEvents
element in Semantic Model [PWG5105.1] Events.xsd.'
Same as '5.6.4 FetchNextDocumentByPull' .
--------------------------------------------------------------------
P.82
7.4 InterfaceIdentifier
Line 30
<xsd:element name="InterfaceIdentifier" type="intf:InterfaceIdentifier"/>
The first character of element name 'InterfaceIdentifier' is a small letter.
See '5.3.3 QueryInterfaceDefinition' (P.22) or '5.3.2 QuerySupportedInterfaces'
(P.21). ( 'QuerySupportedInterfaces' has plural form of 'interfaceIdentifier',
'interfaceIdentifiers' .)
--------------------------------------------------------------------
Some figures of method sequence example have mistakes.
Those are in parameters or returns of methods.
Fig. 5, 7, 8, 9, 10, 12
--------------------------------------------------------------------
Comments ?
Cheers,
Masa.
-----------------------
Masanonri 'MASA' Itoh
RICOH Co., Ltd. Software R&D Center
Mr. Berkema, Alan C (R&D Roseville) wrote on Thu, 22 Jul 2004 14:09:37 -0700
------------------------------------------------------------------------
All,
Here are the files, thanks to Ira, Jerry, and Dave!
The last call review process begins on 07/23/2004 and will end on
08/16/2004.
We will accept e-mail comments during this time period on the psi
reflector.
ftp://ftp.pwg.org/pub/pwg/ps/wd/wd-psi10-20040721.pdf (and .doc)
ftp://ftp.pwg.org/pub/pwg/ps/wd/wd-psi10-20040721-rev.pdf (and .doc)
Also the events Schema
ftp://ftp.pwg.org/pub/pwg/ps/schemas/events-20040721.xsd
Last Call Comment resolution meeting tbd at F2F?
Thanks,
Alan Berkema
This archive was generated by hypermail 2b29 : Mon Aug 02 2004 - 09:07:37 EDT