moved FAQ over to manual

git-svn-id: https://svn.code.sf.net/p/gphoto/code/trunk/libgphoto2@5394 67ed7778-7388-44ab-90cf-0a291f65f57c

3 files changed, 2 insertions, 310 deletions

diff --git a/doc/FAQ b/doc/FAQ
deleted file mode 100644
index c4a233494..000000000
--- a/doc/FAQ
+++ /dev/null
@@ -1,58 +0,0 @@
-========================================================================
-
-NOTE: Some FAQs have already moved to faq.xml and hence into
-      The gPhoto2 Manual.
-
-========================================================================
-
-Q: gphoto2 does not work, the driver reports some error messages.
-   What shall I do?
-
-A: First of all make sure, that you have only one instance of gphoto2
-   installed on your system. Unless you know what you're doing you should
-   remove all gphoto2 installation, then you may do (as root):
-   rm -rf /usr/local/lib/gphoto2*
-   rm -rf /usr/lib/gphoto2*
-   (above applyes specialy if you used package and CVS version)
-   After that install newest gphoto2 and test whether it works now.
-   If not, see below.
-
-========================================================================
-
-Q: I have a special problem with CameraXYZ. Where can I find information
-   about it?
-
-A: You can look into the README file of your driver <driver>. It is 
-   located in camlibs/<driver>/ in your source tree.
-
-========================================================================
-
-Q: I run Linux 2.4.x and I can't get USB to work at all. I keep getting
-
-   kernel: usb_control/bulk_msg: timeout
-   kernel: usbdevfs: USBDEVFS_BULK failed dev 3 ep 0x81 len 64 ret -110
-
-   How can I make USB work?
-
-A: No idea. Sometimes it works and sometimes it doesn't. If you know a
-   solution, please let us know.
-
-========================================================================
-
-Q: What's the best way to rotate downloaded JPEG images w/o losses?
-
-A: If you do not care about EXIF information:
-
-      jpegtran -copy all -rotate 90
-
-   If you want to preserve EXIF information:
-
-      jhead -cmd 'jpegtran -rotate 90 -outfile &o &i' my-pic.jpg
-
-========================================================================
-
-Q: I want to use GNU stow, but that fails.
-
-A: I don't know what stow is, but have a look at #553647.
-
-========================================================================
diff --git a/doc/Makefile.am b/doc/Makefile.am
index a772c9b21..aada9b8d6 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -14,8 +14,8 @@ EXTRA_DIST = DAEMON build_OS2.txt 					\
 	camlib_devel-portmon.eps camlib_devel-repeater.eps 		\
 	camlib_devel.sgml camlib_devel.txt camlib_devel-y.eps 		\
 	frontend_devel.lyx frontend_devel.sgml frontend_devel.txt 	\
-	FAQ faq.xml gphoto2.3 gphoto2_port.3
+	gphoto2.3 gphoto2_port.3
 
 man_MANS = gphoto2.3 gphoto2_port.3
 
