From: Jason Stephenson Date: Sun, 17 Aug 2014 15:26:09 +0000 (-0400) Subject: Change comments to POD in NCIP::Response module. X-Git-Url: https://old-git.evergreen-ils.org/?a=commitdiff_plain;h=59d42ef551932ac487a4f3f42f286877b4008120;p=working%2FNCIPServer.git Change comments to POD in NCIP::Response module. Signed-off-by: Jason Stephenson --- diff --git a/lib/NCIP/Response.pm b/lib/NCIP/Response.pm index 00c9266..f9f2764 100644 --- a/lib/NCIP/Response.pm +++ b/lib/NCIP/Response.pm @@ -19,27 +19,49 @@ package NCIP::Response; use parent qw(Class::Accessor); -# This is the Response object to be returned by the ILS' handlers. -# The fields are: -# -# type: A string representing the name of the response this is usually -# the initiation message name with Response tacked on, i.e. -# LookupUserResponse, etc. This value is used to lookup the -# appropriate template include for formatting the response message to -# the initiator. -# -# data: This is an object or struct with the response data for a -# successful result. It's value and needs vary by message type. -# -# problem: If the response is reporting a problem, this should point -# to a NCIP::Problem object to be used in the problem template. -# -# header: A NCIP::Header object for the optional ResponseHeader in the -# response template. +=head1 NAME + +Response - Response object to be returned from ILS' handlers. + +=head1 SYNOPSIS + + + +=head1 DESCRIPTION + +This is the Response object to be returned by the ILS' handlers. + +=head1 FIELDS + +Presently, only one data or problem object is supported. If one is +supplied the other must be left undefined/unset. Only 1 header is +supported, but it is entirely optional according to the standard. + +=head2 type + +A string representing the name of the response this is usually the +initiation message name with Response tacked on, i.e. +LookupUserResponse, etc. This value is used to lookup the appropriate +template for formatting the response message to the initiator. + +=head2 data + +This is an object or struct with the response data for a successful +result. It's value and needs vary by message type. + +=head2 problem + +If the response is reporting a problem, this should point to a +NCIP::Problem object to be used in the problem template. + +=head2 header + +A NCIP::Header object for the optional ResponseHeader in the response +template. + + +=cut -# Presently, only one data or problem object is supported. If one is -# supplied the other must be left undefined/unset. Only 1 header is -# supported, but it is entirely optional according to the standard. NCIP::Response->mk_accessors(qw(type data problem header));