INSTALACION.txt de Tux Paint

Tux Paint - Un programa de dibujo simple para nios.

Copyright 2002 por Bill Kendrick
bill@newbreedsoftware.com
http://www.newbreedsoftware.com/tuxpaint/

27 de Junio de 2002 - 5 de Noviembre de 2002


Requerimientos:
---------------
  Usuarios de Windows:
  --------------------
    La versin Windows de Tux Paint viene pre-empacada con todas las
    bibliotecas necesarias pre-compiladas (en forma de ".DLL"), por lo
    tanto no se necesita bajar nada extra.
    
  libSDL
  ------
    Tux Paint requiere Simple DirectMedia Layer Library (libSDL),
    una biblioteca de programacin multimedia de Cdigo Abierto
    disponible bajo la licencia GNU Lesser General Public License (LGPL).

    Junto con libSDL, Tux Paint depende de una cantidad de otras bibliotecas
    de 'ayuda' de SDL:  SDL_Image (para archivos grficos), SDL_TTF (para el
    soporte de Fuentes True Type) y, opcionalmente, SDL_Mixer (para efectos de
    sonido).

  Usuarios de Linux/Unix:
  -----------------------
      Las bibliotecas SDL estn disponibles como cdigo-fuente o como paquetes
      RPM o Debian para varias distribuciones de Linux.  Pueden ser bajadas
      desde:

        libSDL:      http://www.libsdl.org/
        SDL_Image:   http://www.libsdl.org/projects/SDL_image/
        SDL_TTF:     http://www.libsdl.org/projects/SDL_ttf/
        SDL_Mixer:   http://www.libsdl.org/projects/SDL_mixer/   [OPCIONAL]

      Tambin suelen estar disponibles con tu distribucin Linux
      (p.ej.: en uno de los CDs de instalacin, o disponibles va programas
      de mantenimiento de software como el "apt-get" de Debian).

      NOTA: Al instalar desde paquetes, asegrate de instalar TAMBIN las
      versiones "-devel" de los paquetes.  (Por ejemplo, instala tanto
      "SDL-1.2.4.rpm" como "SDL-1.2.4-devel.rpm")

  Otras Bibliotecas:
  ------------------
    Tux Paint tambin saca partido de varias otras bibliotecas libres bajo
    licencia LGPL.  Bajo Linux, como en el caso de la SDL, ya deberan estar
    instaladas tambin, o debern estar listas para su instalacin como parte
    de tu distribucin Linux.
    
    libPNG
    ------
      Tux Paint usa el formato PNG (Portable Network Graphics) para sus
      archivos de informacin.  SDL_image requiere que libPNG est instalada.

        http://www.libpng.org/pub/png/libpng.html

    FreeType2
    ---------
      Tux Paint usa fuentes TTF (True Type Font) para dibujar texto.
      SDL_ttf requiere la biblioteca FreeType2.

        http://www.freetype.org/

    gettext
    -------
      Tux Paint utiliza las preferencias locales de tu sistema conjuntamente
      con la biblioteca "gettext" para soportar varios idiomas
      (p.ej: Espaol).  Necesitars tener la biblioteca gettext instalada.

        http://www.gnu.org/software/gettext/

    Herramientas NetPBM [OPCIONAL]
    ------------------------------
      Bajo Linux y Unix, las herramientas NetPBM son las actualmente usadas
      para imprimir. (Una PNG es generada por TuxPaint y convertida a
      PostScript usando las herramientas de lnea de comandos de NetPBM
      'pngtopnm' y 'pnmtops'.)

        http://netpbm.sourceforge.net/
	

