update docs from release

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

3 files changed, 90 insertions, 110 deletions

diff --git a/INSTALL b/INSTALL
index 10f27e20f..4a61a3281 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,15 +1,23 @@
 ########################################################################
 # $Id$
 #
-# This file describes how to install gphoto2.
+# This file describes how to install libgphoto2.
 ########################################################################
 
-Follow these steps to build and install gphoto2 from the source
+Follow these steps to build and install libgphoto2 from the source
 code. You don't have to run most of these steps as root, except when
 explicitly required. In fact, you really shouldn't.
 
-In order to get gphoto2 running after installation, you will probably
-want to read doc/FAQ and doc/gphoto2.txt.
+In order to get libgphoto2 running after installation, you will
+probably want to read The gPhoto2 Manual. It is available from the
+homepage:
+
+    http://gphoto.net/
+    http://gphoto.org/
+    http://gphoto.com/
+    http://gphoto.sourceforge.net/
+
+At lease one of these should work at any time.
 
 
 ===============================
@@ -19,60 +27,21 @@ Step 0: Preparing configuration
 If you got your copy of gphoto2 packaged as a .tar.gz or .tar.bz2 tarball, 
 SKIP THIS STEP. 
 
-If you got gphoto2 from CVS, then you will have to prepare for step 1,
+If you got libgphoto2 from CVS, then you will have to prepare for step 1,
 the configuration of the sources.
 
-For that, we supply you with a script called 'autogen.sh'.
-
-As to whether 'autogen.sh' does its job, we are not completely sure.
-
-
-  Debian/Unstable user Lutz says:
-  ===============================
-
-    This skript is far from being perfect and we recommend that you
-    prepare step 1 manually. That is, the following commands need to be
-    executed in both gphoto2 and gphoto2/libgphoto2_port: 
-
-    - libtoolize --force
-    - gettextize --force
-    - aclocal -I /path/to/gphoto2/libgphoto2_port/m4 -I /path/to/other/macros
-      (these other macros typically are in
-      /opt/gnome/share/aclocal or /usr/share/aclocal)
-    - autoheader
-    - automake --add-missing --gnu
-    - autoconf
-
-    Not surprisingly, above commands will only work if you have 
-
-    - autoconf
-    - automake (version >= 1.5)
-    - libtool (version >= 1.4)
-    - gettext (version >= 0.10.35)
-
-    installed on your system. For example, if you use
-      autoconf 2.53-4
-      automake 1.4-p4-1.1
-      libtool  1.4.2-4
-      gettext  0.10.40-6
-    you are on the right track.
-
-
-  Redhat Linux 7.3 user Uli says:
-  ===============================
+For that, we supply you with a script called 'autogen.sh'. It calls
+several tools in a certain sequence. For autogen.sh to work, you
+require the following tools
 
-    ./autogen.sh
+	automake
+	autoconf
+	gettext
+	libtool
 
-    (yeah, autogen works again. we fixed the stuff for the 2.1.0 release)
-
-
-Regarding the right version of tools needed to build gphoto2 from CVS, we
-know the following:
-
-  gettext
-  -------
-    0.10.40 works on Debian/unstable (reported by Lutz)
-    0.11.2  works (reported by Arnaud), as does probably every 0.11.*
+in versions compatible to each other and to libgphoto2. Most
+combinations on current GNU/Linux systems work, whereas BSD systems
+tend to have some compatibility problems.
 
 
 =============================
@@ -102,21 +71,13 @@ for certain platforms.
 The following software components are optional, and will improve the
 libraries' and/or command-line client's functionality if present:
 
-	libusb (ver. >= 0.1.5) -- Universal Serial Bus camera support
+	libusb (ver. >= 0.1.6a) -- Universal Serial Bus camera support
 	    <URL:http://www.sourceforge.net/projects/libusb/>
 
-	gettext (ver. >= 0.10.35) -- internationalization using shared library
-
-	aalib -- picture preview
-	    <URL:http://www.sourceforge.net/projects/aa-project/>
-
-	cdk -- camera configuration dialogs
-	    <URL:http://dickey.his.com/cdk/>
+	gettext (ver. >= 0.10.40) -- internationalization using shared library
 
 	gtk-doc -- documentation built in doc/api/
 
