Cleanup (first stage) docs/mans.

CVS patchset: 297
CVS date: 2001/07/17 15:40:14

15 files changed, 181 insertions, 1162 deletions

diff --git a/configure.in b/configure.in
index b75812b8e..23927763b 100644
--- a/configure.in
+++ b/configure.in
@@ -540,12 +540,11 @@ misc/Makefile
 misc/xine-config
 m4/Makefile
 doc/Makefile
-doc/FAQ
 doc/man/Makefile
 doc/man/en/Makefile
-doc/man/en/xine.1
+doc/man/en/xine-lib.3
 doc/man/fr/Makefile
-doc/man/fr/xine.1
+doc/man/fr/xine-lib.3
 misc/xine-lib.spec
 misc/SlackBuild
 misc/build_rpms.sh],
diff --git a/doc/FAQ-lib b/doc/FAQ-lib
new file mode 100644
index 000000000..3e2e4861f
--- /dev/null
+++ b/doc/FAQ-lib
@@ -0,0 +1,75 @@
+
+   ----------------------
+        xine-lib FAQ
+   ----------------------
+
+
+how do I build this beast?
+--------------------------
+
+first make sure you use a stable, official release of gcc to compile.
+You can try patched gcc versions, but these are not supported and will 
+probably not work (pgcc for example is known to make libmpeg break).
+
+./cvscompile.sh  <--- only neccessary if you checked xine out of CVS
+./configure
+make
+make install
+
+
+how can I supply additional CFLAGS for the compilation ?
+--------------------------------------------------------
+
+you can do so by setting the GLOBAL_CFLAGS variable and then run 
+configure again.
+
+This can be usefull to specify additional include paths or library 
+paths to the compiler. Example:
+
+export GLOBAL_CFLAGS="-I/usr/include -L/home/guenter/xine_libs"
+
+
+Are there binaries for my K7 available? Can I build them?
+---------------------------------------------------------
+
+At the moment we do not provide K7 binaries, since the latest
+stable gcc version (2.92.2 at the time of this writing) doesn't
+have K7 support. Use the 686 binaries instead. These binaries 
+should run ok and will use 3DNow!
+
+If you have a newer gcc you can try to compile "more" k7 support
+in (esp. better instruction sheduling). If the configure script
+should fail to detect your processor/gcc correctly, try setting the 
+XINE_BUILD envvar explicitly to a valid description string for 
+your configuration, e.g.
+
+export XINE_BUILD=k7-pc-linux-gnu
+rm -f config.cache
+./autogen.sh
+make
+make install
+
+
+where and how do I get the latest development version?
+------------------------------------------------------
+
+check it out of our CVS:
+
+cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine login
+
+<empty password>
+
+cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine co xine-lib
+
+
+I think I found a bug!
+----------------------
+
+xine is in it's early developement stages. Please be patient.
+If you got time, please contact us and send us a full bug report.
+Please include all xine console output and some details about
+your hardware and operating system.
+
+You can reach us via email:
+
+  Xine Mailing List <xine-user@lists.sourceforge.net>
diff --git a/doc/FAQ-lib_es b/doc/FAQ-lib_es
new file mode 100644
index 000000000..45a4eb7c8
--- /dev/null
+++ b/doc/FAQ-lib_es
@@ -0,0 +1,74 @@
+
+   ----------------------
+        Xine-lib FAQ
+   ----------------------
+
+
+¿ cómo construyo esta bestia ?
+------------------------------
+
+Primero asegúrese de usar un gcc estable, una bajada oficial del gcc para 
+compilar.
+Puede probar versiones del gcc remendadas (patched), pero estas no son 
+soportadas y probablemente no funcionen (por ejemplo el pgcc conocido para 
+hacer libmpeg falla).
+
+./autogen.sh  <--- solo necesario si comprobara Xine sin CVS
+./configure
+make
+make install
+
+
+¿ Como puedo proporcionar los  CFLAGS adicionales para la recompilación ?
+-------------------------------------------------------------------------
+
+Puede poner el GLOBAL_CFLAGS variable y configurarlo de nuevo.
+
+Éste puede ser usado par especificaciones adicionales que incluyan paths o 
+paths de bibliotecas ( library paths) al recompilar. Ejemplo:
+
+export GLOBAL_CFLAGS="-I/usr/include -L/home/guenter/xine_libs"
+
+
+¿ Hay binarios disponibles para mi K7 ? ¿ Puedo construirlos ?
+--------------------------------------------------------------
+
+Por el momento nosotros no proporcionamos binarios para el K7, no hay soporte 
+para K7 desde la última versión estable del gcc (2.92.2 cuando se escribió esto).
+Use en cambio los binarios para el 686. ¡Estos binarios funcionan bien y usan 
+3DNow!
+
+Si tiene un gcc más nuevo puede intentar compilar par el K7 obteniendo "más" 
+soporte (especialmente mejor cobertura de instrucciones). Si la configuración 
+del script falla al detectar su procesador/gcc correctamente pruebe configurar 
+XINE_BUILD explícitamente para validar la descripción del string para su 
+configuración por ej.:.
+
+export XINE_BUILD=k7-pc-linux-gnu
+rm -f config.cache
+./cvscompile.sh
+make
+make install
+
+
+
+¡ Creo que encontré un error (bug) !
+------------------------------------
+
+Xine esta en una fase temprana de desarrollo. Por favor sea paciente.
+Si tiene tiempo, por favor contáctenos y envíenos un reporte completo sobre 
+el error.
+Por favor incluya completamente toda la salida de la consola de Xine y algunos 
+detalles sobre su hardware y sistema operativo.
+
+Puede localizarnos vía correo electrónico:
+
+  Lista de correo de Xine (Xine Mailing List) <xine-user@lists.sourceforge.net>
+
+
+***********************************************************************
+***  Nota del traductor: he tratado de mantener la fidelidad del    ***
+***  artículo original en inglés lo mayor posible, por comentarios  *** 
+***  sobre la traducción, comunicarse con Alfredo J. Delaiti        ***
+***  alfredodelaiti@netscape.net                        ***
+***********************************************************************
diff --git a/doc/FAQ_es.in b/doc/FAQ_es.in
deleted file mode 100644
index c6df6d67c..000000000
--- a/doc/FAQ_es.in
+++ /dev/null
@@ -1,471 +0,0 @@
-
-   ----------------------
-         Xine FAQ
-   ----------------------
-
-
-¿ cómo construyo esta bestia ?
-------------------------------
-
-Primero asegúrese de usar un gcc estable, una bajada oficial del gcc para 
-compilar.
-Puede probar versiones del gcc remendadas (patched), pero estas no son 
-soportadas y probablemente no funcionen (por ejemplo el pgcc conocido para 
-hacer libmpeg falla).
-
-./autogen.sh  <--- solo necesario si comprobara Xine sin CVS
-./configure
-make
-make install
-
-
-¿ Como puedo proporcionar los  CFLAGS adicionales para la recompilación ?
--------------------------------------------------------------------------
-
-Puede poner el GLOBAL_CFLAGS variable y configurarlo de nuevo.
-
-Éste puede ser usado par especificaciones adicionales que incluyan paths o 
-paths de bibliotecas ( library paths) al recompilar. Ejemplo:
-
-export GLOBAL_CFLAGS="-I/usr/include -L/home/guenter/xine_libs"
-
-
-¿ Hay binarios disponibles para mi K7 ? ¿ Puedo construirlos ?
---------------------------------------------------------------
-
-Por el momento nosotros no proporcionamos binarios para el K7, no hay soporte 
-para K7 desde la última versión estable del gcc (2.92.2 cuando se escribió esto).
-Use en cambio los binarios para el 686. ¡Estos binarios funcionan bien y usan 
-3DNow!
-
-Si tiene un gcc más nuevo puede intentar compilar par el K7 obteniendo "más" 
-soporte (especialmente mejor cobertura de instrucciones). Si la configuración 
-del script falla al detectar su procesador/gcc correctamente pruebe configurar 
-XINE_BUILD explícitamente para validar la descripción del string para su 
-configuración por ej.:.
-
-export XINE_BUILD=k7-pc-linux-gnu
-rm -f config.cache
-./autogen.sh
-make
-make install
-
-
-Xine falla diciendo: "no video port found" (no se encontró puerto de vídeo)
----------------------------------------------------------------------------
-
-Usted tiene la extensión de vídeo Xv, pero su driver de la tarjeta de vídeo 
-no lo soporta. Primero trate de encontrar un driver para sus hardware que 
-soporte Xv (chequee en su vendedor de su placa de vídeo). Si su driver tiene 
-soporte para Xv pero no puede hacerlo funcionar, intente bajar más la 
-resolución (una resolución de 1024x768 es todavía bastante buena para 
-anamorphic mpeg-2).
-
-Si todo falla, use la opción "-s" que forzara a Xine a usar la salida con 
-Xshm (recuerde cambiar la profundidad de color a 16bpp para tener velocidad).
-
-xine -s foo.vob
-
-
-Xine falla quejándose de los dispositivos/drivers de audio
-----------------------------------------------------------
-
-Pude seleccionar el driver de audio usando la opción -A . Pruebe así:
-
-xine -A null
-
-Si tiene los drivers ALSA instalados, pruebe:
-
-xine -A alsa
-
-
-¿ Xine muestra su logo pero no veo mi vídeo ?
----------------------------------------------
-
-Use el botón de play del reproductor o presione RETORNO ó ENTRADA para 
-REPRODUCIR.
-
-
-Xine reproduce el audio pero no veo la película
------------------------------------------------
-
-Si ve algunos mensajes de "rechazo" , es porque su  hardware no esta bien 
-configurado para Xine. Podría ser que su placa de sonido no soporte las 
-característica en "tiempo real" (Xine cuando se inicia realiza pruebas, 
-podría mirar de nuevo estos mensajes que da). Pruebe entonces encontrar los 
-mejores drivers.
-
-Tal vez su hardware sea simplemente lento - vea si le da los siguientes 
-mensajes para la velocidad: "Xine drops a lot of frames" (Xine descartó algunos 
-cuadros).
-
-Si esta usando Xv y la salida de vídeo se queda en blanco, pruebe mover la 
-ventana alrededor de la pantalla o llevarla a pantalla completa (tecla "F").
-Hay una bug (falla) en la configuración del revestimiento [Repárame].
-
-
-¿ Dónde debo poner lo códigos dlls de windows para Xine ?
----------------------------------------------------------
-
-guárdelos en:
-
-@w32_path@
-
-Xine se cuelga cuando intento reproducir archivos AVI
------------------------------------------------------
-
-El soporte para los códigos win32 es todavía experimental. Debería funcionar 
-bien si su sistema reúne esto requisitos:
-
-- Funciona el driver par Xv 
-- Los archivos AVI contienen audio en formato mpeg
-- Tiene los codecs instalados correctamente en: @w32_path@
-
-
-Obtengo el siguiente mensaje: demux error! 00 00 00 (should be 0x000001)
-------------------------------------------------------------------------
-
-Probablemente Xine no puede acceder a su fuente de entrada. La mayoría de las 
-veces esto pasa cuando está intentado reproducir DVDs cerrados/encriptados 
-(protección de zona). Recuerde que Xine no puede reproducir estos DVDs de una 
-< sin tener que hacer ningún otro trabajo> (por razones legales). 
-
-Podría usar una entrada para el DVD con un plugin css-enabled (habilitador css) 
-para evitar esto.
-
-Otra razón podría ser que su (RPC-2) de su reproductor de DVD no este ajustado 
-a la región correcta.
-
-
-Obtengo mensajes como los siguientes: "Ouch! lastPTS : 100657583 current 
-pts : 100652798"
-------------------------------------------------------------------------
-
-Apunte sus miradas al driver de su placa de sonido, falla el driver al 
-proporcionar en tiempo exacto la información. Intente encontrar mejores 
-drivers (oss <-> alsa).
-
-Si esta usando alsa, asegúrese  de que Xine este usando el alsa nativo API y no 
-la emulación del oss. Use:
-
-xine -A alsa
-
-Me pone lo siguiente varias veces: "200 frames delivered, 200 frames skipped, 
-0 frames discarded" ("200 cuadros liberados", 200 cuadros saltados, 0 cuadros 
-descartados")
------------------------------------------------------------------------------
-
-Observe que ha seleccionado mal un canal de audio o está intentando reproducir 
-un stream (secuencia de cuadros) que usa características que Xine no soporta 
-(por ahora).
-
-
-Cuando reproduzco un stream, Xine muestra algunos cuadros pero no hay sonido
-----------------------------------------------------------------------------
-
-Pruebe otro canal de sonido:
-
-xine -a channel stream.vob
-
-Algunos archivos .vob tienen el sonido en canales extraños (ej. 3, 7, 10)
-
-
-¿ Puede Xine reproducir SVCDs ?
--------------------------------
-
-Si, pero tendrá que experimentar con los canales de sonido
-
-xine -a channel VCD://<track number>    (número de pista)
-
-Normalmente, encontrara el canal de sonido en la pista (track) #8 y, para  
-SVCDs bilingües en la #9, así
-
-xine -a 8 
-
-Apretando el botón de "vcd" le permitirá reproducir sus SVCDs
-
-
-Xine pierde algunos de los cuadros
-----------------------------------
-
-Su hardware es demasiado lento para Xine. Asegúrese de activar todas las 
-opciones de optimización de velocidad. Unos pocos puntos deberá constatar:
-
-- usar un kernel reciente optimizado para su hardware
-
-- usar el último gas/gcc
-
-- cerrar otras aplicaciones (use una herramienta como "top" para encontrar que 
-  aplicaciones están usando su CPU)
-
-- si no esta usando Xv, asegúrese de tener ajustada la resolución de la placa 
-  de vídeo en 16bpp y no en  24 o superior (reducen el ancho de banda)
-
-- asegúrese que la unidad de disco duro que proporciona los datos de vídeo esta 
-  en modo DMA (si lo soporta) 
-  Bajo linux, puede usar hdparm para verificar esto, por ejemplo:
-
-  hdparm /dev/hda
-
-  =>
-  ...
-   using_dma    =  1 (on)
-
-  más información sobre esto la puede encontrará aquí:
-
-  http://oreilly.linux.com/pub/a/linux/2000/06/29/hdparm.html
-
-- Xine necesita memorias de acceso de alta velocidad que dependen de su chip 
-  set.
-  Asegúrese de habilitar todas las opciones que permitan mejorar la velocidad. 
-
-  Especialmente el chipset via apollo pro es conocido a pesar de ser un poco 
-  raro, (la mayoría de mis motherboard gigabyte). Si no puede configurar la 
-  ram accediendo a la bios podría querer realmente probar algunos trucos sucios,
-  como explico más adelante (por ejemplo)
-         http://www.overclockers.com/tips105/index03.asp
-  este sitio web se centra sobre herramientas bajo Windows  para tocar el 
-  chipset, puede hacer lo mismo en FreeBSD con pciconf. En algunas 
-  distribuciones de linux hay herramientas similares.
-
-  Por favor contáctese con Heiko si tiene cualquier problema o consejos sobre 
-  omo tocar el chipset via apollo pro.
-
-- Una buena herramienta para mejorar el desempeño la puede encontrar aquí:
-
-  http://powertweak.sourceforge.net
-
-- habilite el soporte para MTRR en su kernel. Si esta usando todavía el XFree 
-  3.x, tendrá que decirle al kernel donde esta la memoria gráfica.
-  Encontrará detalles sobre esto en el howto para dvd de linux.
-
-  Si está usando XFree 4.x habilitando el soporte para MTRR debería ser 
-  suficiente.
-
-  Pruebe cat /proc/mtrr - si el archivo existe y encuentra una entrada 
-  correspondiente a la cantidad de memoria que posee su placa de vídeo, todo 
-  debería estar bien.
-
-- configure y use dispositivos raw para acceder al dvd
-
-  dispositivos raw deben estar disponibles en linux con kernel 2.4.x y hay 
-  parches para kernels viejos disponibles en:
-
-  ftp://ftp.kernel.org/pub/linux/kernel/people/sct/raw-io/
-
-  para usar dispositivos raw, primero conecte un dispositivo raw libre a su 
-  dispositivo dvd, use algo como:
-
-  raw /dev/raw1 /dev/hdc
-
-  luego cree un enlace (link) llamado "rdvd" que apunte a  ese dispositivo raw
-
-  ln -s /dev/raw1 /dev/rdvd
-
-
-¿ Como hago que la extensión Xv trabaje ?
------------------------------------------
-
-Primero necesita instalar/usar el XFree 4.x. Una vez que los tenga asegúrese 
-que los drivers del Xfree que esta usando están soportando Xv en su hardware. 
-Aquí están algunos lugares donde buscar los drivers convenientes:
-
-g200/g400    : xfree 4.x suporta a estas de una (sin tener que hacer ningún 
-               otro trabajo)
-placas nvidia: www.nvidia.com (tiene los drivers binarios)
-placas ATI   : GATOS www.linuxvideo.org/gatos/
-i815         : el último código xfree 4.x soporta a estos
-3dfx (voodoo): el último código xfree 4.x soporta a estos
-
-
-El AC3 vía S/PDIF no funciona con mi placa de sonido
-----------------------------------------------------
-
-El AC3 vía S/PDIF es soportado por ALSA solo en placas de sonido con chips 
-Trident 4DWaveNX y YMF. Entonces si posee una placa de sonido con uno de esos 
-chips use:
-
-xine -S -A alsa 
-
-La opción  -S deshabilita el decodificador interno AC3. En máquinas muy lentas 
-puede mejorar la reproducción del vídeo (sacando el sonido) cuando inicializa 
-Xine con:
-
-xine -S -A null
-
-
-
-¿ Dónde y como obtengo la última versión de desarrollo ?
---------------------------------------------------------
-
-consulte fuera de nuestra CVS:
-
-cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine login
-
-<empty password>
-
-cvs -d :pserver:anonymous@cvs.xine.sourceforge.net:/cvsroot/xine co xine
-
-
-
-¿ Cómo uso el plugin para el dvd ?
-----------------------------------
-
-Lo primero de todo:
-El plugin para dvd entregado actualmente con Xine no soporta la reproducción de
-dvds cerrados y/o encriptados. Necesitara programas externos o algo "mejor" 
-como el Xine_dvd_plugin para ver éstos DVDs directamente con Xine. Por supuesto
-podrá reproducir archivos mpeg2 tras la desencriptación (hablando técnicamente)
-que es la película en el dvd usando Xine con la ayuda de unos programas 
-adicionales.
-Debido a la situación incierta con respecto al la legalidad de la encriptación 
-del css nosotros no hemos incluido nada de esta naturaleza en la distribución 
-de Xine, ni tampoco hacemos apoyo del uso de dicho software (deberá verificar 
-si el uso de dicho software es legal donde usted vive).
-Nosotros esperamos que esta situación cambie pronto.
-
-Para dvds abiertos/no encriptados es una buena idea primero verificar que 
-archivos hay en el dvd montándolo. Los archivos se llaman algo así como 
-.../VIDEO_TS/VTS_xx_x.VOB, donde las x son números.
-Si busca los archivos que terminan con mayúsculas .VOB en el dvd, probablemente
-estas sean las películas dentro de él. Actualmente no se soporta la unión (de 
-los capítulos) en la reproducción de las películas - deberá reproducir 
-individualmente cada una de las partes.
-
-Para reproducir estos archivos VOB use algo como lo siguiente:
-
-xine dvd://VTS_xx_x.VOB
-
-Asegúrese de no proporcionar ningún nombre de camino (no VIDEO_TS/) y use 
-letras mayúsculas para los nombres de los archivos.
-
-Xine trata de abrir el dvd usando /dev/cdrom. En freebsd solamente funcionara 
-por el momento si crea un enlace simbólico entre su dvd y el nodo del 
-dispositivo.
-
-
-Incapacidad de abrir el dispositivo dvd (/dev/dvd) 
---------------------------------------------------
-
-Probablemente no tenga  /dev/dvd (verifique esto). En este caso, simplemente 
-cree un enlace /dev/dvd que apunte a su dispositivo DVD. 
-Algo como
-
-cd /dev
-ln -s hdc dvd
-
-debería hacer el trabajo.
-
-
-¡ La relación de aspecto es incorrecta !
-----------------------------------------
-
-Pruebe apretando "A" (preferiblemente cuando Xine esta detenido, de lo 
-contrario puede experimentar un fallo de segmentación).
-
-
-¿ Como puedo reproducir desde STDIN ?
--------------------------------------
-
-use algo como lo siguiente
-
-cat stream.mpg | xine stdin://mpeg1
-
-o, si tiene archivos mpeg-2 use
-
-cat stream.vob | xine stdin://mpeg2
-
-
-¿ Como puedo cambiarle la apariencia (skin) ?
----------------------------------------------
-
-Ejecute por lo menos una vez Xine - escribirá su archivo de configuración 
-.xinerc en su directorio home. Ahora edite ese archivo y cambie la linea 
-"skin:default" para que corresponda a la apariencia que le gustaría que use.
-
-
-¿ Como puedo cambiar el color/brillo/contraste ?
-------------------------------------------------
-
-Por el momento esto solo es soportado por algunos drivers Xv. Encontrará tres 
-entradas en su ~/.xinerc como estas:
-
-brightness:0
-saturation:0
-contrast:128
- 
-los valores y los rangos posibles dependen de su driver Xv, así tendrá que 
-experimentar un poco para obtener una buena imagen.
-
-
-¡ Algunas partes de mi Escritorio (X Desktop) se ponen transparentes cuando 
-Xine reproduce el vídeo !
----------------------------------------------------------------------------
-
-Mire un poco los colores de su GUI correspondientes a la llave de color(en 
-inglés colorkey = color especial usado por mecanismos de overlay para
-reemplazar partes de un cuadro) usados por Xv. Puede cambiar la valoración 
-de esta llave de color para evitar esto. Tiene que haber una línea como:
-
-colorkey:2110
-
-en su ~/.xinerc donde puede cambiar el color usado por Xine para el 
-revestimiento de vídeo.
-
-
-No consigo sonido, pero "el driver de audio 'oss' fallo, uso entonces los 
-drivers nulos."
--------------------------------------------------------------------------
-
-Antes de nada, asegúrese que su drivers de Audio OSS esta funcionando (por 
-ejemplo reproduce música con otro software).
-
-La razón mas común de esto es que otro programa esta accediendo a su 
-dispositivo de audio. Si esta usando linux, el comando "fuser /dev/dsp" debe 
-dar el PID del proceso.
-
-Si esta usando GNOME, las oportunidades son, que esto este causado por esd. 
-Simplemente desactive  esd (temporalmente), clikeando con el botón derecho en 
-el programa (applet) de control de sonido y seleccionado "Place Esound in 
-standby" (Ponga en espera a Esound). Todos lo sonido de GNOME serán 
-desactivados. Pero probablemente quiera escuchar su película, de cualquier 
-manera ;-)
-
-
-Después de correr Xine varias veces falla en ubicar la memoria asignada!
-------------------------------------------------------------------------
-
-Esto debe arreglarse en Xine 0.3.3 o superior. Sin embargo, eso solo puede 
-funcionar si se sale de Xine de la manera "correcta" (ej. usando el panel o 
-presionando la tecla "q").
-No cierre simplemente la ventana de salida de vídeo usando su manejador de 
-ventanas (window manager) - Xine no liberará la memoria compartida en ese 
-caso (!).
-
-
-Tengo problemas cuando uso Xine en BSD
---------------------------------------
-
-Verifique si encuentra lo que está buscando en el archivo README.freebsd
-
-
-¡ Creo que encontré un error (bug) !
-------------------------------------
-
-Xine esta en una fase temprana de desarrollo. Por favor sea paciente.
-Si tiene tiempo, por favor contáctenos y envíenos un reporte completo sobre 
-el error.
-Por favor incluya completamente toda la salida de la consola de Xine y algunos 
-detalles sobre su hardware y sistema operativo.
-
-Puede localizarnos vía correo electrónico:
-
-  Lista de correo de Xine (Xine Mailing List) <xine-user@lists.sourceforge.net>
-
-
-***********************************************************************
-***  Nota del traductor: he tratado de mantener la fidelidad del    ***
-***  artículo original en inglés lo mayor posible, por comentarios  *** 
-***  sobre la traducción, comunicarse con Alfredo J. Delaiti        ***
-***  alfredodelaiti@netscape.net                        ***
-***********************************************************************
diff --git a/doc/Makefile.am b/doc/Makefile.am
index c5a66f068..4396f0a48 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -4,7 +4,7 @@ SUBDIRS = man
 EXTRA_DIST = $(docs_DOCS) MRL.txt dataflow.dia xine-lib-API.cfg
 
 docdir = $(prefix)/share/doc/xine
