Import sources from 2011-03-30 iso image - sys/man

1 files changed, 146 insertions, 0 deletions

diff --git a/sys/man/1/bitsyload b/sys/man/1/bitsyload
new file mode 100755
index 000000000..e9c464614
--- /dev/null
+++ b/sys/man/1/bitsyload
@@ -0,0 +1,146 @@
+.TH BITSYLOAD 1
+.SH NAME
+bitsyload, light, pencal, keyboard, params, prompter \- bitsy-specific utilities
+.SH SYNOPSIS
+.PP
+.B bitsy/bitsyload
+.B k|r
+[
+.I file
+]
+.PP
+.B bitsy/light
+[
+.I intensity
+]
+.PP
+.B bitsy/params
+[
+.B \-f
+]
+.PP
+.B bitsy/pencal
+.PP
+.B bitsy/keyboard
+[
+.B \-n
+]
+.PP
+.B bitsy/prompter
+[
+.B \-n
+]
+.I file
+.SH DESCRIPTION
+.PP
+.I Bitsyload
+erases a section of flash memory on the Bitsy (iPAQ 3650 or 3830)
+and copies new
+information into it, using the format required by the Compaq
+boot loader.  The required first argument is the destination, either
+.B k
+for
+.B /dev/flash/kernel
+or
+.B r
+for
+.BR /dev/flash/ramdisk .
+The optional second argument is the name of the file
+to load.  The default kernel file is
+.B /sys/src/9/bitsy/9bitsy
+and the default ramdisk file is
+.BR /sys/src/9/bitsy/ramdisk .
+.PP
+.I Light
+sets the intensity of the display backlight.
+The
+values for
+.I intensity
+are:
+.IP on
+set intensity to maximum, the default
+.IP off
+turn off backlight
+.IP \fIn\fP
+sets the intensity to
+.IR n ,
+where
+.I n
+is a value between 0 and 128.  Intensity 0 doesn't
+turn off the backlight, it just sets it to the dimmest
+value.
+.PP
+.I Pencal
+calibrates the display with the touch screen on a Bitsy.
+It loops prompting the user with crosses whose center that the user
+must touch with the stylus.  After a consistent set of touches,
+it writes the calibration both to the kernel and to standard out.
+It is normally called by the bitsy's
+.BR /bin/cpurc .
+.PP
+.I Params
+copies the contents of the file
+.BR /dev/tmpparams ,
+into the flash partition,
+.BR /dev/flash/params ,
+or if the
+.B -f
+flag it set copies in the opposite direction.
+.PP
+.I Keyboard
+creates a virtual on-screen keyboard and, unless the
+.B -n
+option is specified, a scribble area.
+A user inputs characters by tapping the keys or
+by drawing characters in the
+scribble area (see
+.IR scribble (2)).
+It is usually run as the keyboard command for
+.IR rio (1)
+using
+.BR rio 's
+.B -k
+option.
+.PP
+.I Prompter
+is a small editor used to configure parameters when a Bitsy boots.
+It displays the file and starts up a keyboard and scribble pad for
+input.
+Clicking with the stylus in the text selects where input characters will go.
+Pressing Button 5 (top left side of the Bitsy) or typing the
+.B Esc
+key on the keyboard causes
+.I prompter
+to write back the updated file and exit;
+.B Del
+causes
+.I prompter
+to exit without writing the file.
+The
+.B -n
+flag suppresses the scribble area.
+.SH EXAMPLE
+.PP
+.IR Prompter ,
+.IR params ,
+and
+.I calibrate
+are used in only one place, the Bitsy's
+.BR /rc/bin/cpurc :
+.sp
+.EX
+# set variables
+ramfs
+bitsy/params -f
+if(! grep -s '^calibrate=' /tmp/tmpparams)
+	bitsy/pencal >>/tmp/tmpparams
+if not {
+	eval `{grep '^calibrate=' /tmp/tmpparams}
+	echo calibrate $calibrate > '#m/mousectl'
+}
+bitsy/prompter /tmp/tmpparams
+bitsy/params
+. /tmp/tmpparams
+.EE
+.SH SOURCE
+.B /sys/src/cmd/bitsy