darktable/libgphoto2
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

moved some questions from FAQ to faq.xml

Browse Source 
git-svn-id: https://svn.code.sf.net/p/gphoto/code/trunk/libgphoto2@5002 67ed7778-7388-44ab-90cf-0a291f65f57c
This commit is contained in:
Hans Ulrich Niedermann
2002-08-11 22:12:38 +00:00
parent 5f60cb4996
commit 1ae6fcc047
3 changed files with 234 additions and 106 deletions
Download Patch File Download Diff File Expand all files Collapse all files

104
doc/FAQ
View File

@@ -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.

12
doc/Makefile.am
View File

@@ -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 "$@"

224
doc/faq.xml Normal file
View File

@@ -0,0 +1,224 @@
<?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"?>
<!-- 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>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>