-docs_DOCS = README README.syncfb README.freebsd FAQ bug_report_form
+docs_DOCS = README-lib.solaris FAQ-lib FAQ-lib_es
 
 
 install-data-local:
diff --git a/doc/README b/doc/README
deleted file mode 100644
index 50d81b40e..000000000
--- a/doc/README
+++ /dev/null
@@ -1,343 +0,0 @@
-
-   ----------------------
-            xine
-   ----------------------
-
-     a unix video player
-
-
-
-about xine:
------------
-
-xine is a free gpl-licensed video player for unix-like systems.
-We support mpeg-2 and mpeg-1 system (audio + video multiplexed) streams,
-mpg audio files and AVI files (using win32 codec dlls).
-
-xine plays the video and audio data of the stream and synchronizes
-the playback of both. Depending on the properties of the stream,
-playback will need more or less processor power, full frame rate
-for mpeg-2 has been seen on a 400 MHz P II system.
-
-xine can play Video CDs, SVCDs and DVDs directly. Unfortunately the legal
-status of encrypted/locked DVD playback is uncertain in some countries
-so we cannot include any DVD unlock/decrypt code with xine. To play back
-such DVDs you'll need external programs or something like a
-xine_dvd_plugin that can handle DVD authentification/descrambling.
-
-xine tries to be straightforward and effective. ...no bells and
-whistles are being developed at this time ;-) first we want to achieve
-good playback of video.
-
-
-supported platforms / requirements:
-----------------------------------
-
-- xine needs a locally attached graphics device and monitor (playback over
-  x is not supported at the moment and will probably never be really useful
-  because of the enormous bandwidth of decoded video streams).
-- xine needs either MIT-SHM (The MIT Shared Memory Extension), which is
-  supported in XFree86 for quite some time (3.3.x will be fine),
-  or X-Video Extension (Xv) which is faster and supports fullscreen
-  operation but is only provided by some XFree86 4.x drivers.
-  nVidia chips and Matrox G200 and G400 are known to work.
-- if you can't get Xv to run on your platform you should use 16bpp 
-  colordepth for speed. Xv seems to work nicely for 16 and 24bpp.
-- if you have a mga 200 / 400 graphics adaptor you can optionally
-  use the sybcfb/teletux video ouput driver. See README.syncfb for 
-  details.
-- you need a sound driver that is realtime capable (not all
-  OSS/ALSA drivers support that feature) or ESD
-
-xine has so far been sucessfully used on the following systems:
-
-- Linux on a Pentium III 667
-  using XFree86 4.01 on a nVidia Riva TNT 2
-- Linux on a Pentium II 400
-  using XFree86 3.3.6, 4.0, 4.01 and 4.02 on a nVidia Riva TNT
-- FreeBSD 4.1-Release on a Celeron 400
-  using XFree86 3.3.6 and 4.0.1 on a Matrox G400
-- Linux on a Pentium 120 (no MMX)
-  using XFree86 3.3.5 on a Trident 9660
-- Linux on an AMD K6-266
-  using XFree86 3.3.5 on a ATI AIW M64-8Mb PCI
-- Linux on an AMD K6-III 450
-  using XFree86 3.3.6 on a ATI RageII 8MB
-- Linux on a Celeron 633
-  using XFree86 4.0.1 on a ATI AIW Rage128-16MB
-- Linux on a Amd K7@550
-  using Xfree 4.0.1 on a Ati Rage 128 16 Mb 
-  (Xv is working on this configuration with drivers from GATOS project)
-- Linux on a Celeron 667
-  using XFree86 4.0.2 on a Riva TNT 16Mb 
-  (Xv is working on this configuration with closed-sources drivers
-  version 0.9.5 from NVidia).
-- Linux on a Amd K6-2@475
-  using XFree86 4.1.0 on a 3dfx voodoo3 2000 PCI 16Mb 
-  (Xv is working on this configuration)
-- Solaris 8 on Intel
-  using Xsun on a ATI Xpert@Work & Xpert98 (3D RAGE PRO)
-  see README.solaris for more infomation
-
-non-intel platforms:
-- Solaris 8 on SPARC
-  using Xsun on a Creator-3D framebuffer
-  see README.solaris for more infomation
-
-usage:
-------
-
-You can start xine without any command line parameters or you can 
-specify one or more input streams directly. Xine tries to detect wheter 
-it can use the Xv extension and will fall back to XShm, but that 
-detection might fail.
-If you don't see any video, first check your X11 drivers (for example
-only the binary drivers from nVidia have Xv support for their chips).
-If you can't get Xv to work, use the "-s" option and xine will be
-forced to use Xshm.
-If you get very sloppy video ouput your sound driver may not be
-realtime capable. Try to use ALSA instead or, if you're already using
-ALSA you might want to give OSS a try.
-If you want to send the sound over a network with ESD, set the ESPEAKER
-environment variable before starting xine.
-
-The input stream can be a filename or something we call 
-"MediaResourceLocator" MRL, which looks similar to a URL. First you
-specify an input source which is followed by "://" and an input-source
-specific identifier. What input sources you can use depends on the
-input plugins you have (for plain files you can omit the input-source
-identifier). Try 
-
-$ xine --help
-
-to get the complete usage.
-
-Unfortunately the gui does not yet support the MRL concept to any
-great extend, so to use any other input source than plain files you'll
-have to use the command line at the moment. That will change soon :-)
-
-Example usage:
-
-$ xine
-
-$ xine /path/foo.vob
-
-$ xine -s /foo/test.mpg
-
-xine supports the xdnd protocol (Version 3) so if you have a file browser 
-application supporting that protocol (e.g. gmc) you can drop video files
-on xine for playback.
-
-Playing track 3 from a VCD:
-
-$ xine vcd://3
-
-Example for direct DVD access:
-
-$ xine dvd://VTS_01_1.VOB
-
-Keyboard shortcuts:
--------------------
-
-Key           action
-
-RETURN        play
-F             toggle fullscreen mode
-Q             quit
-0             jump start of current stream
-1-9           jump to 10-90% of current stream
-SPACE         pause
-PgUp/Prior    jump to previous playlist entry
-PgDown/Next   jump to next playlist entry
-A             toggle aspect ratio (AUTO/16:9/4:3/DVB)
-Ctrl          show/hide mouse cursor
-
-more to come.
-
-Click right on the video window to toggle panel visibility.
-
-selecting audio channels:
--------------------------
-
-Supply the -a option to select the desired audio track:
-
-xine -a 3 test.mpg
-
-plays the third mpg audio track (and the video, of course).
-
-For mpeg-1, only mpeg audio (layer 1, 2 and 3) is supported.
-
-Mpeg-2 streams can have different types of audio streams, though.
-Xine supports ac3 (dolby digital), mpeg and LPCM sound. These
-are mapped to the following tracks:
-
-Track    selected audio stream
-
- 0- 7    ac3 stream 0-7
- 8-15    mpg audio stream 0-7
-16-23    pcm audio stram 0-7
-
-example: to play pcm stream 0 use
-
-xine -a 16 file.vob
-
-selecting subtitles:
---------------------
-
-Subtitles are embedded in different tracks like audio. In general,
-track 0 is the default language subtitle. Use the -u option to 
-select the desired subtitle track:
-
-xine -u 0 test.vob
-
-displays the subtitles from stream 0.
-
-controlling xine via CORBA:
----------------------------
-
-Xine implements a CORBA server interface to enable remote control and
-scripting. For this, you need ORBit which should already be installed if
-you are using GNOME. Otherwise you can get it from
-
-  http://orbit-resource.sourceforge.net/
-
-Any version of ORBit >= 0.4.0 should work fine.
-
-To enable the CORBA interface, you need to supply the "--enable-corba"
-argument to the ./configure script and recompile xine.
-
-The xine server interface definition can be found in "corba/xine.idl" which
-gets installed to "/usr/share/idl/xine.idl" by default.
-
-To communicate with xine via CORBA, you need to get its IOR (Interoperable
-Object Reference). Upon startup, xine writes it to the file ~/.xine.ior
-where you can read it from. If the ORBit name service is running, xine
-also registers itself there under the name "Xine". Unfortunately, the
-ORBit name server is usually not activated by default. You have to run
-it manually like this:
-
-  orbit-name-server >/tmp/name-service-ior &
-
-See the ORBit docs for more information.
-
-Two example client programs are provided:
-  1. "xine-remote" is an example client written in C which can be used to
-     send play/stop/pause commands to a running instance of xine
-  2. "example.py" is a small Python script that demonstrates how to easily
-     control xine from a scripting language
-
-using LIRC with xine:
----------------------
-
-Xine can be remotly controlled with by IR. For this, you should have
-LIRC installed (http://www.lirc.org), you should get latest CVS snapshot
-if you're running latest Linux kernels (2.2 or 2.4 series). 
-
-You should add some entries in your ~/.lircrc, like this:
-begin
-	remote = SAMSUNG
-	button = Button_Play
-	prog   = xine
-	repeat = 0
-	config = PLAY
-end
-begin
-	remote = SAMSUNG
-	button = Button_Src
-	prog   = xine
-	repeat = 0
-	config = DVD
-end
-begin
-	remote = SAMSUNG
-	button = Button_1
-	prog   = xine
-	repeat = 0
-	config = 10%
-end
-...
-
-All valids strings orders are:
-
- - for quiting:
-      quit
- - for set the current position in current stream playback:
-      0%, 10%, 20%, 30%, 40%, 50%, 60%, 70%, 80%, 90% 
- - for play or stop:
-      play
- - for pausing:
-      pause
- - for eject:
-      eject
- - for next/previous MRL in the playlist:
-      next, prev
- - for next/previous audio track selection:
-      audio+, audio-
- - for next/previous sub-title selection:
-      spu+, spu-
- - to get the playlist from a DVD/VCD:
-      dvd, vcd
- - to hide/show the GUI, the output video window:
-      hidegui, hideoutput
- - to toggle the output video window<->fullscreen
-      fullscr
-
-All of orders are not case sensitive.
-
-used software:
---------------
-
-xine uses software from the following free software projects:
-
-- libac3 by Aaron Holtzman
-- libmpeg2 by Aaron Holtzman
-- libmpg123 of the mpg123 project by Michael Hipp
-  (see http://www.mpg123.de/)
-
-...without these great pieces of software xine would of course not
-be where it is now.
-
-also many thanks to the Linux Video and DVD Project "LiViD"
-(http://www.linuxvideo.org/), where the original ideas for the xine
-video player came from.
-
-developers of xine:
--------------------
-
-  main xine developer:
-    Guenter Bartsch
-
-  various suggestions, bug and build fixes, alsa plugin, gui
-    Daniel Caujolle-Bert <f1rmb@users.sourceforge.net>
-
-  audio programming
-    Siegfried Langauf <siggi@users.sourceforge.net>
-
-  contributes great libmpeg2 hacks:
-    Michael Lespinasse
-  
-  ...plus various other contributors, see the AUTHORS file
-
-
-contacting the xine project:
-----------------------------
-
-  the xine project website is
-
-       http://xine.sourceforge.net
-
-  feedback or offers for help are greatly appreciated, please contact
-
-
-      The Xine User Mailing List <xine-user@lists.sourceforge.net>
-                                 =================================
-
-
-  If, for some reason, you can't post to the list, you may contact the authors
-  directly:
-
-  Guenter Bartsch <guenter@users.sourceforge.net>
-  Daniel Caujolle-Bert <f1rmb@users.sourceforge.net>
-  Siegfried Langauf <siggi@users.sourceforge.net>
-
-  $Id: README,v 1.4 2001/06/22 10:40:46 jkeil Exp $
diff --git a/doc/README-lib.solaris b/doc/README-lib.solaris
new file mode 100644
index 000000000..4926d2e3d
--- /dev/null
+++ b/doc/README-lib.solaris
@@ -0,0 +1,14 @@
+building xine-lib on solaris
+----------------------------
+
+* Compile xine with GNU make (gmake, /opt/sfw/bin/gmake)
+
+* If you get a "fatal: relocation error" ... "symbol __divdi3:
+  referenced symbol not found" error when running xine, re-configure 
+  xine-lib with gcc as the linker command (env LD=gcc configure ...)
+
+* To get VIS accelerated MPEG decoding and colour space conversion 
+  on Solaris SPARC, download and install Sun's mediaLib 2.0, available
+  here:
+
+    http://www.sun.com/sparc/vis/mediaLib.html
diff --git a/doc/README.freebsd b/doc/README.freebsd
deleted file mode 100644
index 72d5f2e65..000000000
--- a/doc/README.freebsd
+++ /dev/null
@@ -1,93 +0,0 @@
-xine fails when allocating images
----------------------------------
-
-Make sure you have enough shared memory enabled. This is very
-limited by default.
-
-Edit your /etc/sysctl.conf:
-
-kern.ipc.shmmax=67108864
-kern.ipc.shmall=32768
-
-
-mtrr on freebsd
----------------
-
-setting up the caching behaviour of the memory on the graphics board.
-
-what is being done with the mtrr support on linux is to set the caching
-type of the memory of the graphics board to 'write-combine' mode.
-that way the performance of big writes into this memory should be faster.
-
-it seems that the same can be achieved on freebsd by executing:
-
-  memcontrol set -b <base-address> -l <length> write-combine
-
-for example on my system i executed:
-
-  memcontrol set -n 0xd8000000 -l 0x02000000 write-combine
-
-i got the base-adress by executing 'startx' and looking at the output.
-
-it seems to be dangerous to change the cache setting of the graphics memory
-while xfree is running - at least i managed to have my system freeze that
-way. so better do it on the commandline.
-
-this tip is still subject of research, so it might be incorrect - please
-report any further information on this topic to the xine-user list.
-please also report success or non-success on xine-user if you have the time.
-
-
-playing video cd on freebsd
----------------------------
-
-currently (because of issues with the freebsd kernel) xine can only
-play video cd from atapi cdrom drives. not for scsi drives!
-
-currently (Jan 2001), FreeBSD-stable (and thus the current releases also)
-needs a patch to the kernel sources to make video cd work (please check
-the freebsd documentation if you are unsure on how to build a custom
-kernel with this patch included).
-
-the file you have to patch is /sys/dev/ata/atapi-cd.c:
-
-*** atapi-cd.c.orig     Sun Jan 21 14:42:57 2001
---- atapi-cd.c  Sun Jan 21 14:47:13 2001
-***************
-*** 1163,1174 ****
-                return;
-            }
-        }
-!       if (blocksize == 2048)
-!           ccb[0] = ATAPI_READ_BIG;
-!       else {
-!           ccb[0] = ATAPI_READ_CD;
-!           ccb[9] = 0x10;
-!       }
-      }
-      else
-        ccb[0] = ATAPI_WRITE_BIG;
---- 1163,1182 ----
-                return;
-            }
-        }
-!         switch (blocksize) {
-!         case 2048:
-!             ccb[0] = ATAPI_READ_BIG;
-!             break;
-! 
-!         case 2352: 
-!             ccb[0] = ATAPI_READ_CD;
-!             ccb[9] = 0xf8;
-!             break;
-! 
-!         default:
-!             ccb[0] = ATAPI_READ_CD;
-!             ccb[9] = 0x10;
-!         }
-      }
-      else
-        ccb[0] = ATAPI_WRITE_BIG;
-
-------------------------------------------------------------------------
-
diff --git a/doc/README.solaris b/doc/README.solaris
deleted file mode 100644
index b177bc3f9..000000000
--- a/doc/README.solaris
+++ /dev/null
@@ -1,30 +0,0 @@
-building xine on solaris
-------------------------
-
-* Compile xine with GNU make (gmake, /opt/sfw/bin/gmake)
-
-* If you get a "fatal: relocation error" ... "symbol __divdi3:
-  referenced symbol not found" error when running xine, re-configure 
-  xine-lib with gcc as the linker command (env LD=gcc configure ...)
-
-* To get VIS accelerated MPEG decoding and colour space conversion 
-  on Solaris SPARC, download and install Sun's mediaLib 2.0, available
-  here:
-
-    http://www.sun.com/sparc/vis/mediaLib.html
-
-
-Known Problems
---------------
-
-* Can't use MIT shared memory for local video display
-
-  The default value for the maximum allowed shared memory segment size
-  (1MByte) is very small on solaris.  You may want to increase the
-  max. allowed shared memory segment size.  Add the following line to
-  /etc/system to increase the shmmax parameter to 8MBytes:
-
-	set shmsys:shminfo_shmmax=8388608
-
-  Reboot the machine after modifying /etc/system to activate the new
-  default.
diff --git a/doc/README.syncfb b/doc/README.syncfb
deleted file mode 100644
index 092188eb3..000000000
--- a/doc/README.syncfb
+++ /dev/null
@@ -1,144 +0,0 @@
-
-  =====                                                            =====
-       XINE video output plugin for MATROX G400 / G200 cards *only*
-  =====                                                            =====
-
-
-
-* WHAT IS THIS PLUGIN ABOUT and WHY SHOULD I EVEN CONSIDER TO USE IT? :)
-  
-  This XINE video output plugin uses the so called Teletux  driver which
-  provides special hardware features of the Matrox G400 and  G200  cards
-  like deinterlacing, scaling and YUV data to RGB conversion --- just to
-  name a few.  The plugin makes all those features available to XINE and
-  because all this tasks are done by the graphics card there  is no need
-  for XINE to do them in software -- so you save precious CPU time which
-  you may gonna need for other things. :-)
-  
-  Another feature of this plugin is the  synchronisation  of  the  video
-  picture with the refresh of your screen.  Before you ask why you would
-  need that - here the explanation... :)
-  
-  In order to have an optimal DVD playback the update of the image needs
-  to be syncronized with the refresh of the screen.   Otherwise you will
-  sometimes see part of frame n and part of frame n+1 during an refresh.
-  This results in tearing artefacts on moving objects.
-  
-  When using this plugin the update of the screen is done in the  V-SYNC
-  phase of your screen - and the tearing artefacts are gone forever.
-
-
-* AND HOW DOES IT WORK?
-  
-  The Teletux driver is a module you will  have  to  load  that  makes a
-  special device (/dev/syncfb) available  which is opened by  the plugin
-  and controlled with certain ioctl calls. Quite easy, isn't it? ;)
-
-  That module is based on the mga_vid driver from Aaron Holzmann and was
-  advanced (and reworked) by Matthias Oelmann.
-
-
-* OK I HEARD ENOUGH - HOW DO I INSTALL and USE IT? :)
-
-  First of all you will need to get the Teletux driver itself.      It's
-  available at http://teletux.sourceforge.net.   Once you downloaded it,
-  unpack it to some directory of your choice, please read the README and
-  compile it (a normal "make" should work out-of-the-box). Now there are
-  only a few things left for you to do...
-  
-  1) Become root. Hey now you can take over the world *evil laugh* :-)))
-  2) Create a device called /dev/syncfb  ===>  mknod /dev/syncfb c 178 0
-  3) Copy the file "syncfb.o" to your modules directory (usually this is
-     /lib/modules/YOUR_KERNEL_VERSION/) and do a "depmod -a".
-  
-  This should be it. In order to use the Teletux driver you will have to
-  load it with the command "insmod syncfb.o" - please note that you will
-  have to load it every time you reboot if you wanna use the driver.
-
-  XINE autodetects the driver and automaticly uses this plugin.
-
-  It  is  possible now  that the image during video playback is jerking.
-  This could be caused by the syncronisiation of the  video  image  with
-  your screen refresh. You can easily fix that by switching your monitor
-  to the appropriate refresh rates (50 Hz for PAL, 60 Hz for NTSC).  You
-  will need to add so called modelines to your XFree86  config  to  make
-  those 50 Hz/60 Hz modes available.
-  
-  Here is is a short listing of some sample modelines. Please  add  only
-  those two lines (for NTSC and PAL) which exactly  fit  the  screensize
-  you are running your X Server with. You need to add those lines to the
-  monitor section of your XF86Config file as well as include their names
-  in the screen section  (subsection display of the color depth your are
-  using).
- 
-  USE THE FOLLOWING MODELINES AT YOUR OWN RISK.   THEY COULD DAMAGE YOUR
-  MONITOR PERMANTELY - PLEASE TAKE CAUTION AND DON'T BLAME US.  YOU HAVE
-  BEEN WARNED.
-
-  So much for the standard disclaimer. :)
-
-  Note: If you want to be on the  safe  side,  generate  your  very  own
-        modelines with an application like kvideogen or  use  a  service
-	like http://zaph.com/Modeline/ on the web.
-	
-	Also the modelines may need some fine tuning for your setup. You
-	can use xvidtune (comes with XFree86) to do that.
-  
-  # 1024x768
-  
-    Modeline "1024x768pal"  64.94 1024 1040 1216 1328 768 768 775 802
-    Modeline "1024x768ntsc" 54.32 1024 1040 1216 1328 768 768 774 802  
-  
-  # 1152x864
- 
-    Modeline "1152x864pal"  68.82 1152 1168 1384 1496 864 864 871 902
-    Modeline "1152x864ntsc" 80.93 1152 1168 1384 1496 864 864 872 902    
-
-  # 1280x1024
-    
-    none yet - will be added soon
-
-  So before you run XINE please turn to the appropriate refresh rate and
-  the jerking should be gone.
-
-
-* WHAT SCREENSIZE SHOULD I PREFER?
-  
-  Well. It is important that the screensize  you choose for DVD playback
-  is exactly the same screensize  you're starting up your X Server with.
-  So you shouldn't switch down to 1024x768 if you are  running 1280x1024
-  because that  gives  you  a  virtual  screensize  of  1280x1024  in  a
-  resolution of 1024x768 - and the plugin cannot handle that yet.
-
-  Now back to the question. A screensize of 1024x768 should be it. A DVD
-  is always 720x576 for pal and 720x480 for ntsc. If you've an anamorphe
-  DVD the image only has to be horizontally scaled to get  back  to  the
-  original geometry of 16:9 which is easier to be done.
-
-
-* WHERE IS THE WINDOW A VIDEO IS USUALLY DISPLAYED IN?
-
-  The Teletux driver is writing directly to the video memory of the G400
-  or G200 card and bypasses your X server.   Getting that overlay into a
-  real window isn't as easy as you might think.
-  
-  For now a borderless window is being used which lays under the overlay
-  so you can click on the overlay (for the panel to appear) or issue any
-  command XINE supports by keyboard while you're over the  overlay  with
-  your mouse cursor.
-  
-
-* WHAT IS ON THE TODO LIST?
-  
-  The plugin does not yet activate the hardware deinterlacing.
-  The mouse cursor doesn't disappear yet when it should be disappearing.
-  Prevent the panel from hidding behind the overlay by moving it out of range.
-  Bug fixes, new features and optimizations. :-)
-  
-
-* CONTACTS and FEEDBACK
-  
-  Joachim Koening <joachim.koenig@gmx.net>
-    Matthias Dahl <matthew2k@web.de>
-  
-  or use the XINE User Mailinglist. (more infos see the general README)
diff --git a/doc/bug_report_form b/doc/bug_report_form
deleted file mode 100644
index 054071117..000000000
--- a/doc/bug_report_form
+++ /dev/null
@@ -1,62 +0,0 @@
-this is a generic bug report form that should help you making bug reports
-(e.g. to post them on the xine-user mailing list at
- <xine-user@lists.sourceforge.net>)
-
-Just use it as a checklist or copy/paste it into your bug report and replace
-the quoted lines ("> ...") with the corresponding information!
-
-
-> subject
-> -------
-> 
-> _please_ give a meaningful subject! Something like "horizontal bars while 
-> playing" is good, something like "xine bug" is not.
-
-
-bug description
----------------
-
-> short, but complete, problem description
-
-
-xine console output
--------------------
-
-> please _always_ include the complete console output xine produces.
-> It contains important information about the hardware xine detected and
-> what modules are used for audio/video output on your configuration.
-
-> you can produce a suitable log file with these command(s):
-> xine [options] 2>&1 |tee /tmp/xine.log
-> if the resulting /tmp/xine.log is very big, you may compress it with
-> "gzip -9 /tmp/xine.log" before attaching it to your bug report.
-
-
-xine version used
------------------
-
-> release/CVS ? is it a debug version (did you a make debug?)
-> Is the bug new with this release?
-> If you don't use the current release: Why not?/Please recheck with the
-> current version, first!
-
-
-information about your operating system/software
-------------------------------------------------
-
-> operating system, e.g. linux, kernel 2.2.16
-
-> X server, e.g. xfree 4.01, mga drivers
-
-> audio driver, e.g. alsa 0.5.9d
-
-
-information about your hardware configuration
----------------------------------------------
-
-> CPU, e.g. P II 400
-
-> graphics card, e.g. Matrox G400, 32 MB RAM
-
-> sound card, e.g. SB Live
-
diff --git a/doc/man/en/Makefile.am b/doc/man/en/Makefile.am
index b70881881..10c1637dc 100644
--- a/doc/man/en/Makefile.am
+++ b/doc/man/en/Makefile.am
@@ -1,6 +1,6 @@
-man_MANS = xine.1
+man_MANS = xine-lib.3
 
