[SAGA-RG] Emailing: saga_sd.dvi

[Andre Merzky]

Quoting [Fisher, SM (Steve)] (Mar 06 2008):
> 
> > That would keep it consistent with the detailed spec, where
> > you list only the long version (and rightly so).
> 
> Where is this desribed please. I have been looking at
> https://computation.llnl.gov/casc/components/docs/users_guide/

Section 2.2.2 of the SAGA Core Spec:

  2.2.2 Default Parameter Values
  
  This document, in several places, adds default values in
  the SIDL part of the API specification. It is up to the
  language bindings to exploit any native means for default
  parameter values. If this is not possible, the language
  binding CAN abstain from default parameter values. Also,
  if asynchronous method calls require additional
  parameters, which might affect the handling of default
  parameters in languages such as C and C++, the language
  binding CAN deviate from this document in that respect.

So it would be up to the language binding really how that is
interpreted.

However, I see what you are saying with the default
parameter versus the ommitted parameter.  My wrong, I think
we discussed this before.  So I think its fine as is, but
you may want to add the detailed description for the second
version then, like:

    - list_services
      Purpose:  return the set of services that pass the set of 
                specified filters, for the current session
      Format:   list_services   (in  string  service_filter,
                                 in  string  data_filter,
                                 out array<service_description> 
                                             services);
      Inputs:   service_filter:  filter on the basic service and 
                                 site attributes and on related 
                                 services
                data_filter:     filter on key/value pairs 
                                 associated with the service
      Outputs:  -
      Throws:   NotImplemented
                BadParameter
                AuthorizationFailed
                AuthenticationFailed
                NoSuccess
      Notes:    - the semantics is identical to the
                  overloaded list_services method from
                  above, but it creates the VO filter from
                  the VO attributes of the saga::contexts
                  instances attached to the current session.

Thanks, Andre.


> Where looking at the JAVACC grammar in
> https://computation.llnl.gov/casc/components/docs/users_guide/node351.ht
> ml
> 
> It says:
> 
> /**
>  * Parse a SIDL argument.  Arguments begin with an optional copy
> modifier
>  * followed by in, out, or inout followed by a type and a formal
> argument.
>  * The argument is returned on the top of the argument stack.  This
> routine
>  * also checks that the copy modifier is used only for symbol objects.
> For
>  * all other types, copy is redundant.
>  */
> Argument ::= [ <T_COPY> ] ( <T_IN> | <T_OUT> | <T_INOUT> ) 
> 	 (Type Identifier | Rarray)
> 
> 
> I want to make it quite clear in the spec that we are not saying that
> the vo_filter has a default value of "" - which is what this notation
> looks like for Python fans but that it can be omitted altogether!
> 
> Steve
> 
> > 
> > I think we agreed at OGF22 that we would not need another
> > call on the mailing list, as we seem to have group agreement
> > since quite some time.  So, yes, I think its good to go to
> > the Editor.
> > 
> > Thanks!!! :-))
> > 
> > Best, Andre.
> >                         
> > 
> > Quoting [Fisher, SM (Steve)] (Mar 06 2008):
> > > Subject: Emailing: saga_sd.dvi
> > > From: "Fisher, SM (Steve)" <S.M.Fisher at rl.ac.uk>
> > > To: Andre Merzky <andre at merzky.net>
> > > Cc: saga-rg at ggf.org
> > > 
> > >  <<saga_sd.dvi>> Andre,
> > > 
> > > At last I have made the requested changes to the SD spec. 
> > Does anybody
> > > object to it going for public comment now?
> > > 
> > > Steve
> > 
> > 
> > 
> > 
> > 
> > -- 
> > "We've got too much time to waste to stand around here doing things."
> >                                                              - Tigger
> > 



-- 
"We've got too much time to waste to stand around here doing things."
                                                             - Tigger