Jump to content

PHP doc format problem


wepnop

Recommended Posts

Hi. Im having a problem with the html formatting. The first is that <pre> tag isnt working well, because it dont mantaint all the format.

 

Second, im having a strange problem using lists. Here is the docblock:

 

/**
*<pre>
* SISTEMA DE TEST
* vaaaaaaaaaaaaaaa
* 2
* Este sistema incluye funciones para inspeccionar variables, las supervariables,
* imprimir texto de errore y testearlos de forma mas rapida.
* 
*
* ----INSTRUCCIONES----
* <ul> 
* <li>- Imprimir las supervariables:Debes usar las funciones impXX(impPOST, impENV, etc...). Para mejor usabilidad
*      estan agrupadas en tres funciones que mostraran una cierta cantidad de ellas:
* 
*		
*			<ol>
*			<li> ImpSupTod:Las imprime todas.</li> <br>
*			<li> ImpSupForm:</li> Imprime las de formulario: post, get, files, request.
*			<li> ImpSupInt:</li> Imprime las internas: serv, env.
*			<li> ImpSupExt:</li> Imprime las externas: cookie, session, post, get, files, request.
*			</ol>
*</li>
*		Nota: Se usan tres funciones para formatear los metodos impXX. Un cambio en el 
*		formato generado por la funcion sera ejecutado en todas las impXX. Son:
*			· formClaveValor: formatea el contenido de las supervariables.
*			· formSupTitulo: formatea el nombre-titulo de las supervariables.
*			· formSupIndefinida: formatea un mensaje de alerta para cuando
*									no esta definida.
*
* <li> - Inspeccionar las variables:</li>
* 
*		· insp_v: Esta funcion es una version mejorada del print_r. Formatea mejor, usa
*		tablas para los arrays(que pueden tener arrays dentro de si mismos), usa la * 	 *      etiqueta pre, muestra los metodos de los objetos y todo esto extraiendo los 
*		caracteres html conflictivos. 
*		Parametros:
*			· $elem: variable de php a inspeccionar.
*			· $max_level=10: nivel maximo de profundidad de arrays en arrays
*			· $print_nice_stack=array(): usado para la recursividad con los arrays
*
*		· iv: Un alias corto de insp_v. Usa y pasa sus mismos argumentos.
*
* <li>- Testeo mejorado:</li>
* 
*		· p: Esta funcion imprime una marca de testeo rapida. Se formatea con \n y fuente
*		especial, mejorando la visibilidad. Es ideal para cuando quieras conocer si x *		 funciona o no.
*		Permite funcionar sin parametros, mostrando 'Marca + numero de llamadas sin *
* 		argumento'  de forma automatica.
*		Parametros:
*			· $elem: qualquier variable convertible a string.
*
*
*		· pe: Imprime una marca de alerta de testeo rapida. Se formatea con \n y fuente
*		especial(roja), mejorando la visibilidad. Es un alternativa al p azul, aunque añade
*		el texto 'Alerta. ' siempre.
*		Permite funcionar sin parametros, mostrando 'Alerta + numero de llamadas sin 
* 		argumento'  de forma automatica.
*		Parametros:
*			· $elem: qualquier variable convertible a string.
*
*		· q: Un alias acortado para exit() o return. Usado para parar la ejecucion hasta
*		un punto de forma mas rapida.
*
*</ul>
* ----CREDITOS---- 
*
* insp_v basado en funcion de Federico Bricker, impSuperVariables basado
* ligeramente en codigo de http://blogricardo.wordpress.com
*
* @author Wep, Federico Bricker, http://blogricardo.wordpress.com
* @version 1.3
* @license GPL 2
* </pre>
*/

 

The problem its says is:

 

ERROR in test.php on line 99: ul/ol tags cannot be directly nested inside ul/ol, nest inside li

 

Also the pre tag fails with for example for formatting some things, like this, that is shown without br or nothing:

*

* <ol>

* <li> ImpSupTod:Las imprime todas.</li> <br>

* <li> ImpSupForm:</li> Imprime las de formulario: post, get, files, request.

* <li> ImpSupInt:</li> Imprime las internas: serv, env.

* <li> ImpSupExt:</li> Imprime las externas: cookie, session, post, get, files, request.

* </ol>

 

 

Link to comment
https://forums.phpfreaks.com/topic/229233-php-doc-format-problem/
Share on other sites

Archived

This topic is now archived and is closed to further replies.

×
×
  • Create New...

Important Information

We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue.