source: archive/pilot-link.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 7.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY pilot-link-download-http "http://downloads.pilot-link.org/pilot-link-&pilot-link-version;.tar.bz2">
8 <!ENTITY pilot-link-download-ftp "&gentoo-ftp-repo;/pilot-link-&pilot-link-version;.tar.bz2">
9 <!ENTITY pilot-link-md5sum "c1f4db8f32a2ee916fedb9a2dac8aa26">
10 <!ENTITY pilot-link-size "964 KB">
11 <!ENTITY pilot-link-buildsize "20 MB">
12 <!ENTITY pilot-link-time "0.4 SBU">
13]>
14
15<sect1 id="pilot-link" xreflabel="pilot-link-&pilot-link-version;">
16 <?dbhtml filename="pilot-link.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>pilot-link-&pilot-link-version;</title>
23
24 <indexterm zone="pilot-link">
25 <primary sortas="a-Pilot-link">Pilot-link</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to pilot-link</title>
30
31 <para>The <application>pilot-link</application> package provides a suite of
32 tools containing a series of conduits, libraries, and language bindings for
33 moving information to and from your Palm device and your desktop or
34 server/workstation system, as well as across a network.</para>
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>Download (HTTP): <ulink url="&pilot-link-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&pilot-link-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &pilot-link-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &pilot-link-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &pilot-link-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &pilot-link-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
59 <itemizedlist spacing="compact">
60 <listitem>
61 <para>Required patch: <ulink
62 url="&patch-root;/pilot-link-&pilot-link-version;-bindings_fix-1.patch"/></para>
63 </listitem>
64 </itemizedlist>
65
66 <bridgehead renderas="sect3">pilot-link Dependencies</bridgehead>
67
68 <bridgehead renderas="sect4">Optional</bridgehead>
69 <para role="optional"><xref linkend="libpng"/>,
70 <xref linkend="popt"/>,
71 <xref linkend="libusb-compat"/>,
72 <xref linkend="openjdk"/>, <!-- or <xref linkend="jdk"/>, -->
73 <xref linkend="tcl"/>,
74 <xref linkend="python2"/>,
75 <ulink url="http://www.bluez.org/">BlueZ</ulink>, and
76 <ulink url="http://perens.com/FreeSoftware/">Electric Fence</ulink></para>
77
78 <para condition="html" role="usernotes">User Notes:
79 <ulink url="&blfs-wiki;/pilot-link"/></para>
80
81 </sect2>
82
83 <sect2 role="kernel" id="pilot-link-kernel">
84 <title>Kernel Configuration</title>
85
86 <indexterm zone="pilot-link pilot-link-kernel">
87 <primary sortas="d-USB-Palm-devices">USB Palm devices</primary>
88 </indexterm>
89
90 <para>You may need to configure the <quote>USB_SERIAL_VISOR</quote> device
91 into the kernel before your system can communicate with your Palm device.
92 Add this device by enabling the following kernel parameter setting and
93 rebuilding the kernel (and modules, if applicable):</para>
94
95<screen><literal>Device Drivers:
96 USB support:
97 USB Serial Converter support:
98 USB Handspring Visor / Palm m50x / Sony Client Driver</literal></screen>
99
100 <para>For additional information about connecting your USB Palm device,
101 see: <ulink url="http://www.pilot-link.org/README.usb"/>.</para>
102
103 </sect2>
104
105 <sect2 role="installation">
106 <title>Installation of pilot-link</title>
107
108 <para>Install <application>pilot-link</application> by running the following
109 commands:</para>
110
111<screen><userinput>patch -Np1 -i ../pilot-link-&pilot-link-version;-bindings_fix-1.patch &amp;&amp;
112./configure --prefix=/usr \
113 --enable-threads \
114 --enable-conduits \
115 --with-perl &amp;&amp;
116make</userinput></screen>
117
118 <para>To test the results, issue: <command>make check</command>.</para>
119
120 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
121
122<screen role="root"><userinput>make install &amp;&amp;
123install -v -m755 -d /usr/share/doc/pilot-link-&pilot-link-version; &amp;&amp;
124install -v -m644 README doc/{README.*,TODO,CodingGuidelines} \
125 /usr/share/doc/pilot-link-&pilot-link-version;</userinput></screen>
126
127 </sect2>
128
129 <sect2 role="commands">
130 <title>Command Explanations</title>
131
132 <para><parameter>--enable-threads</parameter>: This parameter is required
133 to link the threading library into the build.</para>
134
135 <para><parameter>--enable-conduits</parameter>: This parameter is required
136 to build the userspace programs. Omit it if you only need the
137 <application>pilot-link</application> libraries.</para>
138
139 <para><parameter>--with-perl</parameter>: This parameter is required to
140 build the <application>Perl</application> bindings.</para>
141
142 <para><option>--with-java --with-tcl=/usr/lib
143 --with-python</option>: Use any or all of these options to enable the
144 respective language bindings desired.</para>
145
146 </sect2>
147
148 <sect2 role="content">
149 <title>Contents</title>
150
151 <segmentedlist>
152 <segtitle>Installed Programs</segtitle>
153 <segtitle>Installed Libraries</segtitle>
154 <segtitle>Installed Bindings</segtitle>
155 <segtitle>Installed Directory</segtitle>
156
157 <seglistitem>
158 <seg>pilot-650foto, pilot-addresses, pilot-clip, pilot-csd,
159 pilot-debugsh, pilot-dedupe, pilot-dlpsh, pilot-file, pilot-foto,
160 pilot-getram, pilot-getrom, pilot-getromtoken, pilot-hinotes,
161 pilot-ietf2datebook, pilot-install-datebook, pilot-install-expenses,
162 pilot-install-hinote, pilot-install-memo, pilot-install-netsync,
163 pilot-install-todo, pilot-install-todos, pilot-install-user,
164 pilot-memos, pilot-nredir, pilot-read-expenses, pilot-read-ical,
165 pilot-read-notepad, pilot-read-palmpix, pilot-read-screenshot,
166 pilot-read-todos, pilot-read-veo, pilot-reminders, pilot-schlep,
167 pilot-sync-plan, pilot-treofoto, pilot-undelete, pilot-wav,
168 pilot-xfer and optionally, pitclsh</seg>
169 <seg>libjpisock.so JDK library,
170 libpitcl.{so,a} <application>Tcl</application> library,
171 _pisock.so <application>Python</application> module and
172 Pilot.so <application>Perl</application> module</seg>
173 <seg>/usr/lib/perl5/site_perl/&lfs-perl-version;/i686-linux/auto/PDA,
174 /usr/share/doc/pilot-link-0.12.2 and/usr/share/pilot-link</seg>
175 </seglistitem>
176 </segmentedlist>
177
178 <variablelist>
179 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
180 <?dbfo list-presentation="list"?>
181 <?dbhtml list-presentation="table"?>
182
183 <varlistentry id="pilot-link-programs">
184 <term><command>pilot-link programs and utilities</command></term>
185 <listitem>
186 <para>Describing the functionality of each
187 <application>pilot-link</application> program and utility would take several
188 pages. Instead, after you've installed the package, review the
189 <application>pilot-link</application> man page
190 (<command>man pilot-link</command>). If you wish to review before installing
191 the package, unpack the tarball and issue
192 <command>man doc/man/pilot-link.7.in</command>.</para>
193 <indexterm zone="pilot-link pilot-link-programs">
194 <primary sortas="b-pilot-link-programs">pilot-link programs</primary>
195 </indexterm>
196 </listitem>
197 </varlistentry>
198 </variablelist>
199
200 </sect2>
201
202</sect1>
Note: See TracBrowser for help on using the repository browser.