-	jpeglib -- JPEG picture preview
-
 	libexif - EXIF tag support
 	    <URL:http://www.sourceforge.net/projects/libexif>
 
@@ -140,13 +101,6 @@ The classic way to compile the program is just to run
 
 and wait until the source is built.
 
-If you want to install gphoto2 using RPM, you should be able to run
-
-    make rpm
-
-after making sure that CDPATH is unset. The RPM packages will be
-located in packaging/rpm/RPMS/.
-
 
 ==============================
 Step 3: Installing the program
@@ -163,50 +117,54 @@ current user, you will have to run it as root.
 This installs the software and documentation into the proper
 directories on your system.
 
-In the case you're trying to use RPM packages, find the *.rpm files in
-packaging/rpm/RPMS/ and install them.
-
 
 ====================================================
 Step 4: Installation is finished - now what do I do?
 ====================================================
 
-Note that gphoto2 is not designed to be installed as a setuid/setgid
-program. Running ANY gphoto2 frontend as root or setuid root or in a
-similar fashion will open up a SECURITY HOLE in your system!
+Note that libgphoto2 is not designed to be run by a setuid/setgid
+program. Running ANY libgphoto2 frontend as root or setuid root or in
+a similar fashion will open up a SECURITY HOLE in your system!
 
-Read doc/FAQ if you run into problems.
+If you run into problems, please read the FAQ (at the website) first.
 
-Read doc/gphoto2.txt for more general information about how to
-configure gphoto2.
+For more general information about how to configure libgphoto2, read
+The gPhoto2 Manual (at the website).
 
 If you have permission problems when accessing your camera, read
-doc/gphoto2.txt -- you will probably want to create a new user group
-for the users that are to have camera access and change the
-permissions of the serial or USB device to match.
+the chapter on Permission Setup -- you will probably want to create a
+new user group for the users that are to have camera access and change
+the permissions of the serial or USB device to match.
 
 
 ===============================================
 Appendix A: Platform specific compilation hints
 ===============================================
 
-gphoto2 has been successfully used on many system.  Some systems where it
-has been reported to successfully compile are listed below. Not all, or even
-any, camera libraries have been tested on these systems, so there may be
-endian other other issues that prevent some camera libraries from working.
-Please report any changes to this list to the gphoto2 developer mailing
+libgphoto2 has been successfully used on many system.  Some systems
+where it has been reported to successfully compile are listed
+below. Not all, or even any, camera libraries have been tested on
+these systems, so there may be endian other other issues that prevent
+some camera libraries from working.
+
+Please report any changes to this list to the gphoto developer mailing
 list.  As of this writing, USB support is only available on Linux and
 FreeBSD as those are the only systems on which libusb is available.
 
 General Hints:
 
-If you have build problems in the intl or po directories, try re-running
-configure with the --disable-nls flag.  If configure stops due to an error
-with 'test', try re-running configure with the --without-usb flag.  If
-'make' reports an error, try using GNU make (often called gmake or gnumake)
-instead of the make that comes with your system.  If one camera driver
-has compilation errors, re-run configure with an appropriate --with-drivers=
-flag to prevent that driver from being compiled.
+  - If you have build problems in the intl or po directories, try
+    re-running configure with the --disable-nls flag.
+  - If configure stops due to an error with 'test', try re-running
+    configure with the --without-usb flag.  
+  - If 'make' reports an error, try using GNU make (often called gmake
+    or gnumake) instead of the make that comes with your system.
+  - If one camera driver has compilation errors, re-run configure with
+    an appropriate --with-drivers= flag to prevent that driver from
+    being compiled.
+
+The list of working systems is a little outdated as of 2002-11-20, but
+we have still left it here as a reference.
 
 i386:
   Debian GNU/Linux 2.2
diff --git a/NEWS b/NEWS
index dad831846..447421c4b 100644
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,25 @@
+------------------------------------------------------------------------
+libgphoto2-2.1.1
+------------------------------------------------------------------------
+
+On 2002-12-01, after almost five months, we have finally released a new
+version of libgphoto2.
+
+Version 2.1.1 now features support for almost 300 digital cameras.
+
+The most important changes since the the 2.1.0 release are (see
+CHANGES for a complete list):
+
+	- new support for quite a lot of new cameras
+	- improved/fixed support for a lot "old" cameras
+	- libgphoto2 and the gphoto2 command line utility are now
+          separated
+	- also moved documentation to a separate module
+
+Have fun with your photos!
+
+The gphoto2 team.
+
 
 --------------------------------------------------------------------------------
 				gphoto2-2.0beta4
