136 lines
3.8 KiB
Groff
136 lines
3.8 KiB
Groff
.\" Copyright (c) 1999
|
|
.\" Nik Clayton <nik@FreeBSD.org>
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY NIK CLAYTON ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" $FreeBSD: ports/palm/isilo/files/iSiloBSD.1,v 1.1 2000/02/03 20:53:29 nik Exp $
|
|
.\"
|
|
.Dd December 20, 1999
|
|
.Os FreeBSD 3.3
|
|
.Dt iSiloBSD 1
|
|
.Sh NAME
|
|
.Nm iSiloBSD
|
|
.Nd Convert text and HTML to iSilo Palm Pilot format
|
|
.Sh SYNOPSIS
|
|
.Nm iSiloBSD
|
|
.Op Ar -h | -?
|
|
.Nm iSiloBSD
|
|
.Op Fl cy
|
|
.Op Fl d Ns Ar max_depth
|
|
.Op Fl i Ns Ar title
|
|
.Op Fl I
|
|
.Op Fl Ialt
|
|
.Op Fl \&Ic
|
|
.Op Fl Id
|
|
.Op Fl Is Ns Ar max_width
|
|
.Op Fl Idef
|
|
.Op Fl rCR
|
|
.Op Fl rLF
|
|
.Op Fl sLB Ns Ar num_spaces
|
|
.Op Fl tLB Ns Ar num_breaks
|
|
.Op Fl tS Ns Ar num_spaces
|
|
source_file
|
|
.Op Ar target_file
|
|
.Sh DESCRIPTION
|
|
In the first synopsis form,
|
|
.Nm
|
|
displays a brief help message, and exits. In the second synopsis form,
|
|
.Nm
|
|
converts
|
|
.Ar source_file
|
|
to
|
|
.Pa source_file.pdb
|
|
or
|
|
.Ar target_file
|
|
if that option is provided.
|
|
.Pp
|
|
.Ar source_file
|
|
can be either plain text or HTML. If it is HTML then a good facsimile of
|
|
the formatting and links are retained in
|
|
.Ar target_file ,
|
|
as are (optionally) images.
|
|
.Pp
|
|
The following options are provided:
|
|
.Bl -tag -width XXXXXXXXXXXXXX
|
|
.It Fl c
|
|
Convert CR to LF.
|
|
.It Fl y
|
|
Overwrite the destination file if it exists.
|
|
.It Fl d Ns Ar max_depth
|
|
Maximum depth to follow links. 0 means only convert the first page.
|
|
.It Fl i Ns Ar title
|
|
The document title. Defaults to the name of the source file. Remember
|
|
to quote as necessary. E.g.,
|
|
.Qq Fl i Ns Ar The FreeBSD Handbook .
|
|
.It Fl I
|
|
Include images.
|
|
.It Fl Ialt
|
|
Include the alternative text for each image.
|
|
.It Fl \&Ic
|
|
Improve image contrast.
|
|
.It Fl Id
|
|
Dither images
|
|
.It Fl Is Ns Ar max_width
|
|
Scale images to at most
|
|
.Ar max_width
|
|
pixels wide. Defaults to 156 if not specified.
|
|
.It Fl Idef
|
|
Include images, and use these default options:
|
|
.Bl -tag -width XXXXXX
|
|
.It Fl Ialt
|
|
Include alternate text
|
|
.It Fl \&Ic
|
|
Improve image contrast
|
|
.It Fl Id
|
|
Dither images
|
|
.It Fl Is Ns Ar 156
|
|
Scale images to maximum 156 pixels
|
|
.El
|
|
.It Fl rCR
|
|
Remove CR characters.
|
|
.It Fl rLF
|
|
Remove LF characters.
|
|
.It Fl sLB Ns Ar num_spaces
|
|
Replace single line breaks with
|
|
.Ar num_spaces
|
|
spaces. If not specified, the default is 1.
|
|
.It Fl tLB Ns Ar num_breaks
|
|
Replace TAB characters with
|
|
.Ar num_breaks
|
|
line breaks. If not specified, the default is 2.
|
|
.It Fl tS Ns Ar num_spaces
|
|
Replace TAB characters with
|
|
.Ar num_spaces
|
|
spaces. If not specified, the default is 4.
|
|
.El
|
|
.Sh AUTHORS
|
|
ISilo, and
|
|
.Nm
|
|
are copyright DC & Co. For more information about iSilo, and to download
|
|
the Palm Pilot reader for iSilo format documents, go to
|
|
http://www.iSilo.com/.
|
|
.Pp
|
|
This manual page was written by
|
|
.An Nik Clayton Aq nik@FreeBSD.org .
|
|
|
|
|