Buenas!.

Ayer al acabar un ejemplo, este necesitaba una ampliación (una comprobación) para evitar un problema.
Al final lo hice directamente, no era algo complicado y se resolvía con algo de tiempo. Otra cosa
es que luego no funcionase el código añadido y ya más tiempo a dedicarle..o decir, ale, 
"hasta luego Lucas", que nos vemos otro día.

Antes quería añadir un comentario especial: "TODO" para recordarme una vez abriese el proyecto de lo que le faltaba o quería añadir
y que tenía que hacer. Ejemplo:
 

 
'Si las longitudes de las cadenas son distintas, insertar por la izquierda al menor tantos ceros como diferencia de longitud tenga el mayor con el menor

Eso seria una linea de comentario especial TODO:
Más o menos en esa frase se abrevia y se dice "el que",  pero no "el como". ( Muy detallado ).

Podía haber añadido algo distinto, que ni explicase ni el como ni el que.
Otra cosa es que las líneas de estos comentarios especiales, solo le vale la primera línea de texto, no puedes añadir debajo otras con un "&".
Vamos, que la línea puede ser "bastante" larga, pero no dos líneas.

Otro problema es si el programa es grande y tienes varios "TODO"

Supongo que nadie habrá logrado con un comentario "TODO" usar dos lineas, en vez de una.

Saludos

Mmm, me he perdido... cuál es la pregunta?

cuál es la pregunta?

Nuestro Cónsul Romano de Gades, shell, no hace preguntas, ...simplemente emana unos "Decreta imperialia de re programmandi ".

Supongo que nadie habrá logrado con un comentario "TODO" usar dos lineas, en vez de una.

Me supongo Sres. que esta es la pregunta Shell Shell ....

Yo ni idea pero a lo mejor si añades tu TODO en HTML quizás ....

Nuestro Cónsul Romano de Gades, shell, no hace preguntas, ...simplemente emana unos "Decreta imperialia de re programmandi

 

Mmm, me he perdido... cuál es la pregunta?

Ops, no he preparado correctamente el análisis de la pregunta y el diseño no está lo suficientemente depurado,
Mi pregunta tiene un error de diseño e implementación.  

Resumiendo la idea de mi pregunta y respuesta a la vez

Un programador está creando una aplicación, inacabada y que debe continuar, luego, mañana, dentro de una semana, dentro de un mes.
( Esto es un problema ). ¿ Se acordará el programador donde lo dejó ?. Probablemente no.

Crea una serie de anotaciones en la aplicación para poder continuar donde lo dejó. Que si, que son los comentarios.
Sabemos de la existencia de los comentarios especiales "TODO, FIXME y creo que me dejo alguno más".

Entonces, mi duda puede ir por ahí. Usar un comentario normal o uno especial.

Yyy que los comentarios especiales como TODO, solo me permite poner una "linea" de texto, con lo que no puedo escribir
un comentario largo o digamos bien extendido. ( Si tienes que recordar algo de mucho tiempo atrás..imagina)

¿ Usar un marcador a la línea de comentarios extensos ?.

Estamos hablando de un diseño de una aplicación. De una forma de trabajar con esos comentarios. De lo que es una forma de recordar
lo que dejaste un tiempo atrás y que ya no sabes ni por donde comenzar si dejas pasar mucho el tiempo.

En cuanto a veces como escribo pues se debe a que cuando decimos "se enciende la bombilla", aparece la idea, en su estado más puro,
no tiene barreras, no tiene filtros, es solo la idea en su estado original. Si te desviás, el concepto original de la idea se pierde y es que hay
muchos motivos por los que una idea se pierde. Prejuicios de lo preconcebido. Situaciones en las que ni tú ni yo podemos sentirnos como
un bloque de hormigón. Y esa idea original que apareció flotando entre las neuronas,va perdiendo su vitalidad y se acaba convirtiendo
en algo más que se la ha puesto etiquetas, se la ha calificado, se la ha medido y se la ha traducido, se ha perdido la fuerza del nacimiento
de una idea.
 

---

Yo ni idea pero a lo mejor si añades tu TODO en HTML quizás ....

Vaya, parece que alguien si me entendió.

Pero es mejor centrarnos en "formas, maneras de recordar en que parte dejaste un código para retomarlo más tarde".
Sobre todo cuando llevas más de uno por delante. ( ¿ Estoy diciendo algo nuevo ? ).

