khelp and konqueror do not read man files properly.

[jim_holgate@…]

#! /bin/sh
# khelp and konqueror do not read the man files supplied
# with mplayer properly. This shell script will substitute
# ".IPs" with ".BI" in the mplayer.1 man document
# so that khelp and konqueror can read them properly.
# requires: sed, sh
# Open a command console (shell).
# Make this script executable (see man chmod)
# Log in with permission to edit the mplayer.1 document(s) (see man su)
# Syntax:
# fixMPlayerManual.sh <path to man file>
# Example:
# ./fixMPlayerManual.sh usr/local/man/man1/mplayer.1
# --------------------------------------------------------------
# You could also fix the man file(s) with a text editor.
# I hereby release this script to the public domain.
# No warranty. No support.
# --------------------------------------------------------------
sed s/".IPs"/".BI"/ < $1 > delete_me
mv delete_me $1

[diego@…]

So how is this a bug in the man page and not in khelp/konqueror?

[jim_holgate@…]

Thank you for your comment. Most man files in my Debian based distribution use
the tag ".BI" instead of ".IPs", and by changing the mplayer man file I was able
to make it readable by khelp, konqueror as well as the console.

If you would like to change the original man files to be make them more widely
usable, you are most welcome. However, if not, at least this bug report might
help someone who has an unusable help system to figure out how to fix it.

Thanks again for your comment.

[diego@…]

.BI and .IPs are not the same. .IPs is a macro in our man page to create
indented paragraphs , .BI is a standard man macro to alternate bold and italic
typefaces.