524meneos

Es importante comentar bien el código imagen

www.fantasmitas.com/2009/12/01/154-programador/ 
por Nirgal el 01-12-2009 20:32 UTC, publicado el 01-12-2009 23:25 UTC

Esto es lo que pasa cuando a alguien realmente literal le pides que el código de un programa esté bien comentado. (Hace falta hacer click sobre la imagen para verla en tamaño grande)

 75 comentarios en: ocio, friqui karma: 571
etiquetas: programación, código, comentarios, programador
negativos: 0  usuarios: 277  anónimos: 247  compartir:  twitter  facebook  buzz  friendfeed
  1. #1   buenisima!!
    votos: 4, karma: 35 link
    el 01-12-2009 20:34 UTC *  por Laurita_G
  2. #2   rem ¿comenta? ¿que es comentar?
    ' hace años que no se comentan las lineas.
    // muy bueno
    votos: 6, karma: 59 link
    el 01-12-2009 20:41 UTC *  por Cortocircuitos
  3. #3   Lo de la repeticion en el debugger me ha matado {lol}
    votos: 29, karma: 245 link
    el 01-12-2009 20:42 UTC *  por eloso
  4. #4   muy muy bueno, y los iconos de la pagina , se salen
    votos: 2, karma: 31 link
    el 01-12-2009 20:45 UTC *  por manjsc
  5. #5   LOL Está genial! {lol}
    votos: 1, karma: 15 link
    el 01-12-2009 20:48 UTC *  por zerial
  6. #6   {lol} {lol} {lol} que cachondo
    votos: 0, karma: 7 link
    el 01-12-2009 20:49 UTC *  por ocb
  7. #7   /* Me ha encantado */
    votos: 20, karma: 175 link
    el 01-12-2009 20:52 UTC *  por miau
  8. #8   #7 Todos los comentarios de meneame vienen comentados de serie.
    votos: 3, karma: 33 link
    el 01-12-2009 21:18 UTC *  por sorrillo
  9. #9   <!-- Que bueno -->
    votos: 7, karma: 80 link
    el 01-12-2009 21:21 UTC *  por angelitoMagno
  10. #10   {lol} {lol} {lol} {lol}
    votos: 0, karma: 7 link
    el 01-12-2009 21:42 UTC *  por pejotadb
  11. #11   Me habría hecho gracia si no me hubieran contado el final en el título del post. ¿Tu no serás traductor de títulos de películas al español?
    votos: 18, karma: 151 link
    el 01-12-2009 22:13 UTC *  por kanduman
  12. #12   Comentar el código es como lavar el cuarto de baño: nadie quiere hacerlo, pero cuando se hace, provoca una buena sensación para usted y sus visitantes.
    votos: 35, karma: 300 link
    el 01-12-2009 22:15 UTC *  por iRiku87
  13. #13   Que buena
    votos: 0, karma: 6 link
    el 01-12-2009 22:20 UTC *  por casusbelli
  14. #14   #2 rem. OMG que recuerdos.
    votos: 2, karma: 30 link
    el 01-12-2009 22:30 UTC *  por radurdin
  15. #15   Ja, ja, sí. Pero no olvidemos que la rechifla esta procede de una mala traducción que casi todos hemos contribuido a propagar: el ‘to remark inglés’ no debería haber pasado al español, en este contexto, como ‘comentar’, sino como ‘anotar’
    Y, dicho esto... {grin}
    votos: 3, karma: 37 link
    el 01-12-2009 22:45 UTC *  por senador
  16. #16   //grande//
    votos: 1, karma: 16 link
    el 01-12-2009 22:45 UTC *  por Akai
  17. #17   ;Está bastante bien, coincido con #11.
    votos: 1, karma: 15 link
    el 01-12-2009 23:06 UTC *  por www.bromarca.com
  18. #18   # OMG, mezclar fútbol con programación, esto debe ser peor que lo del LHC ese
    votos: 3, karma: 34 link
    el 01-12-2009 23:18 UTC *  por Genko
  19. #19   Ahora que hagan uno sobre indentar y lo jodido que es leer código de alguien que no indenta. ¡Qué suplicio!
    votos: 3, karma: 29 link
    el 01-12-2009 23:28 UTC *  por boquepa
  20. #20   Por estas pequeñas cosas Meneame es un mundo aparte...
    votos: 1, karma: 15 link
    el 01-12-2009 23:31 UTC *  por Meik
  21. #21   -- Que bueno lo de inserta, inserta, ... excepcion sql!
    votos: 2, karma: 22 link
    el 01-12-2009 23:31 UTC *  por anunciado_en_TV
  22. #22   Está caído...
    votos: 0, karma: 16 link
    el 01-12-2009 23:34 UTC *  por araujo
  23. #23   la verdad es que está muy bien
    ese y el nº 146 "Dorando la píldora"

    #22 ahora no
    #22 ahora si
    #22 ahora no... va por momentos
    #22 ¿ves? ahora si otra vez
    votos: 6, karma: 51 link
    el 01-12-2009 23:38 UTC *  por malacaton
  24. #24   Ouch ! y yo dando forms! {lol}
    votos: 0, karma: 6 link
    el 01-12-2009 23:42 UTC *  por Shrewd
  25. #25   Quiero... leerlo... AAAAARG
    votos: 0, karma: 9 link
    el 01-12-2009 23:44 UTC *  por --29006--
  26. #26   Si el código necesita ser comentado, es que necesita ser reescrito.
    votos: 2, karma: 5 link
    el 01-12-2009 23:45 UTC *  por figus_black
  27. #27   Yo también quiero ver! {grin}

    Pero la página está caida {tongue}
    votos: 0, karma: 6 link
    el 01-12-2009 23:46 UTC *  por david5
  28. #28   #19 Para eso se inventaron los auto-indentadores. Yo lloro cada vez que un profesor o compañero me pasa código, por eso en cuanto me llega algo en C++ o Java le paso el astyle: astyle.sourceforge.net/
    votos: 1, karma: 19 link
    el 01-12-2009 23:48 UTC *  por rasca
  29. #29   ¿Alguien tiene un enlace en caché o algo? No me carga {sad} .
    votos: 1, karma: 24 link
    el 01-12-2009 23:51 UTC *  por N4D13LOLZ
  30. #30   Muy bueno. Me recuerda a Gila y la operacion de riñón:

    ivoox.com/gila-operacion-rinon-audios-mp3_rf_144037_1.html
    votos: 1, karma: 15 link
    el 01-12-2009 23:51 UTC *  por --4067--
  31. #31   #29 me uno a la propuesta
    votos: 1, karma: 24 link
    el 01-12-2009 23:52 UTC *  por sam2001
  32. #32   Hacía mucho tiempo que no tenía tanta expectación... llevo un porrón de rato intentando verlo solamente por cabezonería... carga la página horriblemente lenta... no recuerdo tanto sufrimiento desde esas cargas de jpegs subiditos de tono que era eterna con 28'8 kbps (yo es que no viví los 14'4, no soy tan viejo).

    Ahora mismo espero el mejor chiste del mundo... si no muero de risa me sentiré decepcionado.
    votos: 3, karma: 33 link
    el 01-12-2009 23:52 UTC *  por Caesarsaz
  33. #33   #29 y #31 enlace directo a la imagen: fantasmitas.com/wp-content/uploads/2009/12/f_m_154.png
    votos: 2, karma: 33 link
    el 01-12-2009 23:56 UTC *  por sam2001
  34. #34   #33 Gracias {grin} .

    Dioooooooooos, qué mala es {confused} :S {confused} . #32, lo siento, pero te vas a sentir decepcionado {lol} {lol} .
    votos: 0, karma: 10 link
    el 01-12-2009 23:56 UTC *  por N4D13LOLZ
  35. #35   #29, #31 imgur.com/VmfR2.png
    votos: 4, karma: 32 link
    el 01-12-2009 23:57 UTC *  por Blaxter
  36. #36   Me siento decepcionado y mis amigos apesadumbrados. Ni yo tuve lo que esperaba ni los que me rodean tuvieron lo que desean.

    Muerte, otra vez será...
    votos: 1, karma: 16 link
    el 01-12-2009 23:57 UTC *  por Caesarsaz
  37. #37   Mola {smiley}
    votos: 0, karma: 9 link
    el 01-12-2009 23:57 UTC *  por Lito
  38. #38   Por qué no usamos una cache para los links, como por ejemplo coral? No más links caídos. Y menos? Menos sí.
    votos: 0, karma: 6 link
    el 01-12-2009 23:59 UTC *  por grimborg
  39. #39   cinco mentarios
    votos: 0, karma: 6 link
    el 02-12-2009 00:04 UTC *  por grimborg
  40. #40   FFFFFFFFFOOOOOOOOOOOOOOOOOORRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR del CSV-Subersion !!!!!!!!!!
    votos: 0, karma: 8 link
    el 02-12-2009 00:13 UTC *  por RaiderDK
  41. #41   Forges genial como siempre

    Oh wait!
    votos: 1, karma: 15 link
    el 02-12-2009 00:18 UTC *  por kaiowas
  42. #42   # Qué malo {lol}
    votos: 0, karma: 6 link
    el 02-12-2009 00:21 UTC *  por --156823--
  43. #43   #28 #19 A mi me entra sarpullido cuando alguien identa con espacios en vez de con tabulaciones. No puedo con ello, para leer no pasa nada, pero si tienes que tocar código... aarrrrggg
    votos: 0, karma: 6 link
    el 02-12-2009 00:30 UTC *  por --155086--
  44. #44   Le falta un terrorífico....

    TODO:
    votos: 0, karma: 6 link
    el 02-12-2009 00:32 UTC *  por ZuL
  45. #45   Pero de verdad ¿para programar una base de datos hace falta comentar el código? no me extraña que os paguen 800 euros de mierda.

    otra cosa sería software para hacer simulaciones fisicas en 3d en ensamblador, entonces de vez en cuando hay que poner un comentario, pero ¿programillas que lo unico que hacen es mandar llamadas a una base de datos?

    jajajajaj
    votos: 2, karma: 8 link
    el 02-12-2009 00:37 UTC *  por Professor
  46. #46   de los mejores chistes que he visto en mi vida {lol} {lol}
    votos: 0, karma: 7 link
    el 02-12-2009 00:54 UTC *  por okeen
  47. #47   #45 ¡Qué joputa eres! {lol}

    ¿por cierto, tienes algún troll comunista? Es que este "Professor" Francófilo ya comienza a ser un tanto cansino...
    votos: 0, karma: 11 link
    el 02-12-2009 00:58 UTC *  por Oblomov
  48. #48   Yo conocia esta
    fantasmitas.com/2009/09/06/142-maestro-jedi/
    votos: 0, karma: 11 link
    el 02-12-2009 01:18 UTC *  por visualito
  49. #49   Hola, soy la variable de la función alcorcon...
    votos: 0, karma: 7 link
    el 02-12-2009 01:30 UTC *  por ronko
  50. #50   #45 así que en asm pones "de vez en cuando" comentarios? {lol}
    Miedo me da leer un codigo tuyo en asm o en C...
    votos: 2, karma: 19 link
    el 02-12-2009 01:48 UTC *  por --155086--
  51. #51   % #43 Pues en muchas normas de estilo se recomienda tabular con espacios {lol}

    % Y me temo que con razón... En Eclipse, por ejemplo, si usas el tabulador lo que ocurre es que se
    % va alineando el texto con columnas prefijadas. Por lo que el tabulador no equivale a un número
    % exacto de espacios, sino a "los que falten para llegar a X columna". Lo mismo pasa en otros IDEs.
    % Cuando luego llegas, y tienes que abrir el código en vim... te abres las venas, directamente,
    % porque se muestra totalmente mal identado.

    % PD: En Eclipse, por cierto, se puede especificar que se tabule con espacios (es decir, cuando
    % tú pulsas Tab, él mete espacios) y los maneja estupendamente, puedes incluso seguir usando
    % Mayus+Tab sin problemas. Es la mejor opción {smiley}

    % PPD: Esto es un comentario de MATLAB, que ese aún no lo habéis puesto {tongue}
    votos: 0, karma: 7 link
    el 02-12-2009 05:38 UTC *  por jmpep
  52. #52   #45: lo tuyo, sin comentarios {tongue}

    la persistencia es solo un paso en un programa. la algoritmia suele necesitar comentarios. Primero, para que dentro de dos meses, cuando te pidan una modificación (o se la pidan a un compeñero), te acuerdes de qué iba el fregado. Segundo, por facilitar la didáctica (un código bien indentado y comentado puede srer útil para que otros compañeros aprendan y se familiaricen con un lenguaje y con las best-practices de programación. Tercero, suele ser útil cuando intentas localizar código en proyectos grandes (algo tan sencillo como un comentario con el id de error que has solucionado soluciona muchos dolores de cabeza. Cuarto, suele ser necesario comentar como mínimo, minimísimo, las cabeceras, para que si alguien utiliza tu código sepa qué son los parámetros...
    votos: 3, karma: 32 link
    el 02-12-2009 06:46 UTC *  por enderwiggins
  53. #53   muy bueno el chiste
    votos: 0, karma: 7 link
    el 02-12-2009 06:54 UTC *  por Canaca
  54. #54   #19 Por eso me enamore de python...
    votos: 1, karma: 14 link
    el 02-12-2009 07:54 UTC *  por dreierfahrer
  55. #55   #26 me has recordado este BRUTAL post de the daily wtf:

    thedailywtf.com/Articles/CodeThatDocumentsItselfSoWellItDoesNotNeedComx
    votos: 0, karma: 7 link
    el 02-12-2009 07:57 UTC *  por dreierfahrer
  56. #56   #28 lo que mola es que si no indentas NO COMPILE, y te de un error y te diga: 'indenta, atontao' {smiley}
    votos: 0, karma: 7 link
    el 02-12-2009 07:58 UTC *  por dreierfahrer
  57. #57   Jajaja SQLException, que injusticiaaaaaaaa!!
    votos: 0, karma: 6 link
    el 02-12-2009 08:21 UTC *  por Shirouhana
  58. #58   #26 Me gustaria ver un millon de lineas de codigo sin comentarios....

    Y me gustaria verte reescribirlo... con infinitos monos aporreando infinitos teclados, a poder ser
    votos: 1, karma: 13 link
    el 02-12-2009 08:31 UTC *  por dreierfahrer
  59. #59   COBOL RULES!!!

    Ahora coñas aparte "El código ha sido dificil de programar, así que tiene que ser dificil de leer"
    votos: 0, karma: 9 link
    el 02-12-2009 08:43 UTC *  por biforcos
  60. #60   #26 +1, todas las buenas prácticas indican que el código debe hablar por si solo, excepto en casos en los que la implementación del algoritmo lo requiera, para mayor claridad de lectura.

    Un código que necesite de muchos comentarios para ser entendido, no es un buen código
    votos: 0, karma: 6 link
    el 02-12-2009 08:44 UTC *  por Markinos
  61. #61   #43 Es mejor práctica indentar con espacios, ya que en todos los entornos los tabuladores no aparecerán con la misma longitud, pero los espacios sí.

    Los tabuladores son más cómodos, por eso herramientas como Eclipse permiten que tú teclees tabulador e inmediatamente sea reemplazado por 4 o n espacios.
    votos: 0, karma: 7 link
    el 02-12-2009 08:50 UTC *  por Jarke
  62. #62   #60 Si el codigo solo lo ves y solo lo tocas tu y no vas a hacer nada mas en tu vida que mirar y tocar ESE codigo puede que tengas razon...

    Y si el programa no es demasiado grande, claro...

    Nadie es tan bueno como para no necesitar comentarios en 5.000.000 de lineas y aunque lo fuera seguro que no esta solo y puede que a alguien que trabaje con el le vengan bien los comentarios, ademas no cuesta nada, clarifica y se puede documentar el codigo mucho mas facil...

    Que perra os ha entrado... os molestan los comentarios? os muerden los cojoncillos?
    votos: 2, karma: 19 link
    el 02-12-2009 09:11 UTC *  por dreierfahrer
  63. #63   #47 el comunismo! interesante.
    votos: 0, karma: 6 link
    el 02-12-2009 11:36 UTC *  por Professor
  64. #64   #43 #51 #61

    A mi personalmente tabular con espacios me parece una reminiscencia de cuando se manipulaba codigo con herramientas de los años 80, hoy en dia todos los editores decentes te permiten trabajar con funciones avanzadas tanto con tabuladores como con espacios, en cambio, usar el marcador de tabulacion como marcador semantico de indentacion me parece mucho mas acertado, no solo por lo obvio de su uso, si no por lo que apunta #61, en diferentes entornos estos simbolos pueden ser dibujados de diferentes maneras, lo que en mi pueblo se llama 'personalizacion' y es una ventaja, no un inconveniente.
    votos: 0, karma: 6 link
    el 02-12-2009 11:58 UTC *  por oxelo
  65. #65   #64 #51 #61
    El problema es que es bastante incómodo trabajar con el.
    Por ejemplo, si te toca borrar un bucle cualquiera que implica unas cuantas lineas de código identadas, te toca borrar espacios, mientras que si has tabulado, solo tienes que quitar una tabulación por cada linea.
    votos: 0, karma: 6 link
    el 02-12-2009 12:29 UTC *  por --155086--
  66. #66   #55, #58, #60, #62 Que era broma por dios, que daño ha hecho lo de ironic=off y demás chorradas, ahora nadie pilla las bromas si no se las mastican....¡y encima uno me vota negativo! sois como críos.
    votos: 0, karma: 6 link
    el 02-12-2009 13:22 UTC *  por figus_black
  67. #67   que buena viñeta!!
    votos: 0, karma: 6 link
    el 02-12-2009 13:57 UTC *  por Estopeño
  68. #68   Si no dejas "notas" en él, el codigo fuente puede no ser facilmente interpretado por otra persona que lea dicho codigo fuente... precisamente por eso mucha genta no deja "notas" en el codigo fuente... para que los demas no lo entiendan facilmente. Para los que no le cojan... "hacerse imprescindible", "es mi codigo, que se piii", etc etc

    A las malas se puede entender un codigo sin anotaciones, pero cuesta trabajo y tiempo. Y no vayas a explicarle eso a tu jefe {wink}
    votos: 0, karma: 6 link
    el 02-12-2009 13:58 UTC *  por chubasco
  69. #69   Se me olvidaba un ejemplo de otro tipo.

    Llega un programador competente y le dice el empresario hazme este tipo de programa. Va el buen hombre y lo hace. Funciona perfecto y todo completamente "comentado"!!!!

    Muy bien Manolito... pues ya te puedes ir a la puta calle! JAJAJA

    Contrata a Bartolo el limitado y este, gracias a tus "notas", puede ir parcheando tu programa {tongue} Y mas barato, oiga {wink}
    votos: 0, karma: 6 link
    el 02-12-2009 14:05 UTC *  por chubasco
  70. #70   #69: ¿y por eso es preferible hacer mal tu trabajo? ¿porque el empresario sea un hijo de puta? ¡Bravo! {grin}
    votos: 1, karma: 17 link
    el 02-12-2009 15:34 UTC *  por enderwiggins
  71. #71   #66 Y TU MAS!

    #68 Ye tenia un 'jefe' (superior a mi, mas bien) que para hacerse 'imprescindible' me ocultaba informacion... todo un show cuando cayo de baja...

    #69 Pues te vas a hacer otro programa cojonudamente a otro lado... si eres bueno en lo tuyo estate tranquilo que valoraran tu trabajo...
    votos: 0, karma: 7 link
    el 02-12-2009 17:08 UTC *  por dreierfahrer
  72. #72   #64 Hay entornos en los que los tabuladores no tienen la longitud que esperas, y es muy fácil que haya algún espacio mezclado entre ellos, ya que en muchos editores son invisibles. Ello ocasiona que no se produzca un efecto de "personalización", sino que todo quede mal indentado.

    Y lo digo porque me ha pasado.
    votos: 0, karma: 7 link
    el 02-12-2009 17:09 UTC *  por Jarke
  73. #73   » ver comentario
    link
    el 02-12-2009 20:27 UTC *  por nojodamosconlosramos
  74. #74   #65 En Eclipse por ejemplo no tienes que andar quitando espacios. Pulsas Mayus+Tab y él quita los espacios que correspondan a una tabulación.
    votos: 0, karma: 7 link
    el 03-12-2009 04:25 UTC *  por jmpep
  75. #75   En Eclipse haces Control+Shift+t y te autoindenta el código. Característica totalmente infrautilizada y super útil. Cuando me toca pegarme con código de otro, es lo primero que hago. Hace el trabajo mucho más fácil.
    votos: 0, karma: 7 link
    el 04-12-2009 00:57 UTC *  por --7103--
comentarios cerrados

menéame