commenting

Tengo un archivo por lotes que ejecuta varios scripts de Python que hacen modificaciones de tabla. Quiero que los usuario ... con el progreso después de que lo hayan ejecutado. ¿Hay una sintaxis para agregar un comentario de manera más apropiada?

He revisado La referencia de JavaDoc, y aunque entiendo la diferencia básica entre @see (varios enlaces) y {@inheritDoc} (ex ... n de buena fe JavaDoc como tal: /** * {@inheritDoc} */ Y cuando hago eso, ¿debo mantener la bandera del método class#?

¿Cuál es la forma correcta de comentar en el lenguaje de plantillas Liquid?

Sucede más a menudo que no tengo que comentar varias líneas a la vez en Vim. Los métodos que conozco no son tan rápidos como, ... última línea para ser comentada tipo :'m,.s/^/#/ Me gusta más el método 1, pero todavía espero que haya una mejor manera.

En los archivos Java puedo escribir comentarios de TODO y aparecen en la ventana de Tareas. // TODO: Do something about this ... no aparecen. ¿Hay alguna forma de que haga eso? Por ejemplo: -- TODO: Fix this SQL query <!-- TODO: Fix this XML -->