Complementa las man pages con ejemplos

bropages.png

La expresión: una imagen vale más que mil palabras, la podríamos trasponer en muchas ocasiones a: un ejemplo vale más que 1000 líneas de documentación.

Y es que cuando necesitamos ejecutar algún comando y no nos acordamos de la sintaxis o los parámetros del mismo todo lo que queremos ver es un ejemplo que nos refresque un poco la memoria y no leernos la documentación del comando en sí o la ayuda, que en muchos casos es extensa y poco comprensible.

Bropages es un comando escrito en Ruby (por lo tanto necesitas dicho intérprete) que nos da ejemplos concretos sobre los comandos del sistema. No es un sustituto, sino un complemento a las man pages (documentación de los comandos del sistema).

Su instalación es muy sencilla y se hace a través del sistema de gemas (gems) de Ruby:

gem install bropages

Y su uso:

bro comando

El proyecto es mantenido en Github para los que queráis echar un vistazo a su código.