@@ -6,7 +28,7 @@
 Hello lovers of digital cameras, gphoto2-beta4 is out! 
 
 As you probably know, the word beta doesn't keep us from adding lots 
-of new features:   
+of new features:
    * Added/Improved cameras support (Canon PowerShot S30, ...),
    * Most functions report progress and are cancellable,
    * Support for Samsung 800k, PTP cameras,
diff --git a/README b/README
index f5d9a51c4..3f1c9fe05 100644
--- a/README
+++ b/README
@@ -2,7 +2,7 @@
 				   libgphoto2
 				   ----------
 
-Hello and welcome to the wonderful world of gphoto! This is gphoto2, the 
+Hello and welcome to the wonderful world of gphoto! This is libgphoto2, the 
 successor of gphoto with lots of new features and additional camera
 drivers. 
 
@@ -45,8 +45,9 @@ Then, there are cameras supporting the so-called USB Mass Storage protocol.
 This is a protocol that has been published and lets you access any storage
 device, be it a camera or a disk connected via USB to your computer. As there
 are already drivers for this protocol out there, you don't need an additional
-library like libgphoto2. As of now, the following cameras seem to support the 
-USB Mass Storage protocol:
+library like libgphoto2. As of now, at least the following cameras
+seem to support the USB Mass Storage protocol:
+
  * Casio QV [2x00,3x00,8000]
  * Fuji FinePix S1 Pro, [1400,2400,4700]Zoom, 1300, 4500
  * HP PhotoSmart 315, 618, 912
@@ -59,16 +60,20 @@ USB Mass Storage protocol:
    C-4040Zoom, D-510, E-10
  * Pentax Optio 330
  * Sony DSC-F505(V), DSC-P1, DSC-P5, DSC-P20, DSC-P30, DSC-F707
-Again, those cameras cannot be accessed through libgphoto2.
+
+Again, those cameras *cannot* be accessed through libgphoto2.
 
 Other camera support a protocol called PTP or USB Imaging Devices that has
 been developped by Kodak and other. libgphoto2 does not fully support PTP yet
-and needs some testing. Here is a short list of camera that use this protocol:
+and needs some testing. Here is a short incomplete list of camera that
+use this protocol:
+
  * HP PhotoSmart 318, 612, 715
  * Kodak DC-4800, DX-3215, DX-3500, DX-3600, DX-3700, DX-3900, MC3 and all the
    camera that use Kodak Easy Share(tm) system.
  * Sony DSC-P5, DSC-F707, DSC-P30, DSC-P50, DSC-S75, DSC-S85, MVC-CD300
    (all need user configuration of the camera)
+
 You may try jPhoto <http://jphoto.sourceforge.net/> for ptp cameras
 alternatively if libgphoto2 fails.
 
@@ -89,20 +94,15 @@ The gPhoto2 Manual.
 
 It is available at the following places:
 
- - (non-officially) at
-   http://n-dimensional.de/projects/digicam/The_gPhoto2_Manual/
+ - At the gphoto website: http://gphoto.net/
 
  - In the CVS module gphoto2-manual
 
- - If you are using packages (RPM, DEB, Port, or similar)
-   or compiled yourself:
-   Probably somewhere in /usr/share/doc/*gphoto2*/
-
 The gPhoto2 Manual includes information about setting up USB
 hotplugging.
 
-If you run into problems, you may also consult the doc/FAQ file (or
-wherever your package maintainer put it).
+If you run into problems, you may also consult the FAQ (also included
+in The gPhoto2 Manual).
 
 
 Frontends
@@ -114,7 +114,7 @@ for a short description.
 
 For the GUI lovers, there are for example gtkam (GTK based), and
 GnoCam (GNOME). Additionally, there are plugins for other programs
-available like kio_gphoto (KDE - Konqueror). 
+available like kio_gphoto (KDE - Konqueror).
 
 
 Reporting Bugs