Hoy, como me aburría mucho mientras comentaba el código de la página de CASBliP, me he puesto a contar las líneas de código de la página que tanto esfuerzo, sudor y lágrimas me costó escribir.
En total son 11088 líneas de código incluyendo el CSS (no me digáis que no es un número bonito).
Están repartidas en 70 ficheros (.php, .html y .css) lo que hace una media de 158,4 líneas por fichero.
El fichero más pequeño es "construccion_en.html" solo tiene 9 líneas y ocupa unos miserables 190 bytes, he aquí su contenido:
table class="texto">
tr>
td>
br>br>br>br>br>br>br>br>
Page Under Construction.br>
Please check back soon.
/td>
/tr>
/table>
El fichero más grande es "editdocform.php" contiene 792 líneas y ocupa 34.441 bytes, no voy a poner su contenido por motivos evidentes.

Puede que haya 2 o 3 centenares de líneas que no haya escrito yo mismo, si no que las he copiado de aquí o allá o las ha escrito Eva-Amparo, pero también hay 2 o 3 millares de líneas que las he reescrito varias veces. Pero al final lo que cuenta es lo que hay.

--------------------------------

Sí, ya sé que me aburro mucho. Es lo que tiene revisar miles de líneas de código sólo para poner comentarios explicativos donde me parezca que pueden venir bien. Estos comentarios son para que un futuro lector del código pueda entender de forma más o menos sencilla cómo funciona la página sin tener que morir en el intento (imaginemos a mí mismo dentro de 2 años queriendo hacer otra página o a uno de los socios alemanes dentro de un año que quiera traducir la página al alemán, que es una de las tareas) .

---------------------------------

En otro orden de cosas, mis compañeros de piso y yo seguimos con el propósito de cambiar de vivienda en breve a pesar de que ayer perdimos nuestro primer piso y con el que ya nos habíamos hecho ilusiones. Puede que entre hoy y el jueves veamos 3 ó 4 pisos.

---------------------------------

Qué más, qué más?
Ah! sí, se me olvidaba.
El libro que me saqué el otro día de la biblioteca sobre VRML es una auténtica basura, si alguno por lo que fuera está interesado en aprender VRML que se olvide de esa escoria escrita. Ayer me saqué otro que espero me cause mejor impresión, no os pongo enlace porque no he encontrado, si está bien ya pondré la referencia.

---------------------------------

Y para terminar pondré una anécdota-ejemplo de la importancia de los comentarios que he encontrado en http://barrapunto.com/


Cómo dije en mi primera entrada de la bitácora, un ex-compañero dejó miles y miles de lineas de código sin apenas comentarios que desde hace algunos dias me toca modificar. Entre ese maravilloso ovillo de entrelazado código me encuentro maravillosas perlas que se suponen ayudan a entender esas lineas. Veamos los tres últimos hallazgos:

// Esta variable al final creo que no la uso
private ArrayList m_alErrorThreadIndexes;

/// Esta función creo que ya no se utiliza
public void SetThreadStarted()

/// Cuando se cierra, mi meresco un premio. Capuccino di Nescafé, cremoso, delicioso, per disfrutare tutti pleni
private void Order2OtherFrm_Closed(object sender, System.EventArgs e)

Cuando el código esta bien hecho los comentarios como este último no solo son bienvenidos, sino que se muestran por ahí alabando el buen humor del programador que, además de programar bien, nos alegra un poquitín la existencia.

Pero cuando el código es como si lo hubiera escrito el Pato Donald, comentarios como este último, además de tocar los cojones, dejan una pésima imagen del programador, el cual nos cae cada vez peor ya que, ademas de programar como el puto culo y dificultarte sobremanera la existencia, se permite el lujo de vacilarte y reirse de tí en la distancia.

Gracias una vez mas, ex-compañero.