From 696c8879c26b2ee81c80635be82e2ddafa6aa66c Mon Sep 17 00:00:00 2001
From: Ricardo Dalinger <rdalinger@siu.edu.ar>
Date: Wed, 6 Dec 2023 17:28:15 -0300
Subject: [PATCH 1/3]  Cambios a docblocks

---
 php/consola/comandos/comando_base.php         |  2 +
 php/lib/registro/convertible_registro.php     |  3 +-
 php/lib/registro/toba_registro.php            | 10 +++--
 .../xml/toba_pers_xml_generador.php           |  3 +-
 .../toba_pers_xml_generador_componentes.php   |  9 ++---
 .../xml/toba_pers_xml_generador_tablas.php    |  2 -
 .../componentes/interface/efs/toba_ef.php     |  3 +-
 .../interface/efs/toba_ef_upload.php          |  3 +-
 .../componentes/interface/toba_ei_cuadro.php  | 12 +++---
 .../interface/toba_ei_cuadro_salida_html.php  | 11 +++---
 .../interface/toba_ei_cuadro_salida_pdf.php   |  8 ++--
 .../componentes/interface/toba_ei_firma.php   |  2 +-
 .../interface/toba_ei_formulario.php          |  3 +-
 .../componentes/interface/toba_ei_mapa.php    |  8 ++--
 php/nucleo/componentes/negocio/toba_cn.php    |  4 +-
 .../persistencia/toba_ap_tabla_db.php         |  4 +-
 .../persistencia/toba_datos_relacion.php      |  2 +-
 .../persistencia/toba_datos_tabla.php         | 12 ++++--
 php/nucleo/componentes/toba_cargador.php      |  2 +-
 php/nucleo/componentes/toba_componente.php    |  2 +-
 .../autenticacion/toba_autenticacion_ldap.php |  2 +-
 php/nucleo/lib/toba_instancia.php             |  2 +-
 php/nucleo/lib/toba_perfil_datos.php          | 12 +++---
 php/nucleo/lib/toba_proyecto.php              |  2 +-
 php/nucleo/lib/toba_puntos_control.php        | 38 +++++++++++++------
 php/nucleo/lib/toba_usuario_basico.php        |  5 ++-
 php/nucleo/lib/toba_vinculador.php            | 16 ++++----
 php/nucleo/toba_solicitud_web.php             |  2 +-
 28 files changed, 106 insertions(+), 78 deletions(-)

diff --git a/php/consola/comandos/comando_base.php b/php/consola/comandos/comando_base.php
index 5dac48272a..0d1c4e3e3e 100644
--- a/php/consola/comandos/comando_base.php
+++ b/php/consola/comandos/comando_base.php
@@ -5,7 +5,9 @@
  * Class comando_base.
  * @package consola
  */
+
 require_once('comando_toba.php');
