- clarified some stream output code in the library, for hex/dec numbers
[barry.git] / man / btool.1
blobe9274bb2cc53676d89b7bdd9e8453e8acade0e77
1 .\"                                      Hey, EMACS: -*- nroff -*-
2 .\" First parameter, NAME, should be all caps
3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
4 .\" other parameters are allowed: see man(7), man(1)
5 .TH BTOOL 1 "February 1, 2007"
6 .\" Please adjust this date whenever revising the manpage.
7 .\"
8 .\" Some roff macros, for reference:
9 .\" .nh        disable hyphenation
10 .\" .hy        enable hyphenation
11 .\" .ad l      left justify
12 .\" .ad b      justify to both left and right margins
13 .\" .nf        disable filling
14 .\" .fi        enable filling
15 .\" .br        insert line break
16 .\" .sp <n>    insert n+1 empty lines
17 .\" for manpage-specific macros, see man(7)
18 .SH NAME
19 .B btool
20 \- Barry Project's program to interface with BlackBerry handheld
21 .SH SYNOPSIS
22 .B btool 
23 [-c dn][-d db[-r#][-R#]-D#]][-h][-l][-p pin][-s db -f file][-t][-v][-X]
24 .SH DESCRIPTION
25 .PP
26 .B btool
27 is a very early version of a program that communicates with a
28 BlackBerry device over USB; there is no intention to support ancient
29 serial-port BlackBerries.
30 Since the protocols used by BlackBerry are not documented 
31 by the manufacturer Research In Motion, this program is 
32 experimental and you \fBuse at own risk\fP. 
33 Be sure your device is backed up by another program
34 if it contains important data.
35 .PP
36 The -l option lists attached devices.
37 .PP
38 The -d option loads a database from the device and displays it to the screen.
39 .PP
40 The -s option saves a database to the device from the named file.
41 .PP
42 Use -h for description of the other options.
44 .SH AUTHOR
45 .B btool 
46 is part of the Barry project.
47 This manual page was written by Ian Darwin.
48 .SH SEE ALSO
49 .PP
50 http://www.netdirect.ca/software/packages/barry/index.php
51 .br
52 Especially the caveats, and the call for developers and others
53 to help with the project.
55