From 4f1b771eeb4558af6b71fe236803d49d752aa6fb Mon Sep 17 00:00:00 2001
From: Leandro Lucarella <llucax@gmail.com>
Date: Sun, 5 Oct 2003 13:30:53 +0000
Subject: [PATCH] Se corrige documentacion.

---
 circulo.cpp  | 3 +--
 circulo.h    | 2 +-
 dibujo.h     | 2 +-
 figura.cpp   | 2 ++
 figura.h     | 4 ++--
 linea.h      | 2 +-
 rectangulo.h | 2 +-
 7 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/circulo.cpp b/circulo.cpp
index 2db9581..6b03e9a 100644
--- a/circulo.cpp
+++ b/circulo.cpp
@@ -35,7 +35,6 @@ Circulo::~Circulo(void) {
 }
 
 void Circulo::dibujar(GtkWidget* widget) const {
-//void Circulo::dibujar(GdkGC* gc, GdkDrawable *window) const {
 #ifdef DEBUG
     std::cerr << "En dibujar de Círculo." << std::endl;
 #endif
@@ -53,7 +52,7 @@ void Circulo::dibujar(GtkWidget* widget) const {
             FALSE,
             // X, Y de la esquina superior izquierda.
             centro.x - radio, centro.y - radio,
-            // ancho y alto del cuadrado que circunscribe el círculo.
+            // ancho y alto del cuadrado que circunscribe al círculo.
             radio * 2, radio * 2,
             // de 0 a 360 grados.
             0, 64 * 360);
diff --git a/circulo.h b/circulo.h
index ea1047b..458cb53 100644
--- a/circulo.h
+++ b/circulo.h
@@ -41,7 +41,7 @@ class Circulo: public Figura {
         /**
          * Dibuja.
          *
-         * \param out Stream de salida en donde dibujar.
+         * \param widget Widget donde dibujar.
          */
         virtual void dibujar(GtkWidget* widget) const;
 
diff --git a/dibujo.h b/dibujo.h
index d0f4b81..20b7559 100644
--- a/dibujo.h
+++ b/dibujo.h
@@ -57,7 +57,7 @@ class Dibujo {
         /**
          * Dibuja.
          *
-         * \param out Stream de salida donde dibujar.
+         * \param widget Widget en donde dibujar.
          */
         virtual void dibujar(GtkWidget* widget);
 
diff --git a/figura.cpp b/figura.cpp
index e320b14..f20fa3c 100644
--- a/figura.cpp
+++ b/figura.cpp
@@ -53,8 +53,10 @@ GdkColor* Figura::traducir_color(GdkColor* c) const {
                 // Al resultado le aplico una máscara para que quede 'prendido'
                 // el bit más significativo de los colores activados
                 // anteriormente (y de esta manera darles el doble de "luz").
+                // Por ejemplo: 1111 1110 & 1000 0000 = 1000 0000.
                 & 0x808080
                 // Finalmente, prendo los bits resultantes en el color de 24 bits.
+                // Por ejemplo: 1000 0000 | 0111 1111 = 1111 1111.
                 | c->pixel;
         // Si no tiene pigmento no lo dejo negro porque negro ya es cuando están
         // todos los bits apagados.
diff --git a/figura.h b/figura.h
index 36579b4..039ca8d 100644
--- a/figura.h
+++ b/figura.h
@@ -50,7 +50,7 @@ class Figura {
         virtual void set_gc(GdkGC* gc) const;
 
         /**
-         * Traduce los 4 bits de colores en 24 bits de colores.
+         * Traduce los 16 colores (de 4 bits) en colores de 24 bits.
          * La traducción es simple. Los 3 bits menos significativos son
          * usados como indicador del pigmento. El bit menos significativo
          * indica la presencia de pigmento azul, el siguiente verde
@@ -78,7 +78,7 @@ class Figura {
          * Modifica el contexto gráfico según las propiedades de la figura
          * (color y grosor).
          *
-         * \param gc Contexto gráfico a modificar.
+         * \param widget Widget donde dibujar.
          */
         virtual void dibujar(GtkWidget* widget) const = 0;
 
diff --git a/linea.h b/linea.h
index 8e94965..12cf116 100644
--- a/linea.h
+++ b/linea.h
@@ -44,7 +44,7 @@ class Linea: public Figura {
         /**
          * Dibuja.
          *
-         * \param out Stream de salida en donde dibujar.
+         * \param widget Widget donde dibujar.
          */
         virtual void dibujar(GtkWidget* widget) const;
 
diff --git a/rectangulo.h b/rectangulo.h
index f1cdffd..3a7e3ec 100644
--- a/rectangulo.h
+++ b/rectangulo.h
@@ -44,7 +44,7 @@ class Rectangulo: public Figura {
         /**
          * Dibuja.
          *
-         * \param out Stream de salida en donde dibujar.
+         * \param widget Widget donde dibujar.
          */
         virtual void dibujar(GtkWidget* widget) const;
 
-- 
2.43.0