From 1ae6fcc04718fa44f5b820d3352f85a7201428ea Mon Sep 17 00:00:00 2001 From: Hans Ulrich Niedermann Date: Sun, 11 Aug 2002 22:12:38 +0000 Subject: [PATCH] moved some questions from FAQ to faq.xml git-svn-id: https://svn.code.sf.net/p/gphoto/code/trunk/libgphoto2@5002 67ed7778-7388-44ab-90cf-0a291f65f57c --- doc/FAQ | 104 +--------------------- doc/Makefile.am | 12 ++- doc/faq.xml | 224 ++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 234 insertions(+), 106 deletions(-) create mode 100644 doc/faq.xml diff --git a/doc/FAQ b/doc/FAQ index 8203b05e8..64c0381f2 100644 --- a/doc/FAQ +++ b/doc/FAQ @@ -1,39 +1,7 @@ ======================================================================== -Q: gphoto2 does not find my camera. What shall I do? - -A: First try to run "gphoto2 --list-ports" and look whether the ports - you want to use are listed there: - - For serial devices, the port with the appropriate device must be - listed - - 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. - - Then try to run "gphoto2 --auto-detect" and look whether the camera - is detected. - - If your gphoto2 cannot access the USB device as non-root users, you - have to set up hotplugging correctly. See gphoto2.txt for details. - - AND DO NOT RUN gphoto2 AS ROOT. - -======================================================================== - -Q: I get the error message - - *** 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. - - What can I do to make it work? - -A: You have to make sure that no such kernel module is loaded and that - you have to set up the permissions on your USB device correctly. - For Linux, this is described in the file named gphoto2.txt in - your gphoto2 documentation directory (named doc/ in the source tree). +NOTE: Some FAQs have already moved to faq.xml and hence into + The gPhoto2 Manual. ======================================================================== @@ -64,27 +32,6 @@ A: First of all make sure, that you have only one instance of gphoto2 ======================================================================== -Q: My Canon PowerShot G1/Pro 90 IS doesn't work with gphoto2 when using - the AC adapter. What should I do? - -A: This is a known bug which we cannot fix since none of the active - gphoto2 developers own one of these cameras. Your alternatives are as - follows : - - Fix it and send us a patch. - - Donate a G1 to one of the active Canon driver developers. - - Run the camera on battery instead of the AC adapter. - - There is some more info regarding this at - - http://krixor.xy.org/fredrik/gp/canon-g1-ac-problem/ - - good luck. - -======================================================================== - Q: I have a special problem with CameraXYZ. Where can I find information about it? @@ -105,36 +52,6 @@ A: No idea. Sometimes it works and sometimes it doesn't. If you know a ======================================================================== -Q: 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! - -A: Cool down, Joe, and listen to the wise words of Linda MacPhee-Cobb: - "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: - *This package use the ttyS0 device by default. - The installation of this package only makes sense - if you use a braille display. - This is from blinx, and you will need to turn it off, - or better, uninstall it." - -======================================================================== - -Q: Dudes, Windows is the way to go. How do I compile gphoto2 for that - environment? - -A: 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): - (1) 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). - (2) Try to figure out how to get gphoto2 working on Windows and send - us the patches. - -======================================================================== - Q: What's the best way to rotate downloaded JPEG images w/o losses? A: If you do not care about EXIF information: @@ -152,20 +69,3 @@ Q: I want to use GNU stow, but that fails. A: I don't know what stow is, but have a look at #553647. ======================================================================== - -Q: I wanna have CVS write access. How do I get one? - -A: We provide CVS write access to persons that show _continued_ interest in - a _specific part_ 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. - -======================================================================== - -Q: You took away my CVS write access! What did I do wrong? - -A: 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. diff --git a/doc/Makefile.am b/doc/Makefile.am index 73ee03818..2b9fcc1d5 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -20,13 +20,15 @@ manual_html = @manual_html@ CLEAN_FILES = $(manual_pdf) $(manual_ps) figures-stamp +MANUAL_SRC = gphoto2.xml faq.xml + EXTRA_DIST = DAEMON build_OS2.txt \ camlib_devel.lyx \ 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 \ gphoto2-cli.txt \ - gphoto2.xml $(man_MANS) $(manual_pdf) $(manual_ps) \ + gphoto2.xml faq.xml $(man_MANS) $(manual_pdf) $(manual_ps) \ FAQ man_MANS = gphoto2.1 gphoto2.3 gphoto2_port.3 @@ -48,10 +50,12 @@ figures-stamp: # the build process will barf when xmlto is not present. ######################################################################## +api/sgml/gphoto2-camera.xml: api/sgml/gphoto2-camera.sgml + sgml2xml $< > $@ ######################################################################## if XMLTOPDF -gphoto2.pdf: gphoto2.xml figures-stamp +gphoto2.pdf: $(MANUAL_SRC) figures-stamp test -e $$(basename $<) || ln -s $< # symlink file from srcdir to builddir if required $(XMLTO) pdf $$(basename $<) # work on local file or symlink endif @@ -61,7 +65,7 @@ endif ######################################################################## if XMLTOPS # doesn't work if builddir != srcdir -gphoto2.ps: gphoto2.xml figures-stamp +gphoto2.ps: $(MANUAL_SRC) figures-stamp test -e $$(basename $<) || ln -s $< # symlink file from srcdir to builddir if required $(XMLTO) ps $$(basename $<) # work on local file or symlink endif @@ -91,7 +95,7 @@ htmldir=@HTML_DIR@ TARGET_DIR=$(htmldir)/manual -manual: gphoto2.xml +manual: $(MANUAL_SRC) $(XMLTO) html -o "$@" "$<" cd $@ && rm -f figures && ln -s ../figures figures # to view docs in src tree touch "$@" diff --git a/doc/faq.xml b/doc/faq.xml new file mode 100644 index 000000000..a340d7b6f --- /dev/null +++ b/doc/faq.xml @@ -0,0 +1,224 @@ + + + + + + + + + + + + + gphoto2 does not find my camera. What shall I do? + + + + First try to run "gphoto2 --list-ports" and look whether the ports + you want to use are listed there: + + + + + For serial devices, the port with the appropriate device must be + listed + + + + + 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. + + + + + Then try to run "gphoto2 --auto-detect" and look whether the camera + is detected. + + + If your gphoto2 cannot access the USB device as non-root users, you + have to set up hotplugging correctly. See FIXME for details. + + + AND DO NOT RUN gphoto2 AS ROOT. And no other libgphoto2 frontend either. + + + + + + + Why do I get the error message "Could not claim the USB device"? + + + + The exact message looks like + + +*** 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. + + + 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. + + + + + + + + Why does my Canon PowerShot G1/Pro 90 IS not work with gphoto2 + when using the AC adapter? + + + + + 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: + + + + + Fix it and send us a patch. + + + + Donate a G1 to one of the active Canon driver + developers. + + + Run the camera on battery instead of the AC adapter. + + + + There is some more info regarding this at + http://krixor.xy.org/fredrik/gp/canon-g1-ac-problem/. + Good luck. + + + + + + + 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! + + + + Cool down, Joe, and listen to the wise words of Linda + MacPhee-Cobb: + + + + 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: + + + *This package use the ttyS0 device by default. + The installation of this package only makes sense + if you use a braille display. + + + This is from blinx, and you will need to turn it off, + or better, uninstall it. + + + + + + + + Dudes, Windows is the way to go. How do I compile + gphoto2 for that environment? + + + + 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): + + + + + 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). + + + + + Try to figure out how to get gphoto2 working on Windows + and send us the patches. + + + + + + + + + I wanna have CVS write access. How do I get one? + + + + We provide CVS write access to persons that show + continued interest in a + specific part + 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. + + + + + + + You took away my CVS write access! What did I do + wrong? + + + + + 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. + + + + +