give source files a directory of their own
[blorb-thumbnailer.git] / blorb-thumbnailer.1
blob4bc90154fb25e1b3693ce21e573899a3aed7d0a6
1 .TH BLORB-THUMBNAILER 1 2011-02-13
2 .SH NAME
3 blorb-thumbnailer \- generate a thumbnail preview of a Blorb file
4 .SH SYNOPSIS
5 .B blorb-thumbnailer
6 .I input output
7 .RI [ size ]
8 .SH DESCRIPTION
9 Reads
10 .I input
11 (an existing blorb) to produce
12 .I output
13 (a PNG-format thumbnail image no more than
14 .I size
15 pixels square). Both
16 .I input
17 and
18 .I output
19 are assumed to be file names; the latter will be overwritten if it
20 exists.
22 Runs silently except for a brief usage reminder to standard output if
23 called with too few arguments.
24 .SH EXIT STATUS
25 .IP 0
26 Successfully produced a thumbnail image.
27 .IP 1
28 Failed to produce a thumbnail. If 
29 .I input
30 is a valid Blorb file and there's no I/O trouble, it's possible the
31 Blorb in question lacks a designated frontispiece.
32 .SH SEE ALSO
33 .BR evince-thumbnailer (1)
34 .br
35 .BR i7 "(1), " fizmo "(6), " nfrotz (6)