-doc_DATA = FAQ faq.xml
+# doc_DATA = FAQ faq.xml
diff --git a/doc/faq.xml b/doc/faq.xml
deleted file mode 100644
index 3a24f8e58..000000000
--- a/doc/faq.xml
+++ /dev/null
@@ -1,250 +0,0 @@
-<?xml version='1.0' ?>
-
-<!-- =================================================================
-About this file:
-
- - It is written in Docbook XML
-
- - You're best off using an XML editor for this file
-
- - If you have installed the Docbook XML DTDs properly, 
-   you can do syntax checks
-
- - You can view this file directly using any XML+CSS capable browser. 
-   Examples are Mozilla, Galeon, Opera.
-
- - If you need more information about Docbook and XML, have a look at
-   http://docbook.org/ and http://nwalsh.com/
-
- - We use Tim Waugh's xmlto to process this file within the build
-   system, but you're free to use any other adequate processing tool,
-   of course :-)
-
-================================================================= -->
-
-<?xml-stylesheet type="text/css" href="docbook-xml.css"?>
-
-<!--
-  leave DOCTYPE commented out for easy inclusion as external entity 
--->
-<!-- DOCTYPE qandaset PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
-  "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" -->
-
-<qandaset>
-
-  <qandaentry>
-    <question>
-      <simpara>What can I do about the error message "Could not find USB device"?</simpara>
-    </question>
-    <answer>
-      <para>
-	The exact error message looks like
-      </para>
-      <screen>
-Could not find USB device (vendor 0x0000, product 0x0000). Make
-sure this device is connected to the computer
-      </screen>
-      <para>
-	You have to set up the permissions on your USB device correctly.
-	This is described in The gPhoto2 Manual, which is available at
-
-	<ulink url="http://n-dimensional.de/projects/digicam/The_gPhoto2_Manual/">http://n-dimensional.de/projects/digicam/The_gPhoto2_Manual/</ulink>.
-
-	See especially the section "Setting up permissions for USB ports".
-      </para>
-    </answer>
-  </qandaentry>
-
-  <qandaentry>
-    <question>
-      <simpara>gphoto2 does not find my camera. What shall I do?</simpara>
-    </question>
-    <answer>
-      <para>      
-	First try to run "gphoto2 --list-ports" and look whether the ports 
-	you want to use are listed there:
-      </para>
-      <itemizedlist>
-	<listitem>
-	  <simpara>	
-	    For serial devices, the port with the appropriate device must be
-	    listed
-	  </simpara>
-	</listitem>
-	<listitem>
-	  <simpara>
-	    For USB devices, you need the "usb:" port in the list. If you
-	    don't see it, check whether you compiled gphoto2 with libusb
-	    support.
-	  </simpara>
-	</listitem>
-      </itemizedlist>
-      <para>
-	Then try to run "gphoto2 --auto-detect" and look whether the camera
-	is detected.
-      </para>
-      <para>
-	If your gphoto2 cannot access the USB device as non-root users, you
-	have to set up hotplugging correctly. See FIXME for details.
-      </para>
-      <para>
-	AND DO NOT RUN gphoto2 AS ROOT. And no other libgphoto2 frontend either.
-      </para>
-    </answer>
-  </qandaentry>
-
-  <qandaentry>
-    <question>
-      <simpara>Why do I get the error message "Could not claim the USB device"?</simpara>
-    </question>
-    <answer>
-      <para>
-	The exact message looks like
-      </para>
-      <screen>
-*** Error ('Could not claim the USB device') ***
-
-Could not claim interface 0 (Operation not permitted). Make sure no
-other program or kernel module (e.g. dc2xx or stv680) is using the 
-device and you have read/write access to the device. 
-      </screen>
-      <para>
-	You have to make sure that no such kernel module is loaded and that
-	you have set up the permissions on your USB device correctly,
-	such that you have (non-root) write access to the camera device.
-	How to set this up, is described at FIXME.
-      </para>
-    </answer>
-  </qandaentry>
-
-  <qandaentry>
-    <question>
-      <simpara>
-	Why does my Canon PowerShot G1/Pro 90 IS not work with gphoto2
-	when using the AC adapter?
-      </simpara>
-    </question>
-    <answer>
-      <para>
-	This is a longstanding bug which we cannot fix since none of
-	the active gphoto2 developers own one of these cameras. Your
-	options are as follows, in descending order of preference:
-      </para>  
-      <itemizedlist>
-	<listitem>
-	  <simpara>
-	    Fix it and send us a patch.
-	  </simpara>
-	</listitem>
-	<listitem>
-	  <simpara>Donate a G1 to one of the active Canon driver
-	    developers.</simpara>
-	</listitem>
-	<listitem>
-	  <simpara>Run the camera on battery instead of the AC adapter.</simpara>
-	</listitem>
-      </itemizedlist>
-      <para>
-	There is some more info regarding this at
-	<ulink url="http://krixor.xy.org/fredrik/gp/canon-g1-ac-problem/">http://krixor.xy.org/fredrik/gp/canon-g1-ac-problem/</ulink>.
-	Good luck.
-      </para>
-    </answer>
-  </qandaentry>
-
-  <qandaentry>
-    <question>
-      <simpara>I've got a serial camera, but gphoto2 doesn't work on SuSE 7.0
-   (or greater). You told me that my camera is supported! Fix
-	it!</simpara>
-    </question>
-    <answer>
-      <para>
-	Cool down, Joe, and listen to the wise words of Linda
-	MacPhee-Cobb:
-      </para>
-      <para>
-	<citation>
-	  If you are not getting a response from a camera plugged into
-	  the serial port, check your /var/log/boot.msg file for the
-	  following entry near the end:
-	</citation>
-	<screen>
-	    *This package use the ttyS0 device by default.
-	    The installation of this package only makes sense
-	    if you use a braille display.
-	</screen>
-	<citation>
-	  This is from blinx, and you will need to turn it off,
-	  or better, uninstall it.
-	</citation>
-      </para>
-    </answer>
-  </qandaentry>
-
-  <qandaentry>
-    <question>
-      <simpara>Dudes, Windows is the way to go. How do I compile
-	gphoto2 for that environment?</simpara>
-    </question>
-    <answer>
-      <para>
-	We don't have the money to buy Windows and something like Visual C.
-	Therefore, we can't provide you a gphoto2 for Windows. You have two 
-	choices (at least):
-      </para>
-      <itemizedlist>
-	<listitem>
-	  <simpara>
-	    Buy a fast computer, buy Windows and Visual C and some manuals on
-	    how to access USB or serial ports on Windows. Send all that
-	    including a blank cheque to us (ask for the address on
-	    gphoto-devel@gphoto.org).
-	  </simpara>
-	</listitem>
-	<listitem>
-	  <simpara>
-	    Try to figure out how to get gphoto2 working on Windows
-	    and send us the patches.
-	  </simpara>
-	</listitem>
-      </itemizedlist>
-    </answer>
-  </qandaentry>
-
-  <qandaentry>
-    <question>
-      <simpara>I wanna have CVS write access. How do I get one?</simpara>
-    </question>
-    <answer>
-      <simpara>
-	We provide CVS write access to persons that show 
-	<emphasis>continued</emphasis> interest in a 
-	<emphasis>specific part</emphasis>
-	of gphoto2. 
-	If there is already a person maintaining this 
-	specific part of gphoto2 (i.e. a camera driver), we prefer you
-	submit patches to the maintainer who will then check them in
-	or request modifications.
-      </simpara>
-    </answer>
-  </qandaentry>
-
-  <qandaentry>
-    <question>
-      <simpara>You took away my CVS write access! What did I do
-	wrong?</simpara>
-    </question>
-
-    <answer>
-      <para>     
-	If your name is not listed in gphoto2/MAINTAINERS, and if we
-	haven't heard from you lately, we assume that you finished
-	your work on gphoto2 and that you don't need write access any
-	longer. If this is not the case, please contact one of the
-	project admins.
-      </para>
-    </answer> 
-  </qandaentry>
-
-</qandaset>