In my tests, The help2man
utility produces better results than what you posted.
sudo apt-get install help2man
help2man -N --version-string=2.11 -o lgogdownloader.1 lgogdownloader
man -l lgogdownloader.1
(The -N suppresses the generation of a "The full documentation for ls is maintained as a Texinfo manual" message and specifying the version string manually via --version-string prevents help2man from erroring out for lack of a --version option on lgogdownloader.)
The help2man homepage also includes guidelines on what adjustments to the --help format will get the most out of the tool.
you're right that's much nicer:) adding a little info from my earlier effort and voila!:
.TH LGOGDOWNLOADER "1" "February 2014" "lgogdownloader 2.11" "User Commands"
lgogdownloader \- manual page for lgogdownloader 2.11
LGOGDownloader is a program for downloading games purchased from GOG.com. LGOGDownloader can also query GOG.com to see if game files have changed, it can download extras provided by GOG.com such as artwork and manuals. It is capable of downloading language specific installers for games where they exist. These games are currently for the Microsoft Windows(tm) and Apple(tm) systems only. To play these games under GNU/Linux will require wine or some similar program. Usage of such a program is outside the scope of this document.
\fB\-h\fR [ \fB\-\-help\fR ]
Print help message
List games with detailed info
Repair downloaded files
Use \fB\-\-repair\fR \fB\-\-download\fR to redownload files when
filesizes don't match (possibly different version).
Redownload will delete the old file
Set regular expression filter
for download/list/repair (Perl syntax)
Aliases: "all", "free"
Set download directory
\fB\-\-limit\-rate\fR arg (=0)
Limit download rate to value in kB
0 = unlimited
Create GOG XML for file
"automatic" to enable automatic XML creation
Set directory for GOG XML files
\fB\-\-chunk\-size\fR arg (=10)
Chunk size (in MB) when creating XML
Check for update notifications
\fB\-\-platform\fR arg (=1)
Select which installers are downloaded
1 = Windows
2 = Mac
3 = All
\fB\-\-language\fR arg (=1)
Select which language installers are downloaded
1 = English
2 = German
4 = French
8 = Polish
16 = Russian
32 = Chinese
64 = Czech
128 = Spanish
256 = Hungarian
512 = Italian
1024 = Japanese
2048 = Turkish
4096 = Portuguese
8192 = Korean
Add the values to download multiple languages
All = 16383
French + Polish = 4+8 = 12
Don't download/list/repair installers
Don't download/list/repair extras
Don't download/list/repair patches
Don't download/list/repair language packs
Don't download cover images
Don't use remote XML for repair
Don't use Unicode in the progress bar
Don't use coloring in the progress bar
Don't use duplicate handler for installers
Duplicate installers from different languages are
Print lots of information
Don't verify authenticity of SSL certificates
\fB\-\-timeout\fR arg (=10)
Set timeout for connection
Maximum time in seconds that connection phase is
allowed to take
Check for orphaned files (files found on local
filesystem that are not found on GOG servers). Sets
regular expression filter (Perl syntax) for files to
check. If no argument is given then the regex
defaults to '.*\e.(zip|exe|bin|dmg|old)$'
Show status of files
statuscode gamename filename filesize filehash
OK \- File is OK
ND \- File is not downloaded
MD5 \- MD5 mismatch, different version
Configuration files and cookies are stored in "$XDG_CONFIG_HOME/lgogdownloader".
If $XDG_CONFIG_HOME is not set it will use "$HOME/.config/lgogdownloader".
XML files are now stored in "$XDG_CACHE_HOME/lgogdownloader/xml".
If $XDG_CACHE_HOME is not set it will use "$HOME/.cache/lgogdownloader/xml".
.SH WEBSITE https://github.com/Sude-/lgogdownloader
not sure the formatting survives the pasting here though!