diff options
Diffstat (limited to 'doc/faq')
| -rw-r--r-- | doc/faq/Makefile.am | 49 | ||||
| -rw-r--r-- | doc/faq/faq.docbook (renamed from doc/faq/faq.sgml) | 27 |
2 files changed, 32 insertions, 44 deletions
diff --git a/doc/faq/Makefile.am b/doc/faq/Makefile.am index 6090fd272..782f618c1 100644 --- a/doc/faq/Makefile.am +++ b/doc/faq/Makefile.am @@ -3,20 +3,14 @@ include $(top_srcdir)/misc/Makefile.common doc_DATA = faq.txt html_DATA = faq.html -EXTRA_DIST = README faq.sgml $(doc_DATA) $(html_DATA) +EXTRA_DIST = README faq.docbook $(doc_DATA) $(html_DATA) -docs: $(doc_DATA) $(html_DATA) +DISTCLEANFILES = $(doc_DATA) $(html_DATA) -distclean-local: clean-docs - -docs-prepare: $(srcdir)/faq.sgml - if test "$(srcdir)" != "." -a "$(srcdir)" != "`pwd`"; then \ - test -f ./faq.sgml -a ./faq.sgml -nt $(srcdir)/faq.sgml || cp $^ . ; \ - fi +docs: $(hackersguide_DATA) clean-docs: - rm -f $(doc_DATA) $(html_DATA) - test "x$(srcdir)" = x. || rm -f faq.sgml + rm -f $(hackersguide_DATA) dist-hook: @if test x"$(distcheck_lax)" = x ; then \ @@ -25,38 +19,23 @@ dist-hook: $(MAKE) docs ; \ fi -if HAVE_SGMLTOOLS -faq.html: faq.sgml - @$(MAKE) docs-prepare - $(SGMLTOOLS) -b onehtml faq.sgml; -else -faq.html: faq.sgml - @$(MAKE) docs-prepare - if test x"$(fail_if_missing)" = x"yes"; then \ - echo "Please install sgmltools-lite."; \ - exit 1; \ - fi - if test x"$(fail_if_missing)" != x"yes"; then \ - touch $@; \ - sleep 1; \ - touch $(notdir $^); \ - fi -endif +distclean-local: clean-docs + +if HAVE_XMLTO +faq.html: faq.docbook + xmlto html-nochunks $^ -if HAVE_SGMLTOOLS -faq.txt: faq.sgml - @$(MAKE) docs-prepare - $(SGMLTOOLS) -b txt faq.sgml; +faq.txt: faq.docbook + xmlto txt $^ else -faq.txt: faq.sgml - @$(MAKE) docs-prepare +faq.html faq.txt: faq.docbook if test x"$(fail_if_missing)" = x"yes"; then \ - echo "Please install sgmltools-lite."; \ + echo "Please install xmlto."; \ exit 1; \ fi if test x"$(fail_if_missing)" != x"yes"; then \ touch $@; \ sleep 1; \ - touch $(notdir $^); \ + touch $^; \ fi endif diff --git a/doc/faq/faq.sgml b/doc/faq/faq.docbook index db1762f51..fa414f1e9 100644 --- a/doc/faq/faq.sgml +++ b/doc/faq/faq.docbook @@ -1,4 +1,6 @@ -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> +<?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" + "/usr/share/sgml/docbook/xml-dtd-4.4/docbookx.dtd" > <book> @@ -6,7 +8,7 @@ <title>The xine engine FAQ</title> <titleabbrev>xine FAQ</titleabbrev> <copyright> - <year>2001-2003</year> + <year>2001-2007</year> <holder>the xine project team</holder> </copyright> </bookinfo> @@ -331,7 +333,7 @@ In case that you have a fresh CVS checkout, you will need to do the following first in order to get a tarball release out of it which you can later use with the <command>rpmbuild -ta</command> command above: - <screen> <command>./autogen.sh && make clean && make dist</command></screen> + <screen> <command>./autogen.sh && make clean && make dist</command></screen> </para> <para> In any case, please keep in mind that you have to build and install @@ -362,7 +364,7 @@ <screen> <command>cd ..</command> <command>ls *.deb</command> - <command>su - -c 'cd '"`pwd`"' && dpkg -i <DEB_PACKAGES>'</command> + <command>su - -c 'cd '"`pwd`"' && dpkg -i <DEB_PACKAGES>'</command> </screen> Ubuntu users will probably want to use this instead of that <command>su</command>: <screen> @@ -423,7 +425,7 @@ </sect2> <sect2 id="athlonflags"> - <title>Are there binaries for my AMD K7 (Athlon™) available? Can I build them?</title> + <title>Are there binaries for my AMD K7 (Athlon™) available? Can I build them?</title> <para> If you have a recent gcc you can try to compile "more" k7 support in (esp. better instruction scheduling). If the configure script should fail to @@ -1149,6 +1151,10 @@ </ulink> </para> <para> + For recent kernels (2.6.x series) the raw devices are neither + needed nor supported anymore, so don't bother. + </para> + <para> To use raw devices, first connect a free raw device to your dvd device, use something like: <screen> <command>raw /dev/raw1 /dev/dvd</command></screen> @@ -1243,10 +1249,13 @@ <sect2 id="audiodrivers"> <title>What audio drivers does xine support? OSS? Alsa? Arts? Esd?</title> <para> - Currently xine support audio output via OSS (kernel audio drivers), - ALSA 0.9.x (ALSA 0.5.x is no longer supported), arts (KDE's sound daemon) - and esound (esd, gnome's sound daemon - not recommended because it has - serious issues with a/v sync). + Currently xine support audio output via OSS (Linux 2.4 and most + *BSD audio drivers), + ALSA 0.9 and 1.0 (ALSA 0.5.x is no longer supported), aRTs (KDE + 3's sound daemon), ESounD (esd, gnome's sound daemon not + recommended because it has serious issues with a/v sync), JACK, + PulseAudio, plus platform-specific output through Sun devices for + Solaris and NetBSD and Irix output. </para> </sect2> |