Improve man pages formatting (lists, italics, etc)

1 files changed, 43 insertions, 14 deletions

diff --git a/tgsend b/tgsend
index a757311..a889457 100755
--- a/tgsend
+++ b/tgsend
@@ -57,34 +57,63 @@ __END__
 
 =head1 NAME
 
-tgsend - Send message to a Telegram chat using a bot token
+tgsend - Send message to one or more Telegram chats
 
 =head1 SYNOPSIS
 
-tgsend [-h | --help] [-v]
+B<tgsend> [B<-h> | B<--help>] [B<-v>]
 
-tgsend [options] [chatid1 chatid2 ...]
+B<tgsend> [I<options>] I<chat_ids>...
 
 =head1 OPTIONS
 
-  --pretend | -p          Do not actually do anything
-  (--token | -t) <token>  Bot token (see AUTHENTICATION)
-  --version               Show version
-  --verbose | -v          Show more information (combine with -h to see full manual)
-  --help | -h             Show this message
+=over
+
+=item B<--pretend>, B<-p>
+
+Do not actually do anything
+
+=item B<--token>=I<token>, B<-t> I<token>
+
+Bot token (see B<AUTHENTICATION>)
+
+=item B<--version>
+
+Show version
+
+=item B<--verbose>, B<-v>
+
+Show more information (combine with B<-h> to see full manual)
+
+=item B<--help>, B<-h>
+
+Show this message
+
+=back
 
 =head1 DESCRIPTION
 
-This program sends its standard input to the Telegram chats whose IDs are passed
-as arguments, using the given bot token.
+This program will send its standard input to the given Telegram I<chat_ids>, from
+the bot identified by I<token>.
 
 =head1 AUTHENTICATION
 
 To get the bot token, this program will check (in order):
 
-  - The "--token" CLI argument
-  - The "TGUTILS_TOKEN" environment variable
-  - The contents of "$XDG_CONFIG_HOME/tgutils_token"
-    (usually ~/.config/tgutils_token)
+=over 2
+
+=item -
+
+The B<--token> CLI argument
+
+=item -
+
+The B<TGUTILS_TOKEN> environment variable
+
+=item -
+
+The contents of I<$XDG_CONFIG_HOME>B</tgutils_token> (usually B<~/.config/tgutils_token>)
+
+=back
 
 =cut