WINGs: Return NULL on NULL input in checkFile()
[wmaker-crm.git] / README.es
blob14e0011a32b4ffbcd6f843bd0c52151a559f5755
4                                 GNU Window Maker
5                                X11 Window Manager
7                            <http://windowmaker.info>
8                          <ftp://ftp.windowmaker.info>
10                                      por
12                              Alfredo K. Kojima 
14                                  Dan Pascu
16                                     ]d
19                                Web/FTP Master
21                                Phillip Smith
25                 ¡Felicitaciones! Ha adquirido un dispositivo
26         excelentísimo que le proporcionará miles de años de uso sin
27         problemas, si no fuera porque indudablemente lo destruirá a
28         través de alguna maniobra estúpida típica de consumidor. Por
29         eso le pedimos por EL AMOR DE DIOS LEA ESTE MANUAL DEL
30         PROPIETARIO CUIDADOSAMENTE ANTES DE DESEMPAQUETAR EL
31         DISPOSITIVO. ¿YA LO DESEMPAQUETÓ, NO?  LO DESEMPAQUETÓ Y LO
32         ENCHUFÓ Y LO ENCENDIÓ Y TOQUETEÓ LAS PERILLAS, Y AHORA SU
33         CHICO, EL MISMO CHICO QUE UNA VEZ METIÓ UNA SALCHICHA EN SU
34         VIDEOCASETERA Y ACCIONÓ "AVANCE RÁPIDO", ESTE CHICO
35         TAMBIÉN ESTÁ TUOQUETEANDO LAS PERILLAS, ¿CIERTO? Y RECIÉN
36         AHORA ESTÁ COMENZANDO A LEER LAS INSTRUCCIONES, ¿¿¿CIERTO???
37         NOSOTROS PODRÍAMOS SIMPLEMENTE ROMPER ESTOS DISPOSITIVOS EN LA
38         FÁBRICA ANTES DE DESPACHARLOS, ¿SABE?
39                                 -- Dave Barry, "¡Lea Esto Primero!"
42 Descripción
43 ===========
45 Window Maker es el gestor de ventanas GNU para el Sistema de Ventanas X. Fue
46 diseñado para emular la apariencia y funcionalidad de parte del GUI de NEXTSTEP(mr).
47 Procura ser relativamente rápido y pequeño, rico en características, fácil de configurar
48 y usar, con una simple y elegante apariencia sacada desde NEXTSTEP(mr).
50 Window Maker fue diseñado teniendo en mente la integración con GNUstep y por eso
51 es el gestor de ventanas "oficial". Es también parte del proyecto GNU (www.gnu.org)
52 . Lea mas sobre GNUstep más adelante en este archivo.
55 Pistas (información dada por las aplicaciones para integrarse bien con el gestor de
56 ventanas) para Motif(tm), OPEN LOOK(tm), KDE y GNOME también son soportados. 
57 Entonces puede reemplazar cualquiera de los gestores de ventana para estos entornos
58 con Window Maker manteniendo la mayoría, si no todo, de la funcionalidad del
59 gestor de ventanas nativo.
61 Window Maker antes se llamaba WindowMaker.
63 Window Maker no tiene relación con Windowmaker, el software para
64 hacer ventanas y puertas.
67 Documentación
68 =============
70 Lea antes de preguntar.
72 * Los archivos README distribuidos por todas partes del árbol de fuentes 
73 contienen información relacionada al contenido en los directorios. 
75 * INSTALL tiene instrucciones de instalación y algunos consejos cuando tenga
76 algún problema. Significa que debería leerlo antes de la instalación.
77 No fue escrito solo para ocupar espacio en el paquete...
79 * FAQ: Preguntas Frecuentes. LEALO!!! FAQ.I18N es para
80 preguntas relacionadas con la internacionalización.
82 * NEWS: lista los cambios visibles por el usuario desde la versión anterior. 
83 Léalo si está actualizando.
85 * MIRRORS: algunos lugares alternativos donde puede obtener Window Maker, 
86 incluyendo paquetes de Window Maker específicos para ciertas plataformas.
88 * BUGFORM: uselo para enviar reportes de errores. Por favor uselo.
90 * ChangeLog: ¿que cambió desde la versión anterior?
92 * BUGS: lista de errores conocidos.
94 *** Tutorial
96 Hay un tutorial mantenido por Georges Tarbouriech en:
98 http://www.linuxfocus.org/~georges.t/
100 *** Guía del Usuario
102 La Guía del Usuario de Window Maker puede ser bajada desde el ftp oficial
103 o por sitios web.
104 Puede también ser vista en formato HTML en:
106 http://people.delphi.com/crc3419/WMUserGuide/index.htm
108 La Guía del Usuario explica como usar Window Maker, los archivos de configuración 
109 y opciones.
111 *** man pages
113 Tipee "man wmaker" en el prompt del shell para obtener ayuda general sobre Window Maker.
116 Directorios y Archivos en el Árbol de Fuentes
117 =============================================
119 * Install es un script para configurar y compilar Window Maker de una forma
120 fácil (no es que la forma normal sea difícil, pero...).
122 * AUTORES: los créditos
124 * TODO: planes para el futuro.
126 * contrib/ tiene algunos parches aportados que no están soportados por Window Maker
127   porque entran en conflicto con la filosofía de diseño de los desarrolladores o por
128   alguna otra razón.
130 * util/ tiene varios programas utilitarios.
132 * WPrefs.app/ es el programa de configuración.
134 * src/wconfig.h posee opciones de compilación que puede cambiar para 
135   seleccionar algunas opciones/caracteristicas y otras cosas.
137 * WINGs/ biblioteca widget para imitación de NEXTSTEP.
139 * wrlib/ biblioteca de procesamiento de imagen.
141 * po/ posee catálogos de mensajes  que son las versiones traducidas de los mensajes
142 mostrados por Window Maker.
144 * docklib-x.x.tar.gz es una biblioteca para escribir dockapps.
146 SOCORRO!!!
147 ==========
149 Hay una lista de correo para discutir sobre Window Maker en
150 wm-user@windowmaker.info. Para suscribirse, envie un mensaje que contenga:
152         subscribe
153 en el tema del mensaje a wm-user-request@windowmaker.info
155 Si tiene algun problema, pregunte aquí (después de leer los docs, por supuesto). Es
156 más probable que las personas de la lista sepan contestar sus preguntas
157 que nosotros. Para reportes de errores use el BUGFORM.
159 Si tiene un problema con una versión precompilada de Window Maker 
160 (rpm, deb etc), primero pregunte a la persona que hizo el paquete.
162 NOTA IMPORTANTE: cuando pida ayuda (en la lista de correo o a los desarrolladores,
163 directamente) *siempre* envie información sobre el sistema que está usando. Puede
164 usar la sección de información del sistema al final del BUGFORM como una guía. 
165 Otra cosa: por favor no envie correo HTML.
167 También hay un canal de IRC #windowmaker en openprojects. Únase aquí, 
168 conecte su cliente de irc a irc.openprojects.net, irc.linux.com o algún otro
169 servidor de esa red.
171 GNUstep
172 =======
174 GNUStep es un completo sistema de desarrollo orientado a objetos, basado en la 
175 especificación OpenStep liberada por NeXT(tm) (ahora Apple(tm) y Sun(tm)). Ello
176 proveerá todo lo que se necesita para producir aplicaciones multiplataforma, 
177 orientadas a objetos, gráficas (y no gráficas); suministrando dentro de otras cosas,
178 bibliotecas base del sistema, una estructura de alto nivel para aplicaciones GUI que
179 usan un modelo de imagenes de tipo Display PostScript(tm) (DGS), objetos para acceso
180 a bases de datos relacionales, objetos distribuidos y un entorno de desarrollo gráfico,
181 con herramientas como un modelador de interfaces, un sistema para administración del 
182 proyecto (central de proyecto) y otras herramientas.
184 El sistema de desarrollo de GNUStep será usado para crear un entorno de usuario,
185 con todo lo necesario para una completa interface gráfica de usuario, tal como 
186 un visualizador de archivos, editores de texto y otras aplicaciones. Note que el
187 entorno de usuario (o "entorno de escritorio") es solo un pequeña parte de todo
188 el proyecto GNUStep y por lo tanto no "compite" con otros proyectos como KDE o GNOME,
189 simplemente porque son cosas completamente diferentes.
191 Para más información sobre el proyecto GNUStep, visite: http://www.gnustep.org y
192 http://gnustep.current.nu
195 Ejecutando multiples instancias de Window Maker
196 ===============================================
198 No es una buena idea eejcutar más de una instancia de Window Maker desde
199 el mismo usuario (ya que wmaker usará los mismos archivos de configuración)
200 al mismo tiempo. Podría obtener un comportamiento inesperado cuando Window
201 Maker actualiza sus archivos de configuración.
203 Si de verdad desea hacer esto, intente ejecutar Window Maker con la opción
204 de linea de comando --static ya que así no actualizará o cambiará ninguno de los
205 archivos de configuración.
208 Ajuste de Rendimiento.
209 =====================
210 Si quiere disminuir el uso de memoria por parte de Window Maker y mejorar el 
211 rendimiento, manteniendo una linda apariencia y buena funcionalidad, siga los
212 items de abajo:
214 - use texturas sólidas para todo, principalmente barras de título y menúes.
215   Si quiere un escritorio de aspecto lindo, use el estilo Tradicional.
216 - Apague NewStyle y Superfluous
217 - No una muchos atajos al menú y mantenga solo los items esenciales en el menú.
218 - Active DisableClip
219 - edite wconfig.h y desactive el NUMLOCK_HACK y lo mismo con las características
220   que no use (tenga en mente que algunos de los #defines podrían no funcionar,
221   ya que ellos no están completamente soportados). Asegúrese de mantener siempre
222   Numlock y ScrollLock apagados.
223 - Active DisableAnimations. Puede también #undefine ANIMATIONS en wconfig.h
224 - quite las entradas por defecto IconPath y PixmapPath para contener solo las
225   rutas que en verdad tiene en su sistema.
226 - no use imágenes grandes en el fondo raíz.
227 - quite el soporte para los formatos de imagen que no use.
228 - para reducir el uso de la memoria, desactive el caché de ícono, definiendo 
229   la variable de entorno RIMAGE_CACHE a 0. Si quiere aumentar el rendimiento 
230   a expensas del uso de la memoria, defina este valor a un valor igual al 
231   número de íconos distintos que use.
233 Control del Mouse por Teclado
234 =============================
236 Muchas personas preguntan sobre agregar control por teclado al mouse, como
237 en fvwm, pero Window Maker no tendrá tal característica. La extensión XKB 
238 soporta simulación de mouse desde el teclado, de una manera mucho más poderosa
239 que cualquier otra simulación hecha por un administrador de ventanas.
241 Para activarlo, presione la combinación de teclas Control+Shift+NumLock o 
242 Shift+NumLock. Debiera escuchar el beep del parlante. Para desactivarlo,
243 haga lo mismo.
245 Para controlar el mouse el teclado numérico se usa así:
246 - 4 (flecha izquierda), 7 (Home), 8 (flecha arriba), 9 (PgUP), 6 (flecha derecha),
247   3 (PgDn), 2 (flecha abajo) y 1 (Fin) mueve el mouse a la correspondiente 
248   dirección;
249 - sosteniendo una de las teclas de arriba y luego sosteniendo la tecla 5 moverá
250 el puntero más rápido;
251 - / seleccionará el primer botón del mouse (botón izquierdo);
252 - * seleccionará el segundo botón del mouse (botón del medio);
253 - - seleccionará el tercer botón del mouse (botón derecho);
254 - 5 hará un click con el botón actualmente seleccionado del mouse;
255 - + hará un doble click con el botón actualmente seleccionado;
256 - 0 (Ins) cliqueará y mantendrá el botón seleccionado actualmente;
257 - . (Del) liberará el botón seleccionado actualmente que fue anteriormente
258   cliqueado con la tecla 0 (Ins).
260 Los valores anteriores de las teclas funcionarán en un servidor X XFree86 3.2
261 (X11R6.1) pero su alcance puede variar.
263 Como hacer un gdb backtrace
264 ===========================
266 Backtraces pueden ayudarnos a arreglar errores que hicieron que Window Maker falle.
267 Si encuentra un bug que hace fallar a Window Maker, por favor envie un backtrace con su
268 reporte de error.
270 Para hacer un backtrace útil, necesita un archivo core con información de depuración
271 producida por Window Maker cuando falló. Debería haber sido instalado sin stripping también.
273 Para compilar wmaker con información de depuración:
275 ./configure
276 make CFLAGS=-g
278 Si obtiene el cuadro de diálogo que le dice que wmaker falló y le 
279 pregunta que hacer, respóndale "Abortar y dejar un archivo core"
281 script
282 cd src
283 gdb .libs/wmaker path_to_the_core_file
285 Luego, en el prompt gdb escriba "bt". Salga de gdb escribiendo "quit"
286 y luego, en el prompt del shell, scriba "exit"
288 El archivo llamado typescript contendrá el backtrace.
290 Derechos de Autor y Descargo de Responsabilidad
291 ===============================================
293 Window Maker está registrado por Alfredo K. Kojima y está licensiado por la 
294 Licensia Pública General GNU. Lea el archivo COPYING para leer la licensia
295 completa.
297 Los íconos que son distribuidos con este programa y fueron hechos por Marco
298 van Hylckama Vlieg, están licenciados por la Licencia Pública General GNU. 
299 Lea el archivo COPYING para leer la licencia completa.
301 Los íconos listados en COPYING.WTFPL y son distribuidos en este programa
302 fueron hechos por Banlu Kemiyatorn (]d), están licenciados por la 
303 "do What The Fuck you want to Public License". Lea el archivo COPYING.WTFPL
304 para leer la licencia completa.
306 NeXT, OpenStep y NEXTSTEP son marcas registradas de NeXT Computer, Inc.
307 Todas las otras marcas registradas son propiedad de sus respectivos dueños.
309 Los autores se reservan el derecho de hacer cambios en el software sin previo
310 aviso.
312 Autores
313 =======
315 Alfredo K. Kojima <kojima@windowmaker.info>
316 Dan Pascu <dan@windowmaker.info>
317 ]d <id@windowmaker.info>
319 Por favor no nos haga preguntas antes de leer la documentación (especialmente 
320 la FAQ, este archivo y los archivos INSTALL) y sobre cosas "cool" que ve en
321 las capturas de pantalla del escritorio de las personas.
323 El archivo AUTHORS contiene una lista de las personas que han contribuido 
324 con el proyecto. El nombre de las personas que han ayudado con localization 
325 (traducción) se puede encontrar en po/README y Window Maker/README
327 Si tiene algún comentario, arreglos y reportes de errores (complete BUGFORMs)
328 y enviémelos a developers@windowmaker.info
332 traducido por Efraín Maximiliano Palermo <max_drake2001@yahoo.com.ar>