Compilacin e Instalacin:
--------------------------
  Tux Paint se entrega bajo la licencia GNU General Public License (GPL)
  (ver "COPYING.txt" por ms detalles) y por lo tanto el 'cdigo fuente'
  del programa est incluido.

  Usuarios de Windows:
  --------------------
    Compilacin:
    ------------
      Tux Paint viene pre-compilado para Windows, por lo tanto no se
      necesita compilacin.  [Eventualmente, pondremos aqu informacin
      acerca de como recompilar para Windows.  Mientras tanto, ests por
      las tuyas. Lo sentimos!]

    Instalacin:
    -----------
      Hacer doble clic sobre el ejecutable (archivo .EXE) del instalador del
      Tux Paint y seguir las instrucciones.

      En primer lugar se preguntar si se est de acuerdo con la licencia.
      (Es la Licencia Pblica General de GNU (GPL), la cual tambin est
      disponible en el archivo "COPIADO.txt".)

      A continuacin se consultar si se desean instalar accesos directos a
      Tux Paint en el Men Inicio y en el Escritorio de Windows.
      (Ambas opciones estn habilitadas por defecto.)

      Luego se consultar sobre dnde se desea instalar el Tux Paint.
      La opcin por defecto debera ser apropiada, en tanto haya espacio
      disponible. En caso contrario, escoger una ubicacin diferente.

      En este punto, slo resta hacer clic en 'Install' para instalar Tux
      Paint!

    Cambiando las preferencias Utilizando el Acceso Directo:
    --------------------------------------------------------
      Para cambiar las preferencias del programa, hacer clic derecho sobre el
      acceso directo del TuxPaint y seleccionar 'Propiedades' (abajo).
	
      Asegurarse de que la etiqueta 'Acceso directo' est seleccionada en la
      ventana que aparece y examinar el campo 'Destino:'.  Se debera ver
      algo como esto:

        "C:\Archivos de Programa\Tuxpaint\TuxPaint.exe"

      Ahora es posible agregar opciones de lnea de comando, las que entrarn
      en accin al hacer doble clic sobre el cono.

      Por ejemplo, para hacer que el juego funcione a pantalla completa,
      con figuras simplificadas (sin opcin de rotacin) y en Espaol,
      agregar estas opciones (luego de 'TuxPaint.exe'):

        "C:\Archivos de Programa\Tuxpaint\TuxPaint.exe" -f -s --lang spanish

      (Ver "LEEME.txt" para una lista completa de las opciones de lnea de
      comando disponibles.)
	
      Si se cometiera un error o si todo desapareciera, utilizar Ctrl-Z para
      deshacer o simplemente presionar la tecla [ESC] para cerrar el dilogo
      sin aplicar los cambios (a menos que se hubiera presionado el botn
      "Aplicar"!).
	
      Una vez finalizado, hecer clic en "Aceptar".


    Si Algo Sale Mal
    ----------------
      Si al hacer doble clic en el acceso directo para ejecutar el juego
      nada sucede, es probable que sea porque algunas de las opciones de
      lnea de comando estn mal. Abrir un Explorador como antes y buscar un
      archivo llamado 'stderr.txt' en la carpeta del TuxPaint.

      Este contendr una descripcin de lo que estuvo mal. Usualmente ser
      slo debido a una mayscula o minscula incorrecta ('Z' en vez de 'z')
      o un guin '-' de menos o de ms.


  Usuarios Linux/Unix:
  --------------------
    Compilacin:
    ------------
      Nota: Al presente, Tux Paint no utiliza autoconf/automake, por lo que
      no hay un guin "./configure" que ejecutar.  (Lo sentimos!)  Sin
      embargo compilarlo no debera presentar complicaciones, asumiendo que
      todo lo que el Tux Paint necesita est instalado.

      Para compilar el programa desde las fuentes, simplemente ejecutar el
      siguiente comando desde un prompt del shell (p.ej.: "$"):

        $ make

    Deshabilitando el Sonido al Compilar:
    -------------------------------------
      Alternativamente, si no hubiera tarjeta de sonido, o si se prefieriera
      compilar el programa sin soporte para sonido (por lo que SDL_mixer no
      tendra que ser instalada), se puede ejecutar "make" con "nosound" como
      'target':

        $ make nosound


    Si aparecen errores:
    --------------------
      Si aparecen errores durante la compilacin, asegurarse de tener
      instaladas las bibliotecas apropiadas (ver arriba).  Si se estn
      utilizando versiones empacadas de las bibliotecas (p.ej: RPMs bajo
      RedHat o DEBs bajo Debian), asegurarse tambin de obtener los paquetes
      correspondientes "-dev" o "-devel", de otro modo no ser posible
      compilar Tux Paint (y otros programas) a partir del cdigo fuente!


    Instalacin:
    ------------
      Asumiendo que no hayan ocurrido errores fatales, ahora es posible
      instalar el programa para que pueda ser ejecutado por los usuarios del
      sistema. Por defecto, esto debe ser hecho por el usuario "root"
     ('superusuario'). Volverse "root" ingresando el comando:

        $ su

      Ingresar la clave de "root" cuando sea solicitada.  Ahora se debera
      estar en modo "root" (con un prompt as: #). Para instalar el programa
      y sus archivos de datos, tipear:

        # make install

      Finalmente, volver al usuario regular saliendo del modo
      superusuario:

        # exit


      NOTA: Por defecto, "tuxpaint", el programa ejecutable, est ubicado
      en "/usr/local/bin/".  Los archivos de datos (imgenes, sonidos, etc.)
      estn ubicados en "/usr/local/share/tuxpaint/".


      Chambiando las Cosas de Lugar
      -----------------------------
        Es posible cambiar las cosas de lugar usando las variables 'prefix'
        al hacer Makefile.  "PREFIX" es la base de a donde todos los dems
        archivos irn, y est fijado por defecto en "/usr/local".

        Otras variables son:
          BIN_PREFIX    
            Donde ser instalado el binario "tuxpaint".
            (Fijado por defecto en "$(PREFIX)/bin" - p.ej.: "/usr/local/bin")

          DATA_PREFIX
            Donde irn los archivos de datos (sonido, grficos, pinceles,
            sellos, fuentes), y donde el Tux Paint los buscar al ejecutarse.
            (Fijado en "$(PREFIX)/share/tuxpaint")

          DOC_PREFIX
            Donde irn los los archivos de texto de la documentacin (el
            directorio "docs"). (Fijado en "$(PREFIX)/share/doc/tuxpaint")

          MAN_PREFIX
            Donde ir la pgina de manual del Tux Paint.
            (Fijado en "$(PREFIX)/share/man")

          ICON_PREFIX                      $(PREFIX)/share/pixmaps
          X11_ICON_PREFIX                  $(PREFIX)/X11R6/include/X11/pixmaps
          GNOME_PREFIX                     $(PREFIX)/share/gnome/apps/Graphics
          KDE_PREFIX                       $(PREFIX)/share/applnk/Graphics
            Donde irn los conos y lanzadores (para GNOME y KDE).

          LOCALE_PREFIX
            Donde irn los archivos de traduccin del Tux Paint, y donde
            Tux Paint los buscar.
            (Fijado en "$(PREFIX)/share/locale/") 
            (La ubicacin final de un archivo de traduccin ser bajo el
            directorio de la respectiva localizacin [p.ej.: "es" para
            Espaol] dentro del subdirectorio "LC_MESSAGES".)


Desinstalando Tux Paint:
------------------------
  Windows
  -------
    Utilizando el Desinstalador
    ---------------------------
      Si se instalaron los accesos directos del Men Inicio (por defecto),
      entonces ir a la carpeta del TuxPaint y seleccionar "Uninstall".
      Un dilogo aparecer que confirmar que se est a punto de desinstalar
      Tux Paint y consultar si se lo quiere remover permanentemente, hacer
      clic en el botn 'Uninstall'. 

      Una vez haya terminado, hacer clic en el botn Cerrar.

      Tambin es posible utilizar la entrada "TuxPaint (remove only)" en la
      seccin Agregar/Quitar Programas del Panel de Control.

      NOTA: Como las imgenes creadas con el programa se almacenan dentro de
      la carpeta del Tux Paint, sta as como la sub-carpeta 'userdata' NO son
      removidas.


  Linux
  -----
    Dentro del directorio de fuentes del Tux Paint (donde se compil el
    programa), es posible utilizar un 'target' de 'Makefile' para desinstalar
    Tux Paint. Por defecto, esto debe ser hecho por el usuario "root"
    ('superusuario').
    (Ver las instrucciones de instalacin arriba por ms informacin.)

    Volverse "root" tipeando el comando:

      $ su

    Ingresar la clave de "root" cuando sea solicitada.  Ahora se debera
    estar en modo "root" (con un prompt as: #).  Para desinstalar el programa
    y sus archivos de datos (las imgenes de los sellos incluidos, si hubiera,
    tambin sern removidas), tipear:

      # make uninstall

    Finalmente, volver al usuario regular saliendo del modo
    superusuario:

      # exit
