     //-------------------------------------------------------------------------
 
     /**
-     * Returns a Boolean value that indicates whether the WebService ready to
+     * Returns a Boolean value that indicates whether the WebService is ready to
      * load a WSDL (does it have a valid destination or wsdl specified).
+     *
+     * @return Returns <code>true</code> if the WebService is ready to load a WSDL;
+     * otherwise, returns <code>false</code>.
      */
     public function canLoadWSDL():Boolean
     {

     * Creates a new WebService.  The destination, if specified, should match
     * an entry in services-config.xml.  If unspecified, the WebService uses
     * the DefaultHTTP destination. The <code>rootURL</code> is required if you
     * intend to use a relative URL find the WSDL document for this WebService.
     */
    public function WebService(destination:String = null, rootURL:String = null)
    {

     * Represents an instance of WebService as a String, describing
     * important properties such as the destination id and the set of
     * channels assigned.
     *
     * @return Returns a String representation of the WebService.
     */
    public function toString():String
    {