-EXTRA_DIST = $(man_MANS) xine.1.in
+EXTRA_DIST = $(man_MANS) xine-lib.3.in
 
 mostlyclean-generic:
 	-rm -f *~ \#* .*~ .\#*
@@ -8,4 +8,4 @@ mostlyclean-generic:
 maintainer-clean-generic:
 	-@echo "This command is intended for maintainers to use;"
 	-@echo "it deletes files that may require special tools to rebuild."
-	-rm -f Makefile.in xine.1
+	-rm -f Makefile.in xine-lib.3
diff --git a/doc/man/en/xine.1.in b/doc/man/en/xine-lib.3.in
index 2739c44c0..ed4428128 100644
--- a/doc/man/en/xine.1.in
+++ b/doc/man/en/xine-lib.3.in
@@ -1,6 +1,6 @@
 .\" -*-Nroff-*-
 .\""
-.TH XINE 1x 2000-11-19 "The xine project"
+.TH XINE 3x 2000-11-19 "The xine project"
 .\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
 .\" other parms are allowed: see man(7), man(1)
 .\""
diff --git a/doc/man/fr/Makefile.am b/doc/man/fr/Makefile.am
index 0335fd786..b40770a30 100644
--- a/doc/man/fr/Makefile.am
+++ b/doc/man/fr/Makefile.am
@@ -1,15 +1,15 @@
-mansubdir=/fr/man1
+mansubdir=/fr/man3
 