+
 class comando_base extends comando_toba
 {
         /**
diff --git a/php/lib/registro/convertible_registro.php b/php/lib/registro/convertible_registro.php
index c765c01ceb..52c3f84d49 100644
--- a/php/lib/registro/convertible_registro.php
+++ b/php/lib/registro/convertible_registro.php
@@ -1,8 +1,7 @@
 <?php
-/* 
+/**
  * Si una clase implementa esta interfaz se dice que es convertible a toba_registro
  */
-
 interface convertible_registro
 {
 	/**
diff --git a/php/lib/registro/toba_registro.php b/php/lib/registro/toba_registro.php
index b0d0a989e1..60aa7dff04 100644
--- a/php/lib/registro/toba_registro.php
+++ b/php/lib/registro/toba_registro.php
@@ -1,10 +1,12 @@
 <?php
 /**
- * Clase que representa un registro interviniente en la personalizacion
+ * Clase que representa un registro interviniente en la personalizacion.
+ * 
  * @package Centrales
  * @subpackage Personalizacion
  */
-abstract class toba_registro {
+abstract class toba_registro 
+{
 	const registro_insert = 'registro_insert';
 	const registro_update = 'registro_update';
 	const registro_delete = 'registro_delete';
@@ -37,7 +39,7 @@ function  __construct($db, $nombre_tabla)
 	 * Si es verdadero todos los strings que se pasen como parametro $valor a
 	 * add_columna van a ser convertidos automáticamente a latin1 si están en
 	 * utf8
-	 * @param <type> $param
+	 * @param string $param
 	 */
 	function set_conversion_auto_latin1($param)
 	{
@@ -186,4 +188,4 @@ function get_conflictos_solubles()
 	abstract function to_sql();
 
 }
-?>
+?>
\ No newline at end of file
diff --git a/php/modelo/personalizacion/xml/toba_pers_xml_generador.php b/php/modelo/personalizacion/xml/toba_pers_xml_generador.php
index b9178d1062..50b5adce38 100644
--- a/php/modelo/personalizacion/xml/toba_pers_xml_generador.php
+++ b/php/modelo/personalizacion/xml/toba_pers_xml_generador.php
@@ -1,6 +1,7 @@
 <?php
 /**
- * Esta clase representa un plan de la personalizacion
+ * Esta clase representa un plan de la personalizacion.
+ * 
  * @package Centrales
  * @subpackage Personalizacion
  */
diff --git a/php/modelo/personalizacion/xml/toba_pers_xml_generador_componentes.php b/php/modelo/personalizacion/xml/toba_pers_xml_generador_componentes.php
index 269833dc62..fb13a6f3f4 100644
--- a/php/modelo/personalizacion/xml/toba_pers_xml_generador_componentes.php
+++ b/php/modelo/personalizacion/xml/toba_pers_xml_generador_componentes.php
@@ -6,7 +6,6 @@
  */	
 class toba_pers_xml_generador_componentes extends toba_pers_xml_generador
 {
-
 	/**
 	 *
 	 * @param string $path path del directorio de componentes
@@ -101,8 +100,8 @@ protected function get_path_componente($path_inicial, $tipo, $id)
 	}
 
 	/**
-	 * @param <type> $componente
-	 * @param <type> $path
+	 * @param array $componente
+	 * @param string $path
 	 */
 	private function generar_componente_borrada(&$componente, $path)
 	{
@@ -138,8 +137,8 @@ private function generar_componente_borrada(&$componente, $path)
 	}
 	
 	/**
-	 * @param <type> $componente
-	 * @param <type> $path
+	 * @param array $componente
+	 * @param string $path
 	 */
 	private function generar_componente_modificada(&$componente, $path)
 	{
diff --git a/php/modelo/personalizacion/xml/toba_pers_xml_generador_tablas.php b/php/modelo/personalizacion/xml/toba_pers_xml_generador_tablas.php
index bd069a4865..e176af198f 100644
--- a/php/modelo/personalizacion/xml/toba_pers_xml_generador_tablas.php
+++ b/php/modelo/personalizacion/xml/toba_pers_xml_generador_tablas.php
@@ -66,7 +66,5 @@ protected function generar_tabla($path, $nombre_tabla, &$tabla)
 		$xml->cerrar_elemento();
 		$xml->cerrar_documento();
 	}
-
-
 }
 ?>
diff --git a/php/nucleo/componentes/interface/efs/toba_ef.php b/php/nucleo/componentes/interface/efs/toba_ef.php
index 92d3b61a8b..dea3b458b4 100644
--- a/php/nucleo/componentes/interface/efs/toba_ef.php
+++ b/php/nucleo/componentes/interface/efs/toba_ef.php
@@ -597,7 +597,8 @@ function es_solo_lectura()
 	/**
 	 * Cambia la obligatoriedad de un ef
 	 * Notar que este cambio no se persiste para el siguiente pedido.
-	 * Para cambiar la obligatoriedad durante todo un ciclo cliente-servidor usar {@link toba_ei_formulario::set_efs_obligatorios() set_efs_obligatorios del formulario}
+	 * Para cambiar la obligatoriedad durante todo un ciclo cliente-servidor usar @see toba_ei_formulario::set_efs_obligatorios()
+     * 
 	 * @param boolean $obligatorio
 	 */
 	function set_obligatorio($obligatorio = true)
diff --git a/php/nucleo/componentes/interface/efs/toba_ef_upload.php b/php/nucleo/componentes/interface/efs/toba_ef_upload.php
index 49bab7ec1a..218521cb3c 100644
--- a/php/nucleo/componentes/interface/efs/toba_ef_upload.php
+++ b/php/nucleo/componentes/interface/efs/toba_ef_upload.php
@@ -111,7 +111,8 @@ function tiene_estado()
 	
 	/**
 	 * Valida que cumpla con la lista de extensiones válidas definidas.
-	 * También chequea los {@link http://www.php.net/manual/en/features.file-upload.errors.php mensajes de error de upload} de php
+	 * También chequea los http://www.php.net/manual/en/features.file-upload.errors.php mensajes de error de upload de php
+     * 
 	 * @return unknown
 	 */
 	function validar_estado()
diff --git a/php/nucleo/componentes/interface/toba_ei_cuadro.php b/php/nucleo/componentes/interface/toba_ei_cuadro.php
index 061929f9b7..2eae450c53 100644
--- a/php/nucleo/componentes/interface/toba_ei_cuadro.php
+++ b/php/nucleo/componentes/interface/toba_ei_cuadro.php
@@ -524,7 +524,7 @@ function get_datos()
 
 	/**
 	 * @ignore
-	 * @return <type>
+	 * @return array
 	 */
 	function get_estructura_datos()
 	{
@@ -897,8 +897,8 @@ function get_clave_seleccionada()
 
 	/**
 	 * Indica si la clave que se pasa por parametro es igual a la fila actualmente seleccionada.
-	 * @param <type> $clave_fila
-	 * @return <type>
+	 * @param string $clave_fila
+	 * @return boolean
 	 */
 	function es_clave_fila_seleccionada($clave_fila)
 	{
@@ -1791,9 +1791,9 @@ protected function finalizar_ordenamiento()
 
 	/**
 	 * @ignore
-	 * @param <type> $columna
-	 * @param <type> $sentido
-	 * @return <type>
+	 * @param string $columna
+	 * @param string $sentido
+	 * @return boolean
 	 */
 	function es_sentido_ordenamiento_seleccionado($columna, $sentido)
 	{
diff --git a/php/nucleo/componentes/interface/toba_ei_cuadro_salida_html.php b/php/nucleo/componentes/interface/toba_ei_cuadro_salida_html.php
index 7ecc41ccec..0e9c0e10e4 100644
--- a/php/nucleo/componentes/interface/toba_ei_cuadro_salida_html.php
+++ b/php/nucleo/componentes/interface/toba_ei_cuadro_salida_html.php
@@ -424,8 +424,8 @@ function html_pie_corte_control(&$nodo, $es_ultimo)
 
 	/**
 	 * @ignore
-	 * @param <type> $nodo
-	 * @param <type> $total_columnas
+	 * @param array $nodo
+	 * @param integer $total_columnas
 	 */
 	function html_cabecera_pie($indice, $nodo, $total_columnas)
 	{
@@ -444,8 +444,8 @@ function html_cabecera_pie($indice, $nodo, $total_columnas)
 
 	/**
 	 * @ignore
-	 * @param <type> $nodo
-	 * @param <type> $total_columnas
+	 * @param array $nodo
+	 * @param integer $total_columnas
 	 * @todo Por el momento no se estaria usando y no se como se usa
 	 */
 	function html_pie_pie($nodo, $total_columnas, $es_ultimo)
@@ -462,7 +462,8 @@ function html_pie_pie($nodo, $total_columnas, $es_ultimo)
 
 	/**
 	 * @ignore
-	 * @param <type> $nodo
+	 * @param array $nodo
+     * @param integer $total_columnas 
 	 */
 	function html_sumarizacion_usuario($nodo, $total_columnas)
 	{
diff --git a/php/nucleo/componentes/interface/toba_ei_cuadro_salida_pdf.php b/php/nucleo/componentes/interface/toba_ei_cuadro_salida_pdf.php
index 84e96a2aef..fd716e7d2c 100644
--- a/php/nucleo/componentes/interface/toba_ei_cuadro_salida_pdf.php
+++ b/php/nucleo/componentes/interface/toba_ei_cuadro_salida_pdf.php
@@ -112,10 +112,10 @@ function get_opciones_columnas()
 
 	/**
 	 * @ignore
-	 * @param <type> $columnas
-	 * @param <type> $datos_cuadro
-	 * @param <type> $id_fila
-	 * @param <type> $formateo
+	 * @param array $columnas
+	 * @param array $datos_cuadro
+	 * @param string $id_fila
+	 * @param string $formateo
 	 * @return string
 	 */
 	function generar_layout_fila($columnas, $datos_cuadro, $id_fila, $formateo)
diff --git a/php/nucleo/componentes/interface/toba_ei_firma.php b/php/nucleo/componentes/interface/toba_ei_firma.php
index 2556e5565d..8f0fc905e1 100644
--- a/php/nucleo/componentes/interface/toba_ei_firma.php
+++ b/php/nucleo/componentes/interface/toba_ei_firma.php
@@ -187,7 +187,7 @@ function set_alto_pdf($alto)
 	 
 	 /**
 	 * Servicio que se ejecuta cuando el applet busca/envia el PDF
-	 * @param <type> $parametros
+	 * @param array $parametros
 	 * @ignore
 	 */
 	function servicio__ejecutar($parametros = null)
diff --git a/php/nucleo/componentes/interface/toba_ei_formulario.php b/php/nucleo/componentes/interface/toba_ei_formulario.php
index 13dc62847e..182a11f47a 100644
--- a/php/nucleo/componentes/interface/toba_ei_formulario.php
+++ b/php/nucleo/componentes/interface/toba_ei_formulario.php
@@ -566,7 +566,8 @@ function desactivar_validacion_ef($ef)
 	
 	/**
 	 * Establece que un conjunto de efs NO seran enviados al cliente durante una interacción
-	 * Para hacer un ef solo_lectura ver {@link toba_ef::set_solo_lectura() set_solo_lectura del ef}
+	 * Para hacer un ef solo_lectura ver @see toba_ef::set_solo_lectura()
+     * 
 	 * @param array $efs Uno o mas efs, si es nulo se asume todos
 	 */
 	function desactivar_efs($efs=null)
diff --git a/php/nucleo/componentes/interface/toba_ei_mapa.php b/php/nucleo/componentes/interface/toba_ei_mapa.php
index 2a4139fbdc..dac2c1d6f1 100644
--- a/php/nucleo/componentes/interface/toba_ei_mapa.php
+++ b/php/nucleo/componentes/interface/toba_ei_mapa.php
@@ -209,7 +209,7 @@ function set_extent_activo($xmin, $ymin, $xmax, $ymax)
 
 	/**
 	 * @ignore
-	 * @param <type> $datos
+	 * @param array $datos
 	 */
 	function set_datos($datos)
 	{
@@ -432,7 +432,7 @@ function generar_botones($clase = '', $extra='')
 	//-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------//
 	/**
 	 * Devuelve el vinculo con la direccion a la que se le pedira el servicio para el grafico del mapa.
-	 * @return <type>
+	 * @return string
 	 */
 	protected function get_url_mapa()
 	{
@@ -445,7 +445,7 @@ protected function get_url_mapa()
 
 	/**
 	 * Servicio que se ejecuta cuando el cliente pide el mapa por URL
-	 * @param <type> $parametros
+	 * @param array $parametros
 	 * @ignore
 	 */
 	function servicio__ejecutar($parametros = null)
@@ -559,7 +559,7 @@ protected function enviar_archivo($archivo)
 	/**
 	 * Devuelve la lista de scripts JS utilizados por este componente
 	 * @ignore
-	 * @return <type>
+	 * @return array
 	 */
 	function get_consumo_javascript()
 	{
diff --git a/php/nucleo/componentes/negocio/toba_cn.php b/php/nucleo/componentes/negocio/toba_cn.php
index 7861daee94..69db2e99f2 100644
--- a/php/nucleo/componentes/negocio/toba_cn.php
+++ b/php/nucleo/componentes/negocio/toba_cn.php
@@ -73,8 +73,8 @@ function cancelar()
 	/**
 	 * El procesamiento se dispara cuando la entrega de datos ci->cn ha finalizado
 	 * Se inicia una transaccion de base de datos y dentro de ella se llama a :
-	 *  - {@link evt__validar_datos() evt__validar_datos} 
-	 *  - {@link evt__procesar_especifico() evt__procesar_especifico}
+	 * @see evt__validar_datos()
+	 * @see evt__procesar_especifico()
 	 *  Una vez terminada la transacción se invoca a la limpieza de memoria
 	 * 
 	 * @todo Ver la posibilidad de usar ignore_user_abort() para evitar problemas con medios no transaccionales
diff --git a/php/nucleo/componentes/persistencia/toba_ap_tabla_db.php b/php/nucleo/componentes/persistencia/toba_ap_tabla_db.php
index 8c58ea21b4..3bbd372b02 100644
--- a/php/nucleo/componentes/persistencia/toba_ap_tabla_db.php
+++ b/php/nucleo/componentes/persistencia/toba_ap_tabla_db.php
@@ -2,7 +2,7 @@
 define("apex_db_registros_separador","%");
 
 /**
- * Administrador de persistencia a una tabla de DB desde un {@link toba_datos_tabla datos_tabla}
+ * Administrador de persistencia a una tabla de DB desde un @see toba_datos_tabla
  * Supone que la tabla de datos se va a mapear a algun tipo de estructura en una base de datos
  *
  * TODO Poder desactivar el control de sincronizacion (¿se necesita esto?)
@@ -765,7 +765,7 @@ protected function evt__post_delete($id_registro){}
 	//-------------------------------------------------------------------------------
 
 	/**
-	 * Shortcut de {@link toba_db::ejecutar() toba::db()->ejecutar}
+	 * Shortcut de @see toba_db::ejecutar()
 	 */
 	protected function ejecutar_sql($sql, $id_fila=null)
 	{
diff --git a/php/nucleo/componentes/persistencia/toba_datos_relacion.php b/php/nucleo/componentes/persistencia/toba_datos_relacion.php
index 26594d410f..f3a797bddd 100644
--- a/php/nucleo/componentes/persistencia/toba_datos_relacion.php
+++ b/php/nucleo/componentes/persistencia/toba_datos_relacion.php
@@ -1,7 +1,7 @@
 <?php
 
 /**
- * Mantiene un conjunto relacionado de {@link toba_datos_tabla datos_tabla}, brindando servicios para cargar y sincronizar esta relación con algún medio de persistencia (general una BD relacional)
+ * Mantiene un conjunto relacionado de @see toba_datos_tabla , brindando servicios para cargar y sincronizar esta relación con algún medio de persistencia (general una BD relacional)
  * 
  * TODO En el dump_esquema incluir la posición actual de los cursores
  * @package Componentes\Persistencia
diff --git a/php/nucleo/componentes/persistencia/toba_datos_tabla.php b/php/nucleo/componentes/persistencia/toba_datos_tabla.php
index 2d9eafd780..0eccc234b5 100644
--- a/php/nucleo/componentes/persistencia/toba_datos_tabla.php
+++ b/php/nucleo/componentes/persistencia/toba_datos_tabla.php
@@ -227,7 +227,8 @@ function agregar_relacion_con_padre($relacion, $id_padre)
 	
 	/**
 	 * Retorna las relaciones con las tablas padre
-	 * @return array de {@link toba_relacion_entre_tablas toba_relacion_entre_tablas}
+	 * @return array 
+     * @see toba_relacion_entre_tablas
 	 * @ignore 
 	 */
 	function get_relaciones_con_padres()
@@ -237,7 +238,8 @@ function get_relaciones_con_padres()
 
 	/**
 	 * Retorna la relación con una tabla padre
-	 * @return {@link toba_relacion_entre_tablas toba_relacion_entre_tablas}
+	 * @return object 
+     * @see toba_relacion_entre_tablas
 	 * @ignore 
 	 */	
 	function get_relacion_con_padre($id_tabla_padre)
@@ -294,7 +296,8 @@ function notificar_hijos_sincronizacion($filas=array())
 
 
 	/**
-	 * Retorna la {@link toba_datos_relacion relacion} que contiene a esta tabla, si existe
+	 * Retorna la @see toba_datos_relacion que contiene a esta tabla, si existe
+     * 
 	 * @return toba_datos_relacion
 	 */
 	function get_relacion()
@@ -1665,7 +1668,8 @@ function get_columnas()
 	}
 	
 	/**
-	 * Retorna el nombre de la {@link toba_fuente_datos fuente de datos} utilizado por este componente
+	 * Retorna el nombre de la @see toba_fuente_datos utilizado por este componente
+     * 
 	 * @return string
 	 */
 	function get_fuente()
diff --git a/php/nucleo/componentes/toba_cargador.php b/php/nucleo/componentes/toba_cargador.php
index d5f37f7513..217d98624a 100644
--- a/php/nucleo/componentes/toba_cargador.php
+++ b/php/nucleo/componentes/toba_cargador.php
@@ -181,7 +181,7 @@ protected function armar_clave($db, $tabla, &$definicion, $cant_registros)
 	 *
 	 * @param array $registros
 	 * @param string $claves es un string separado por ; con las claves del registro.
-	 * @return <type>
+	 * @return array
 	 */
 	protected function reorganizar_tablas($tabla, &$registros, $claves)
 	{
diff --git a/php/nucleo/componentes/toba_componente.php b/php/nucleo/componentes/toba_componente.php
index c46745a4b3..298ff0ff8a 100644
--- a/php/nucleo/componentes/toba_componente.php
+++ b/php/nucleo/componentes/toba_componente.php
@@ -137,7 +137,7 @@ function get_clave_memoria_global()
 	}
 
 	/**
-	 * Shortcut de {@link toba_logger::debug() toba::logger()->debug} que incluye información básica del componente actual
+	 * Shortcut de @see toba_logger::debug() que incluye información básica del componente actual
 	 */
 	protected function log($txt)
 	{
diff --git a/php/nucleo/lib/autenticacion/toba_autenticacion_ldap.php b/php/nucleo/lib/autenticacion/toba_autenticacion_ldap.php
index 647e7aeea3..ea2a43780b 100644
--- a/php/nucleo/lib/autenticacion/toba_autenticacion_ldap.php
+++ b/php/nucleo/lib/autenticacion/toba_autenticacion_ldap.php
@@ -36,7 +36,7 @@ function __construct($server=null, $dn=null) {
 	
 	/**
 	*	Realiza la autentificacion utilizando un servidor LDAP
-	*	@return $value	Retorna TRUE o FALSE de acuerdo al estado de la autentifiacion
+	*	@return boolean Retorna TRUE o FALSE de acuerdo al estado de la autentifiacion
 	*/
 	function autenticar($id_usuario, $clave, $datos_iniciales=null)
 	{	
diff --git a/php/nucleo/lib/toba_instancia.php b/php/nucleo/lib/toba_instancia.php
index 053f1ff450..ea08e46bd7 100644
--- a/php/nucleo/lib/toba_instancia.php
+++ b/php/nucleo/lib/toba_instancia.php
@@ -497,7 +497,7 @@ function get_datos_perfiles_funcionales_usuario_proyecto($usuario, $proyecto)
 
 	/**
 	*	Retorna los perfiles funcionales que tiene asociado un usuario a un proyecto
-	*	@return $value	Retorna un array de grupos de acceso
+	*	@return array Retorna un array de grupos de acceso
 	*/
 	function get_perfiles_funcionales($usuario, $proyecto)
 	{
diff --git a/php/nucleo/lib/toba_perfil_datos.php b/php/nucleo/lib/toba_perfil_datos.php
index 083bd78fd6..809b858a08 100644
--- a/php/nucleo/lib/toba_perfil_datos.php
+++ b/php/nucleo/lib/toba_perfil_datos.php
@@ -117,7 +117,7 @@ function indexar_gatillos($fuente)
 
 	/**
 	*	retorna el perfil de datos del usuario
-	*	@return $value string. Si el usuario no posee un perfil devuelve NULL
+	*	@return string|null Si el usuario no posee un perfil devuelve NULL
 	*/
 	function get_id()
 	{
@@ -128,7 +128,7 @@ function get_id()
 
 	/**
 	*	retorna un arreglo con los perfiles de datos del usuario
-	*	@return $value array. Si el usuario no posee un perfil devuelve NULL
+	*	@return array Si el usuario no posee un perfil devuelve NULL
 	*/
 	function get_ids()
 	{
@@ -137,7 +137,7 @@ function get_ids()
 	
 	/**
 	*	Indica si el perfil de datos del usuario posee restricciones
-	*	@return $value	boolean
+	*	@return boolean
 	*/
 	function posee_restricciones($fuente)
 	{
@@ -150,7 +150,7 @@ function posee_restricciones($fuente)
 
 	/**
 	*	Retorna un array con las restricciones aplicadas sobre las dimensiones
-	*	@return $value	Retorna un array de dimensiones con un subarray de restricciones
+	*	@return array	Retorna un array de dimensiones con un subarray de restricciones
 	*/
 	function get_restricciones( $fuente )
 	{
@@ -164,7 +164,7 @@ function get_restricciones( $fuente )
 	 * 
 	 * @param varchar $dimension nombre de la dimension a consultar.
 	 * @param unknown_type $fuente_datos fuente de datos donde deberia estar la dimension.
-	 * @return $value boolean
+	 * @return boolean
 	 */
 	function posee_dimension($dimension, $fuente_datos=null) 
 	{
@@ -238,7 +238,7 @@ function get_restricciones_dimension_agrupado_perfil($fuente, $nombre)
 	
 	/**
 	*	Retorna un array con las dimensiones sobre las que se establecieron restricciones
-	*	@return $value	Retorna un array de dimensiones
+	*	@return array	Retorna un array de dimensiones
 	*/
 	function get_lista_dimensiones_restringidas($fuente)
 	{
diff --git a/php/nucleo/lib/toba_proyecto.php b/php/nucleo/lib/toba_proyecto.php
index b2adcc8fe2..3543fe66dc 100644
--- a/php/nucleo/lib/toba_proyecto.php
+++ b/php/nucleo/lib/toba_proyecto.php
@@ -660,7 +660,7 @@ function get_gadgets_proyecto($usuario, $proyecto=null)
 	/**
 	 * Instancia el objeto correspondiente de acuerdo a la informacion recibida
 	 * ademas asigna los valores de las propiedades existentes
-	 * @param <type> $info
+	 * @param array $info
 	 * @ignore
 	 */
 	private function get_objeto_gadget($info)
diff --git a/php/nucleo/lib/toba_puntos_control.php b/php/nucleo/lib/toba_puntos_control.php
index 5302382426..8871b95fc7 100644
--- a/php/nucleo/lib/toba_puntos_control.php
+++ b/php/nucleo/lib/toba_puntos_control.php
@@ -1,6 +1,7 @@
 <?php
 /**
  * Clase base de los Controles
+ * 
  * @package Centrales
  */
 abstract class toba_control
@@ -56,7 +57,8 @@ class toba_puntos_control
 	// ------------------------------------------------------------------------------------
 
 	/**
-	 * @ignore.
+	 * @ignore
+     * 
 	 * @return toba_puntos_control
 	 */
 	static function instancia()
@@ -72,7 +74,9 @@ static function instancia()
 	// ------------------------------------------------------------------------------------
 
 	/**
-	 * @ignore. Retorna el bloque de memoria de trabajo de los puntos de control
+     * Retorna el bloque de memoria de trabajo de los puntos de control
+     * 
+	 * @ignore 
 	 */
 	private function &get_bloque()
 	{
@@ -80,7 +84,9 @@ private function &get_bloque()
 	}
 
 	/**
-	 * @ignore. Establece el valor de un parametro de un punto de control en particular.
+     * Establece el valor de un parametro de un punto de control en particular.
+     * 
+	 * @ignore 
 	 */
 	private function set_valor($punto_control, $parametro, $valor)
 	{
@@ -99,7 +105,9 @@ private function set_valor($punto_control, $parametro, $valor)
 	}
 
 	/**
-	 * @ignore. Crea un punto de control.
+     * Crea un punto de control.
+     * 
+	 * @ignore 
 	 */
 	private function crear_punto_control($punto_control, &$valores_item)
 	{
@@ -152,7 +160,9 @@ private function crear_punto_control($punto_control, &$valores_item)
 	}
 
 	/**
-	 * @ignore. Retorna los controles de un punto de control.
+     * Retorna los controles de un punto de control.
+     * 
+	 * @ignore
 	 */
 	private function &get_controles($punto_control)
 	{
@@ -165,7 +175,9 @@ private function &get_controles($punto_control)
 	}
 
 	/**
-	 * @ignore. Ejecuta un control de un punto de control.
+     * Ejecuta un control de un punto de control.
+     * 
+	 * @ignore
 	 */
 	private function ejecutar_control($componente, $punto_control, $control)
 	{
@@ -184,8 +196,9 @@ private function ejecutar_control($componente, $punto_control, $control)
 	}
 
 	/**
-	* @ignore. Almacena el resultado de la ejecucion del control.
-	*/
+     * Almacena el resultado de la ejecucion del control.
+	 * @ignore
+	 */
 	private function set_resultado_control($punto_control, $control)
 	{
 		$data =& $this->get_bloque();
@@ -202,8 +215,9 @@ private function set_resultado_control($punto_control, $control)
 	}
 
 	/**
-	* @ignore. Actualiza el resultado de la ejecucion del punto de control.
-	*/
+     * Actualiza el resultado de la ejecucion del punto de control.
+     * @ignore 
+	 */
 	private function set_resultado($control)
 	{
 		// Recupero bloque de datos
@@ -267,7 +281,8 @@ public function get_ultimo_punto()
 	/**
 	 * Retorna los valores a utilizar por el punto de control
 	 * para enviarle a los controles.
-	 * @param toba_cn $controlador
+     * 
+	 * @param object $controlador toba_cn
 	 */
 	public function get_valores_punto($punto_control)
 	{
@@ -353,6 +368,7 @@ public function get_actua_como()
 
 	/**
 	 * Ejecuta los puntos de control de un ci sobre un componente para un evento especifico.
+     * 
 	 * @param $id del ci en ejecucion (Se utiliza para determinar si debo retener o no los resultados.).
 	 * @param $componente sobre el que se produce el evento.
 	 * @param $evento disparado.
diff --git a/php/nucleo/lib/toba_usuario_basico.php b/php/nucleo/lib/toba_usuario_basico.php
index ef3e4bcbbf..aa96ea3441 100644
--- a/php/nucleo/lib/toba_usuario_basico.php
+++ b/php/nucleo/lib/toba_usuario_basico.php
@@ -1,6 +1,7 @@
 <?php
 /**
  * Usuario estandar de la instancia
+ * 
  * @package Seguridad
  * @subpackage TiposUsuario
  */
@@ -13,7 +14,8 @@ class toba_usuario_basico extends toba_usuario
 
 	/**
 	*	Realiza la autentificacion.
-	*	@return $value	Retorna TRUE o FALSE de acuerdo al estado de la autentifiacion
+     * 
+	*	@return boolean	Retorna TRUE o FALSE de acuerdo al estado de la autentifiacion
 	*/
 	static function autenticar($id_usuario, $clave, $datos_iniciales=null, $usar_log=true)
 	{
@@ -45,6 +47,7 @@ static function autenticar($id_usuario, $clave, $datos_iniciales=null, $usar_log
 
 	/**
 	 * Recupera las descripciones de las cuentas de usuario
+     * 
 	 * @param array $cuentas Lista de ids de usuario
 	 * @return array El formato es array(array('id' => id, 'nombre' => nombre))
 	 */
diff --git a/php/nucleo/lib/toba_vinculador.php b/php/nucleo/lib/toba_vinculador.php
index 8492d97bb4..8c41de754d 100644
--- a/php/nucleo/lib/toba_vinculador.php
+++ b/php/nucleo/lib/toba_vinculador.php
@@ -353,14 +353,14 @@ static function url_a_variable($url)
 	//------------------------------ SALIDA  ----------------------------------------------
 	//-------------------------------------------------------------------------------------
 
-	/**
-		@@acceso: interno
-		@@desc: Genera un VINCULO
-		@@param: string | URL
-		@@param: array | Parametros para la construccion del HTML. Las claves asociativas son: frame, clase_css, texto, tipo [normal,popup], inicializacion, imagen_recurso_origen, imagen
-		@@param: string | Nombre de la ventana hija cuando el vinculo se abre en popup
-		@@retorno: string | HTML del vinculo generado
-	*/
+    /**
+     * Genera un VINCULO
+     * 
+     * @param string $url
+     * @param array $parametros Parametros para la construccion del HTML. Las claves asociativas son: frame, clase_css, texto, tipo [normal,popup], inicializacion, imagen_recurso_origen, imagen
+     * @param string $nombre_ventana Nombre de la ventana hija cuando el vinculo se abre en popup
+     * @return string
+     */
 	protected function generar_html($url, $parametros, $nombre_ventana=null)
 	{
 		if(!isset($parametros['tipo'])) $parametros['tipo'] = 'normal';
diff --git a/php/nucleo/toba_solicitud_web.php b/php/nucleo/toba_solicitud_web.php
index 117aade938..606cfa1292 100644
--- a/php/nucleo/toba_solicitud_web.php
+++ b/php/nucleo/toba_solicitud_web.php
@@ -544,7 +544,7 @@ function hacer_seguimiento()
 
 	/**
 	 *@private
-	 * @return <type>
+	 * @return boolean
 	 */
 	function es_item_login()
 	{

From 78033b386cab5b03a893548eae404a19328f40fb Mon Sep 17 00:00:00 2001
From: Ricardo Dalinger <rdalinger@siu.edu.ar>
Date: Mon, 15 Jan 2024 17:16:10 -0300
Subject: [PATCH 2/3]  Compatibiliza declaracion de metodo

---
 php/nucleo/lib/toba_logger_ws.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/php/nucleo/lib/toba_logger_ws.php b/php/nucleo/lib/toba_logger_ws.php
index 0399c579fa..cd1999c949 100644
--- a/php/nucleo/lib/toba_logger_ws.php
+++ b/php/nucleo/lib/toba_logger_ws.php
@@ -54,7 +54,7 @@ public function set_log_handler($log_handler)
 		$this->modo_archivo = false;
 	}
 	
-	public function log($level, $message, array $context = array())
+	public function log($level, $message, array $context = array()): void
 	{
 		if (! $this->activo) {			//Si no estoy logueando ni me gasto.
 			return;

From 5634e5d8fd7829355de627120ffd1d589d60b52e Mon Sep 17 00:00:00 2001
From: Ricardo Dalinger <rdalinger@siu.edu.ar>
Date: Fri, 19 Jan 2024 10:22:45 -0300
Subject: [PATCH 3/3]  Changelog Update & Version Bump

---
 CHANGELOG.md                           | 3 +++
 VERSION                                | 2 +-
 package.json                           | 2 +-
 proyectos/toba_editor/proyecto.ini     | 2 +-
 proyectos/toba_referencia/proyecto.ini | 2 +-
 proyectos/toba_usuarios/proyecto.ini   | 2 +-
 6 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5cd9bc52f9..2b47108969 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,9 @@
 
 [CURRENT](https://github.com/SIU-Toba/framework/compare/master...develop)
 
+[3.4.1](https://github.com/SIU-Toba/framework/releases/tag/v3.4.1) (2024-01-19)
+- Se corrige problema en la clase `toba_logger_ws` que impedia visualizar la documentación de las APIs Rest.
+
 [3.4.0](https://github.com/SIU-Toba/framework/releases/tag/v3.4.0) (2023-12-06)
 - Se incrementa el requerimiento de plataforma a PHP 8.1+
 - Se actualizan los siguientes paquetes 
diff --git a/VERSION b/VERSION
index 18091983f5..47b322c971 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-3.4.0
+3.4.1
diff --git a/package.json b/package.json
index 22dc7d41eb..269804b315 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "siu-toba-framework",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "description": "Framework para desarrollo rápido de aplicaciones web",
   "license": "SEE LICENSE IN licencia.txt",
   "repository": "https://github.com/SIU-Toba/framework.git",
diff --git a/proyectos/toba_editor/proyecto.ini b/proyectos/toba_editor/proyecto.ini
index 9861eca105..cdff384b31 100644
--- a/proyectos/toba_editor/proyecto.ini
+++ b/proyectos/toba_editor/proyecto.ini
@@ -6,7 +6,7 @@ mail_soporte =
 url_ayuda = doc/wiki/trac/toba/wiki/
 
 ;Versi? del proyecto, debe ser formato x.y.z
-version = 3.4.0
+version = 3.4.1
 
 ;Nombre de fantas? de la versi?
 version_fantasia =
diff --git a/proyectos/toba_referencia/proyecto.ini b/proyectos/toba_referencia/proyecto.ini
index e7ed212f29..393a7c4504 100644
--- a/proyectos/toba_referencia/proyecto.ini
+++ b/proyectos/toba_referencia/proyecto.ini
@@ -8,7 +8,7 @@ url_ayuda_agregar_extension = 0
 mostrar_resize_fuente = 1
 
 ;Versi? del proyecto, debe ser formato x.y.z
-version = 3.4.0
+version = 3.4.1
 api_major = 1
 api_minor = 0
 
diff --git a/proyectos/toba_usuarios/proyecto.ini b/proyectos/toba_usuarios/proyecto.ini
index 3242c06e8d..9f84558d05 100644
--- a/proyectos/toba_usuarios/proyecto.ini
+++ b/proyectos/toba_usuarios/proyecto.ini
@@ -5,7 +5,7 @@ descripcion = Descripci? del proyecto
 mail_soporte =
 
 ;Versi? del proyecto, debe ser formato x.y.z
-version = 3.4.0
+version = 3.4.1
 app_launcher = 1
 
 ;Nombre de fantas? de la versi?