refactor documentation

process/PostalAddress_lib/process.js

@@ -98,23 +98,45 @@ AddressUtils.getLetterSalutation = function() {
  */
 function AddressValidationUtils(){}
 
+/**
+ * loads COUNTRYINFO.REQUIRED_FIELDS from db
+ * 
+ * @param {String} countryCode
+ * 
+ * @return {String} A string containing all mandatory fieldCodes
+ *   
+ * @ignore
+ */
 AddressValidationUtils._getRequiredFields = function(countryCode)
 {
     if (!countryCode)
         return "";
-    var cond = new SqlCondition();
-    cond.andPrepare("COUNTRYINFO.ISO2", countryCode );
-    var stmt = cond.buildSelect("select COUNTRYINFO.REQUIRED_FIELDS from COUNTRYINFO");
-    var requiredFields = db.cell(stmt);
+    var requiredFields = db.cell(SqlCondition.begin().andPrepare("COUNTRYINFO.ISO2", countryCode)
+                                                     .buildSelect("select COUNTRYINFO.REQUIRED_FIELDS from COUNTRYINFO"));
     return requiredFields;
 };
 
+/**
+ * check if the requested field is a mandatory field
+ * 
+ * @param {String} countryCode
+ * @param {String} fieldCode
+ * 
+ * @return {Boolean}
+ */
 AddressValidationUtils.isMandatoryField = function(countryCode, fieldCode)
 {
     var requiredFields = this._getRequiredFields(countryCode);
     return requiredFields == "" || requiredFields.search(fieldCode) != -1;
 };
 
+/**
+ * load the regexp for zip validation from the database
+ * 
+ * @param {String} countryCode
+ * 
+ * @return {String} the regexp
+ */
 AddressValidationUtils._getZipValidationRegEx = function(countryCode)
 {
     if (!countryCode)
@@ -125,6 +147,14 @@ AddressValidationUtils._getZipValidationRegEx = function(countryCode)
     return db.cell(stmt);
 };
 
+/**
+ * check if the zip code is valid
+ * 
+ * @param {String} countryCode
+ * @param {String} zipCode
+ * 
+ * return {Boolean}
+ */
 AddressValidationUtils.isValidZip = function(countryCode, zipCode)
 {
     if (zipCode == "")