refactor: refs #6499 Added comments

db/routines/vn/procedures/balanceNestTree_addChild.sql

@@ -1,9 +1,16 @@
 DELIMITER $$
 CREATE OR REPLACE DEFINER=`root`@`localhost` PROCEDURE `vn`.`balanceNestTree_addChild`(
-	vSelfFather INT,
+	vSelf INT,
 	vName VARCHAR(45)
 )
 BEGIN
+/**
+ * Agrega u nuevo nodo hijo a un nodo existente dentro de la estructura
+ * de árbol de vn.balanceNestTree.
+ *
+ * @param vSelf Identificador del nodo
+ * @param vName Nombre del nuevo nodo hijo
+ */
 	DECLARE vTable VARCHAR(45) DEFAULT util.quoteIdentifier('balanceNestTree');
 	DECLARE vLeft INT;
 
@@ -15,7 +22,7 @@ BEGIN
 			SET lft = (SELECT lft 
 				FROM ', vTable, 
 				' WHERE id = ?)')
-		USING vSelfFather;
+		USING vSelf;
 	
 	SELECT lft INTO vLeft FROM tAux;
 

db/routines/vn/procedures/balanceNestTree_delete.sql

@@ -3,6 +3,11 @@ CREATE OR REPLACE DEFINER=`root`@`localhost` PROCEDURE `vn`.`balanceNestTree_del
     vSelf INT
 )
 BEGIN
+/**
+ * Elimina un nodo dentro de la estructura de árbol de vn.balanceNestTree.
+ *
+ * @param vSelf Identificador del nodo
+ */
 	DECLARE vTable VARCHAR(45) DEFAULT util.quoteIdentifier('balanceNestTree');
 	DECLARE vRight INT;
 	DECLARE vLeft INT;

db/routines/vn/procedures/balanceNestTree_move.sql

@@ -1,9 +1,15 @@
 DELIMITER $$
 CREATE OR REPLACE DEFINER=`root`@`localhost` PROCEDURE `vn`.`balanceNestTree_move`(
-	vSelfNode INT,
+	vSelf INT,
 	vSelfFather INT
 )
 BEGIN
+/**
+ * Mueve un nodo dentro de la estructura de árbol de vn.balanceNestTree.
+ *
+ * @param vSelf Identificador del nodo
+ * @param vSelfFather Identificador del nuevo padre del nodo
+ */
 	DECLARE vTable VARCHAR(45) DEFAULT util.quoteIdentifier('balanceNestTree');
 	DECLARE vRight INT;
 	DECLARE vLeft INT;
@@ -21,7 +27,7 @@ BEGIN
 				JOIN ', vTable, ' t 
 			SET a.wdt = t.rgt - t.lft + 1
 			WHERE t.id = ?')
-		USING vSelfNode;
+		USING vSelf;
 
 	-- Averiguamos la posicion del nuevo padre
 	EXECUTE IMMEDIATE CONCAT(
@@ -62,7 +68,7 @@ BEGIN
 			SET a.rgt = t.rgt, 
 				a.lft = t.lft 
 			WHERE t.id = ?')
-		USING vSelfNode;
+		USING vSelf;
 
 	SELECT lft, rgt, frg - lft
 		INTO vLeft, vRight, vGap 

db/routines/vn/procedures/pay.sql

@@ -11,6 +11,20 @@ CREATE OR REPLACE DEFINER=`root`@`localhost` PROCEDURE `vn`.`pay`(
 	vConcept VARCHAR(40),
 	vCompanyFk INT)
 BEGIN
+/**
+ * Registra un pago realizado a un proveedor.
+ *
+ * @param vDated Fecha del pago
+ * @param vSupplierFk Id del proveedor
+ * @param vAmount Cantidad a pagar
+ * @param vCurrencyFk Id de la moneda
+ * @param vDivisa Tipo de cambio utilizado
+ * @param vBankFk Id del banco
+ * @param vPayMethodFk Id del método de pago
+ * @param vExpenseFk Id de gasto
+ * @param vConcept Concepto del pago
+ * @param vCompanyFk Id de la empresa
+ */
 	INSERT INTO till(
 			concept,
 			serie,