Mercurial > imgup

annotate imgup.1.in @ 7:1cf90affaa33

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
misc: rename the project to imgup
author David Demelier <markand@malikania.fr>
date Thu, 26 Nov 2020 19:13:08 +0100
parents
children 1146d3709a12
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 .\"
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 .\" Copyright (c) 2020 David Demelier <markand@malikania.fr>
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 .\"
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
4 .\" Permission to use, copy, modify, and/or distribute this software for any
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 .\" purpose with or without fee is hereby granted, provided that the above
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 .\" copyright notice and this permission notice appear in all copies.
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 .\"
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 .\"
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 .Dd 25 November, 2020
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 .Dt IMGUP 1
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
18 .Os
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 .\" NAME
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
20 .Sh NAME
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
21 .Nm imgup
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
22 .Nd simple image hosting service client
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
23 .\" SYNOPSIS
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
24 .Sh SYNOPSIS
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
25 .Nm
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
26 .Op Fl Dpv
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
27 .Op Fl a Ar author
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
28 .Op Fl d Ar duration
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
29 .Op Fl t Ar title
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 .Ar filename
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
31 .Ar host
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
32 .\" DESCRIPTION
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
33 .Sh DESCRIPTION
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
34 The
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
35 .Nm
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
36 tool is the convenient brother to
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
37 .Nm imgupd ,
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 it will upload an image into an instance.
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
39 .Pp
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 The
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
41 .Ar filename
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
42 argument must point to an image and the
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
43 .Ar host
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
44 argument is a URL where a
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
45 .Nm imgupd
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
46 instance is running.
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
47 .Pp
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
48 Available options:
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
49 .Bl -tag -width Ds
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
50 .It Fl D
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 List all supported durations.
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
52 .It Fl p
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
53 Store the image as public (default is private).
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
54 .It Fl v
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
55 Be more verbose.
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 .It Fl a Ar author
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 Sets the author, defaults to
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 .Dq Anonymous .
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
59 .It Fl d Ar duration
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
60 Sets the paste lifetime, defaults to
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
61 .Dq "day" .
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
62 .It Fl t Ar title
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
63 Sets a title to the paste, defaults to
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
64 .Dq "Untitled" .
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
65 .El
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
66 .\" EXAMPLES
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
67 .Sh EXAMPLES
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
68 .Ss Upload the image background.png with a title and an author.
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
69 .Bd -literal -offset
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
70 imgup -t "Nice background" -a Francis background.sh http://example.org
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
71 .Ed
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
72 .Ss Paste a short duration image.
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
73 .Bd -literal -offset
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
74 imgup -p -d hour secret.png http://example.org
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
75 .Ed
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
76 .\" AUTHORS
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
77 .Sh AUTHORS
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
78 .Nm
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
79 was written by David Demelier <markand@malikania.fr>
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
80 .\" SEE ALSO
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
81 .Sh SEE ALSO
1cf90affaa33 misc: rename the project to imgup
David Demelier <markand@malikania.fr>
parents:
diff changeset
82 .Xr imgupd 8