Comments

AThroughout lothe largoprevious deexercises losand ejerciciosexamples yyou ejemploswill anterioreshave habrásseen vistothat quein ensome algunoscases casoscomments hanhave aparecidoappeared comentariosin enthe los programas.programs.

UnA comentariocomment enin programaciónprogramming is estext unin textoour ensource nuestrocode códigothat fuentethe quecompiler elignores. compiladorAnd ignora.if Yyou siignore loit, ignora,why ¿pordo quéwe loput ponemos?it Habitualmenteon? paraUsually darnosto explicacionesgive internasus deinternal cuálexplanations esof lawhat funciónthe defunction cadaof parteeach delpart programa.of Tambiénthe sonprogram muyis. útilesThey paraare descartaralso fragmentosvery deuseful códigofor detemporarily formadiscarding temporal,code sinfragments, tenerwithout quehaving borrarlos,to ydelete asíthem, facilitarand suthus posteriorfacilitate recuperación.
their later recovery.

LosComments comentariosin enprogramming programaciónare son fundamentales:essential:

• FacilitanThey lafacilitate comprensión:understanding: nonot soloonly deof otrosother usuariosusers sinobut delalso mismoof programador/athe aprogrammer lohimself largothroughout delthe tiempoduration queof durathe eldevelopment desarrolloof delthe programa.program. 
• FavorecenThey laencourage colaboración:collaboration: vuelventhey elmake códigothe comprensiblecode paraunderstandable otrasfor personasother coprogramadorasco-programmers quewho decan esaalso formaparticipate. pueden participar también.
• FacilitanThey lafacilitate depuraciónerror dedebugging: errores:commenting comentarand yuncommenting descomentarcode fragmentosfragments dewill códigoallow nosus permitiráto detectardetect enwhere quéerrors lugarare se están produciendo los fallos.occurring.
  

En

Comments muchas ocasiones bastará como ejercicio que a nuestro alumnado le propongamos un programa y le digamos que lo organice  y le coloque comentarios. Eso nos dará idea de si entiende realmente el funcionamiento del mismo, paso previo a que pueda más adelante adaptar ese programa a nuevas necesidades e incluso crear uno desde cero. Pero esto lo veremos con más detalle en el módulo siguiente.

Comentarios enin PSeInt

ParaTo realizarmake comentarioscomments enin PSeInt simplementewe tendremoswill quesimply encabezarhave elto puntohead enthe elpoint quewhere queremoswe insertarwant elto comentarioinsert conthe unacomment doble barra. Eso nos pondrá el texto que vienewith a continuacióndouble enslash. unThat griswill pálidoput ythe entext cursivathat quefollows nos indicará que el compilador no vain a tomarpale engray cuentaand loin escritoitalics, dewhich estawill forma.indicate that the compiler will not take into account what is written in this way. 

TambiénComments secan puedenalso introducirbe losentered comentariosat althe finalend deof unaa línealine deof código.code.

PSeInt soloonly permiteallows comentarcommenting líneason ylines noand fragmentosnot enterosentire defragments código,of porcode, loso queif siwe queremoswant descartarto undiscard conjuntoa deset instruccionesof deberemosinstructions comentarwe líneamust porcomment línealine todasby lasline queon constituyanall elthose bloque.that Esomake obviamenteup nothe sucedeblock. enThat lenguajesobviously estructuradosdoes denot programaciónhappen quein sístructured poseenprogramming estalanguages capacidad.that do have this capability.

EstaThis capacidadcapability esis especialmenteespecially útiluseful enin lasdebugging fasesphases, deto depuraciónisolate dethe fallos,code parafragments aislarwhere loserrors fragmentosare defound. código donde se encuentran los errores.

LosThe comentarioscomments porof supuestocourse nodo aparecennot enappear lain ventanathe deprogram ejecuciónexecution delwindow. programa.Where Dóndethey síare sonvisible visiblesis esin enthe elassociated diagramaflowchart.

de flujo asociado.

ComentariosComments enin Scratch

EnIn Scratch seyou puedencan añadiradd comentarioscomments desdefrom lathe ventanacode deediting ediciónwindow deassociated códigowith asociadoeach object. Comments can be either associated with a cadablock objeto.or Loson comentariosthe puedenediting estarwindow tantoitself. asociadosThey aare unadded bloqueby comoright-clicking sobreon lathe mismaplace ventanawhere dewe edición.want Seto añadeninsert clicandothe con el botón derecho sobre el lugar donde queremos insertar el comentario.
comment.

UnaOnce vezadded, añadidos,they quedanremain comoas notasvisible visiblesnotes enin elthe áreacode deediting edición del código.area.

PorOf supuestocourse enin Scratch nothere existe la opción de comentar y descomentar bloques para queis no seanoption tenidosto encomment cuentaand poruncomment elblocks compilador.so Lathat opciónthey disponibleare paranot realizartaken estointo esaccount separarby elthe eventocompiler. queThe determinaoption laavailable ejecuciónto dedo esethis bloqueis yto elseparate códigothe quedaráevent temporalmentethat desactivado.determines the execution of that block and the code will be temporarily deactivated.

{{@5685}}