14
|
1 .\" |
|
2 .\" Copyright (c) 2020 David Demelier <markand@malikania.fr> |
|
3 .\" |
|
4 .\" Permission to use, copy, modify, and/or distribute this software for any |
|
5 .\" purpose with or without fee is hereby granted, provided that the above |
|
6 .\" copyright notice and this permission notice appear in all copies. |
|
7 .\" |
|
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
|
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
|
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
|
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
|
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
|
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
|
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
|
15 .\" |
|
16 .Dd 06 February, 2020 |
|
17 .Dt PASTER 1 |
|
18 .Os |
|
19 .\" NAME |
|
20 .Sh NAME |
|
21 .Nm paster |
|
22 .Nd simple paste service client |
|
23 .\" SYNOPSIS |
|
24 .Sh SYNOPSIS |
|
25 .Nm |
|
26 .Op Fl LDvx |
|
27 .Op Fl a Ar author |
|
28 .Op Fl l Ar language |
|
29 .Op Fl d Ar duration |
|
30 .Op Fl t Ar title |
|
31 .Ar filename |
|
32 .Ar host |
|
33 .\" DESCRIPTION |
|
34 .Sh DESCRIPTION |
|
35 The |
|
36 .Nm |
|
37 tool is the convenient brother to |
|
38 .Nm pasterd , |
|
39 it will paste some content into an instance. |
|
40 .Pp |
|
41 The |
|
42 .Ar filename |
|
43 argument can points to a file whose content will be pasted, if it is set to |
|
44 .Dq - |
|
45 then standard input is read instead. |
|
46 .Pp |
|
47 The |
|
48 .Ar host |
|
49 argument is a URL where a |
|
50 .Nm pasterd |
|
51 instance is running. |
|
52 .Pp |
|
53 Available options: |
|
54 .Bl -tag -width Ds |
|
55 .It Fl L |
|
56 List all supported languages. |
|
57 .It Fl D |
|
58 List all supported durations. |
|
59 .It Fl v |
|
60 Be more verbose. |
|
61 .It Fl x |
|
62 Store the paste as private. |
|
63 .It Fl a Ar author |
|
64 Sets the author, defaults to |
|
65 .Dq Anonymous . |
|
66 .It Fl l Ar language |
|
67 Sets the code snippet language, defaults to |
|
68 .Dq "nohighlight" . |
|
69 .It Fl d Ar duration |
|
70 Sets the paste lifetime, defaults to |
|
71 .Dq "month" . |
|
72 .It Fl t Ar title |
|
73 Sets a title to the paste, defaults to |
|
74 .Dq "Untitled" . |
|
75 .\" EXAMPLES |
|
76 .Sh EXAMPLES |
|
77 .Ss Paste the main.sh script shell with a title and an author. |
|
78 .Bd -literal -offset |
|
79 paster -t "Some shell script" -a Francis -l shell main.sh http://example.org |
|
80 .Ed |
|
81 .Ss Read standard input and paste it. |
|
82 .Bd -literal -offset |
|
83 grep error logs.txt | paster - http://example.org |
|
84 .Ed |
|
85 .Ss Paste a non-listed file with a short duration. |
|
86 .Bd -literal -offset |
|
87 paste -x -d hour private.txt http://example.org |
|
88 .Ed |
|
89 .\" SEE ALSO |
|
90 .Sh SEE ALSO |
|
91 .Xr pasterd 8 |