From 396f3b49cd03e28dfa7d3d7c03be3ffba9fb76db Mon Sep 17 00:00:00 2001
From: James Tomasino <james@tomasino.org>
Date: Tue, 9 Oct 2018 20:32:36 -0400
Subject: [PATCH] big cleanup on man page

---
 pb.1 | 60 +++++++++++++++++++++++++++++++++++++-----------------------
 1 file changed, 37 insertions(+), 23 deletions(-)

diff --git a/pb.1 b/pb.1
index 1edd2d6..469c579 100644
--- a/pb.1
+++ b/pb.1
@@ -1,16 +1,45 @@
 .TH PB 1 "16 August 2018" "v2018.08.16"
+
 .SH NAME
 pb \- a helper utility for using 0x0 pastebin services
+
 .SH SYNOPSIS
-.B pb [options] (filename)
+.B pb [-fucvh] [-s server_endpoint]
 .P
+
 .SH DESRIPTION
 .B pb
 provides an easy-to-use interface for uploading images
 or piping output to a 0x0 pastebin service. While it
 comes pre-configured with a specific pastebin, the
 service endpoint can be overridden.
-.SH USAGE
+
+Data input can be provided as an argument or via stdin.
+The data will be processed as an image, text or URL to
+be shortened based on the context.
+
+The options are as follows:
+
+.TP
+.B -f
+Explicitly interpret stdin as filename or names.
+.TP
+.B -s
+Use alternative pastebin server address.
+.TP
+.B -u
+Shorten a URL.
+.TP
+.B -c
+Pretty color output.
+.TP
+.B -v
+Display current version information.
+.TP 
+.B -h
+Show the help.
+
+.SH EXAMPLES
 .TP
 .B pb scores.txt
 Upload 'scores.txt' to the pastebin
@@ -22,28 +51,13 @@ Upload piped output to the pastebin
 Upload a list of files to the pastebin individually
 .B pb -s http://0x0.st scores.txt
 Upload a file to a different pastebin endpoint
-.SH DEPENDENCIES
-None.
-.SH OPTIONS
 .TP
-.B -f
-Explicitly interpret stdin as filename or names
-.TP
-.B -s <server_address>
-Use alternative pastebin server address
-.TP
-.B -u
-Shorten a URL provided as an argument or passed via stdin
-.TP
-.B -c
-Pretty color output
-.TP
-.B -v
-Display current version information.
-.TP 
-.B -h
-Show the help.
+.B pb -u 'https://tilde.team'
+Shorten the URL to tilde.team
+
 .SH BUGS
-None known.
+Report issues at the git repository at
+.B https://tildegit.org/tomasino/pb
+
 .SH AUTHOR
 James Tomasino <tomasino (at) lavabit (dot) com>