En realidad, es que esas anotaciones no siempre se hacen directamente en un código.  ¿ Alguien se acuerda de lo que era un papel ?.
¿ una servilleta ?. Estas en un bar, tienes delante a tu mujer y de pronto, te llegan las "musas" y de una mirada tu mujer la lanza
bien lejos a las musas. ( Las musas no son las camareras en minifalda que tienen forma de diosas ).

Es broma, lo que digo es que esas anotaciones, deben existir si queremos continuar con el proyecto que dejamos abandonado o será un naufragio total.
Y la cuestión es hacerlo de una forma "adecuada". Tampoco vas a escribir el Quijote en un comentario.

Saludos

Sé perfectamente de lo que hablas, shell. Por algo fui yo quien sugirió a Benôit su incorporación a Gambas allá por 2010.

https://foro.gambas-es.org/viewtopic.php?f=1&t=2513

Lo que pasa es que a veces me pierdo en tus poéticos comentarios que pueden llegar a ser como una montaña rusa o incluso un tiovivo

Pero sí, es cierto que no permite multilínea, porque realmente están concebidos para comentarios muy concisos. Siempre puedes añadir justo debajo otra línea comenzando con el prefijo elegido, porque el IDE te llevará al bloque de líneas contiguas.

Saludos

jguardon, Sí tu si que sabes, me parece una estupenda idea, la tuya, claro.

Entonces ya entiendo como se diseño TODO, lo explico como yo lo veo ahora.

Ponemos nuestra linea TODO pero ojo como si de un título se trata y a continuación ponemos nuestro REM a modo de explicación ya de forma extendida para que cuando demos en la lista TODO, esta nos lleva a la línea y tachan, ya tenemos la extensión de nuestro título.

Perfect, jovenes...

Estupenda conversación. Saludos.

Lo que pasa es que a veces me pierdo en tus poéticos comentarios que pueden llegar a ser como una montaña rusa o incluso un tiovivo

Normal.
 

Siempre puedes añadir justo debajo otra línea comenzando con el prefijo elegido, porque el IDE te llevará al bloque de líneas contiguas.

Es buena solución.
 

Ponemos nuestra linea TODO pero ojo como si de un título se trata y a continuación ponemos nuestro REM a modo de explicación ya de forma extendida para que cuando demos en la lista TODO, esta nos lleva a la línea y tachan, ya tenemos la extensión de nuestro título.

A veces vuelvo a los programas del Basic Sinclair y aun ejecuto esos viejos programas. Como sabes se usaba el comando REM para los comentarios,
que el interprete no los tiene en cuenta. Pero que no los tenga en cuenta, no quiere decir que no deje de "ocupar" memoria o espacio.

Lo cierto es que estos basics de antaño, según la máquina, en el caso del Basic Sinclair, las variables de cadenas, solo podían ser de una letra
y se le añadía el simbolo "$" y en caso de valores numéricos, podías concretar mejor, por ejemplo una variable llamada "cantidad". Se acortaba
mucho el nombre de las variables. 

Ejemplo, el cursor parpadea diciendo que existe un error al nombrar la variable;



En cambio un Commodore: ( No me gusta mucho el interprete. Para algunas cosas me gusta más el de Spectrum. ).



Era posible usar nombre de variables de cadenas más largas. Esto también era posible en el basic de Dragón ( que era de M$ ).
Modelos como el MSX o Amstrad creo que tenían el mismo problema.

Pues bien, si era posible usar lineas REM para decir esto hace esto u lo otro, no lo hacia todo el mundo. No era una costumbre que se cumpliese y los
códigos se convertían en un lio. Y no estoy hablando de GOTO's y GOSUB. Creo que en su día las revistas podían haberles insistidos a los colaboradores
o a los que pretendían ganar un premio de "15K pesetas" de las de antes (si es que su código salía premiado), que los códigos fueran más detallados.
Que se usase variables con más sentido, no nombres tan abstractos. Al menos un REM que dijese que hace esa variable.

Por un lado estarían obligando a aquellos programadores de antaño a unas buenas costumbres, dentro de las posibilidades del lenguaje.
Y los futuros programadores, que eran chavales, hubieran mejorado la forma de crear un programa.

Saludos

Solo te digo que me encantó programar en mi ZX81 cuando era un joven y que este me dio el camino a ser programador hasta hoy. Y despues de tanto tiempo no reniego ni un poquito de comenzar mi vida y terminarla como desarrollador. Ni un poquito