- Synchronize with F-8 branch:

- Add README.fedora and visor configs as fallbacks (#280251: thanks Kevin
    Page)
- Don't tag HAL/PolicyKit files as %config (#427840)
- Remove visor module if currently loaded (#280251)

60-pilot.perms

@@ -0,0 +1,2 @@
+<ttyUSB>=/dev/ttyUSB*
+<console>  0660 <ttyUSB> 0660 root.uucp

60-pilot.rules

@@ -0,0 +1 @@
+BUS=="usb", SYSFS{product}=="Palm Handheld*|Handspring*",KERNEL=="ttyUSB*",NAME="ttyUSB%n", SYMLINK="pilot", GROUP="uucp", MODE="0660"

README.fedora

@@ -0,0 +1,55 @@
+Additional information for Fedora pilot-link users
+==================================================
+
+pilot-link-0.12.2-10.fc8 and later versions are configured to enable 
+the use of libusb for console users - permissions are now handled by
+PolicyKit. For more information on libusb see README.libusb.
+
+IMPORTANT:
+
+If your Palm device is plugged in at the time of the upgrade (or you
+are experiencing difficuly with having the Palm device recognized) you
+should probably unplug and replugin in your device after the upgrade
+for the new HAL configuration to take effect.
+
+pilot-link libusb support is relatively new and may still be 
+incompatible with some handheld devices. If you experience such a
+problem you may want to try the older "visor module" USB method 
+described below. If possible please report device incompatibility to:
+https://bugzilla.redhat.com/show_bug.cgi?id=280251
+
+
+Visor module setup
+------------------
+
+The Visor module is a backwards compatibility solution to expose the USB
+connection of newer Palm handhelds as a serial device, which is what
+older versions of pilot-link and dependent packages require to work.
+
+Unfortunately this solution is inherently imperfect when used with udev
+(as Fedora does) - you may have to tweak your individual setup.
+
+1) disable libusb: remove (or comment out the contents) of
+/etc/modprobe.d/blacklist-visor
+
+2) Configure udev to detect the Palm and create /dev/pilot: copy
+60-pilot.rules from /usr/share/pilot-link/udev/ to /etc/udev/rules.d/
+
+3) Configure permissions so that a console user can access /dev/pilot:
+copy 60-pilot.perms from /usr/share/pilot-link/udev/ to
+/etc/security/console.perms.d/
+
+For a discussion of the inherent problems related to the Visor module,
+see:
+https://bugzilla.redhat.com/show_bug.cgi?id=158809
+
+
+Old serial (non-USB) handhelds
+------------------------------
+
+Older serial (non-USB) handhelds can be directly addressed by pilot link
+on their serial port (e.g. /dev/ttyS0) or /dev/pilot can be symlinked to
+the serial port.
+
+Kevin R. Page, 2007-12-11
+Alex Lancaster, 2008-01-07

pilot-link.spec

@@ -3,7 +3,7 @@
 
 Name: pilot-link
 Version: 0.12.3
-Release: 3%{?dist}
+Release: 4%{?dist}
 Epoch: 2
 License: GPLv2 and GPLv2+ and LGPLv2+ and TCL
 Group: Applications/Communications
@@ -14,6 +14,9 @@ Source0: pilot-link-%{version}.tar.bz2
 Source1: 19-pam-acl-management.fdi
 Source2: pilot-device-file.policy
 Source3: blacklist-visor
+Source4: README.fedora
+Source5: 60-pilot.perms
+Source6: 60-pilot.rules
 
 ExcludeArch: s390 s390x
 #Patch1: pilot-link-0.11.0-perlmd5.patch  # May be still applied
@@ -23,7 +26,8 @@ Patch4: pilot-link-0.12.1-var.patch
 Patch6: pilot-link-0.12.2-open.patch
 Patch7: pilot-link-0.12.3-md5.patch
 
-Requires: /sbin/ldconfig
+Requires(post): /sbin/ldconfig, /sbin/modprobe
+Requires(postun): /sbin/ldconfig
 
 %if %{support_perl}
 Requires:      perl(:MODULE_COMPAT_%{perl_version})
@@ -55,6 +59,7 @@ Requires: %{name} = %{epoch}:%{version}-%{release}
 Requires: libpng-devel
 Requires: readline-devel
 
+
 %description devel
 This package contains the development headers that are used to build
 the pilot-link package. It also includes the static libraries
@@ -145,16 +150,29 @@ install -p -m644 %{SOURCE2} %{buildroot}%{_datadir}/PolicyKit/policy/pilot-devic
 mkdir -p %{buildroot}%{_sysconfdir}/modprobe.d/
 install -p -m644 %{SOURCE3} %{buildroot}%{_sysconfdir}/modprobe.d/blacklist-visor
 
-%post -p /sbin/ldconfig
+# put README.fedora into tree
+cp %{SOURCE4} README.fedora
 
-%postun -p /sbin/ldconfig
+# install visor configs to share/udev
+install -p -m644 %{SOURCE5} %{buildroot}%{_datadir}/pilot-link/udev
+install -p -m644 %{SOURCE6} %{buildroot}%{_datadir}/pilot-link/udev
+
+%post 
+/sbin/ldconfig
+if [ $1 = 2 ]; then
+# only attempt to remove visor module on upgrade, not needed for fresh install
+   /sbin/modprobe -s -r visor > /dev/null 2>&1
+fi
+
+%postun
+/sbin/ldconfig
 
 %clean
 rm -rf %{buildroot}
 
 %files
 %defattr(-,root,root,-)
-%doc COPYING ChangeLog README NEWS doc/README.usb doc/README.debugging doc/README.libusb
+%doc COPYING ChangeLog README NEWS doc/README.usb doc/README.debugging doc/README.libusb README.fedora
 %{_libdir}/*.so.*
 %if %{support_perl}
 %{perl_vendorarch}/auto/*
@@ -163,8 +181,8 @@ rm -rf %{buildroot}
 %{_bindir}/*
 %{_datadir}/pilot-link
 %{_mandir}/man?/*
-%config(noreplace) %{_datadir}/hal/fdi/policy/10osvendor/19-pam-acl-management.fdi
-%config(noreplace) %{_datadir}/PolicyKit/policy/pilot-device-file.policy
+%{_datadir}/hal/fdi/policy/10osvendor/19-pam-acl-management.fdi
+%{_datadir}/PolicyKit/policy/pilot-device-file.policy
 %config(noreplace) %{_sysconfdir}/modprobe.d/blacklist-visor
 
 %files devel
@@ -175,6 +193,12 @@ rm -rf %{buildroot}
 %{_datadir}/aclocal/*.m4
 
 %changelog
+* Mon Jan  7 2008 Alex Lancaster <alexlan[AT]fedoraproject org> - 2:0.12.3-4
+- Synchronize with F-8 branch: 
+- Add README.fedora and visor configs as fallbacks (#280251: thanks Kevin Page)
+- Don't tag HAL/PolicyKit files as %config (#427840)
+- Remove visor module if currently loaded (#280251)
+
 * Fri Jan  4 2008 Alex Lancaster <alexlan[AT]fedoraproject org> - 2:0.12.3-3
 - Synchronize with F-8 branch: add HAL, PolicyKit rules (#280251)