-man_MANS = xine.1
+man_MANS = xine-lib.3
 
-EXTRA_DIST = $(man_MANS) xine.1.in
+EXTRA_DIST = $(man_MANS) xine-lib.3.in
 
-install-man1:
+install-man3:
 	$(mkinstalldirs) $(DESTDIR)$(mandir)$(mansubdir)
-	@list='$(man1_MANS)'; \
+	@list='$(man3_MANS)'; \
 	l2='$(man_MANS)'; for i in $$l2; do \
 	  case "$$i" in \
-	    *.1*) list="$$list $$i" ;; \
+	    *.3*) list="$$list $$i" ;; \
 	  esac; \
 	done; \
 	for i in $$list; do \
@@ -22,11 +22,11 @@ install-man1:
 	  $(INSTALL_DATA) $$file $(DESTDIR)$(mandir)$(mansubdir)/$$inst; \
 	done
 
-uninstall-man1:
-	@list='$(man1_MANS)'; \
+uninstall-man3:
+	@list='$(man3_MANS)'; \
 	l2='$(man_MANS)'; for i in $$l2; do \
 	  case "$$i" in \
-	    *.1*) list="$$list $$i" ;; \
+	    *.3*) list="$$list $$i" ;; \
 	  esac; \
 	done; \
 	for i in $$list; do \
@@ -43,4 +43,4 @@ mostlyclean-generic:
 maintainer-clean-generic:
 	-@echo "This command is intended for maintainers to use;"
 	-@echo "it deletes files that may require special tools to rebuild."
-	-rm -f Makefile.in xine.1
+	-rm -f Makefile.in xine-lib.3
diff --git a/doc/man/fr/xine.1.in b/doc/man/fr/xine-lib.3.in
index 708880d67..ef019da07 100644
--- a/doc/man/fr/xine.1.in
+++ b/doc/man/fr/xine-lib.3.in
@@ -1,6 +1,6 @@
 .\" -*-Nroff-*-
 .\""
-.TH XINE 1x 2000-11-19 "Le projet xine"
+.TH XINE 3x 2000-11-19 "Le projet xine"
 .SH NOM
 xine \- Lecteur audio/vidéo MPEG2/MPEG1.
 .SH SYNOPSIS