[quote user="Euler GERMAN"]
Hi Melissa,
I know it can be very frustrating, but it would help a lot if you could provide real information about your system, not just a Windows crash dialog. We need a starting point to guess what may be causing this behavior.
Let's begin with your Pegasus Mail version. Than you can also inform IERenderer and/or BearHTML versions (open an HTML message and click Shift+F1. Version is shown on title bar [IERenderer] or on status bar [BearHTML]). Most likely what may be causing the crash was already sorted on updated versions of those programs.
[/quote]
I've tried replying to this TWICE already and someone ( moderator? ) is blocking me and deleting my replies. Wait, working now...
Pegasus 4.73.639.
The Bear thing only gives me this:
BEARHTML Help
Shift + F1 displays Bearhtml version information and switches between this help and the message shown
before
BearHtml HomePage
BearHtml at Community
Contents:
Bearhtml.ini
Cache'ing
CSS
Charsets
CopyRights
Font sizing
Fetching
FTP links
Graphics
IDN
Installation
Introduction
Invalid Html
Keyboard
Logging
Phishing
Printing
Print Preview
Proxy Servers
Redirection
Scripting
Scrolling
Styles
Suspicious HTML
Timeout
Un-install
Keyboard
Pg Up/Pg Dn |
Scrolls display by a page |
Shift + Pg Up/Pg Dn |
Scrolls and selects by a page |
Home/End |
Scrolls to beginning/end of line |
Shift + Home/End |
Scrolls & Selects to beginning/end of line |
Shift + Ctrl + Home/End |
Scrolls & Selects to beginning/end of document |
Left/Right Arrow |
Scrolls by char |
Shift + Left/Right Arrow |
Scrolls & Selects chars |
Ctrl + Left/Right Arrow |
Scrolls by words |
Shift + Ctrl + Left/Right Arrow |
Scrolls & Selects words |
DoubleClick |
Selects current word |
Up/Down Arrow |
Scrolls by line |
Mousewheel |
Scrolls by line (+) |
Shift + Up/Down Arrow |
Scrolls & Selects lines |
Shift + F8 |
Select current line |
Ctrl + C |
Copy selected text to Clipboard |
Ctrl + A |
Select All |
SpaceBar |
Scrolls down a page |
Ctrl + SpaceBar |
Scrolls up a page |
Ctrl + Mousewheel (removed) |
Attempt to Decrease/Increase fontsize (*) |
Numpad '/' (÷) or '*' |
Attempt to Decrease/Increase fontsize (*) |
'<' or '>' |
Attempt to Decrease/Increase fontsize (*) |
'Ctrl + PageDown/PageUp |
Attempt to Decrease/Increase fontsize (*) |
Shift + Ctrl + 'N' |
Enable/disable Preview print page |
Shift + Ctrl + 'P' |
Print html page |
Shift + Ctrl + 'R' |
Enable/disable CSS coding |
Shift + Ctrl + 'S' |
Enable/disable STYLE tags |
Shift + Ctrl + 'U' |
Display remote graphics |
Shift + Ctrl + 'Y' |
Clear remote graphics cache |
(*) For different keyboards
(+) See Mousewheel scrolling amounts in Bearhtml.ini
Top
Introduction.
Bearhtml is an Html page renderer (displayer), it is not a
browser. Bearhtml supports Html 3.2 and parts of Html 4.1/XHTML.
CSS (Style definitions) is supported at level 1 and partly at level 2.
Failure to display a page may be for one of two main
reasons:
- Badly coded Html or unsupported Html/CSS
- Dynamic coding (scripting)
In either case you can attempt to view the page by right clicking
and selecting "Show in Browser"
Top
Graphics
Remote URL location graphics files are displayed as gray boxes; To see remote
graphics, key in Shift + Ctrl + 'U', or right click in the message
area (not on a graphic area) and select "Show picture", or ensure
that Message Reader option is set to choose fetching automatically.
There will be a delay while graphics are fetched. If a timeout occurs while downloading graphics,
you will see a warning on the Pegasus Mail status line, and further downloading
for the current message will stop. Increasing the MaxFetchtime= amount will allow some timeouts to be overcome.
While remote graphics are being downloaded, a counter can be seen to show
progress. Do not close the message until this counter completes the countdown.
In the case of corrupt or truncated graphics files a small box with
an exclamation point inside it will be displayed to indicate the
presence of an undisplayable graphic. Unavailable graphics files
will stay as a gray box
Images can be captured by right-clicking on the image. A Save file dialog will appear.
Images used to track access to a remote site, typically given a set of image dimensions to make
the image almost invisible can be problematic. A file BearTracking.txt can be used to deny
downloads from a host listed in Beartracking.txt.
Timeout
Can occur if the time to download a remote graphic exceeds the value set in Bearhtml.ini
on the MaxfetchTime= line. Attempting to fetch all further remote graphics is stopped
and these graphics will be replaced by a gray box. To retry, key in Shift + Ctrl + U.
CSS
CSS style tags are a method of enhancing HTML based content.
Unlike Html, CSS is ever-improving and adding new features. Bearhtml has full
support for CSS V1, and limited support for CSS V2. There is no support for CSS V3 onwards.
toggle keystroke sequence (Shift + Ctrl + "R") to enable or disable CSS then re-open the message.
Status line shows current state after a toggle.
Alternatively use the "Open in Browser" right click menu to invoke a full browser.
Note that Style tags commonly contain CSS content, so if WantCSS= Bearhtml.ini is set to
WantCSS=No, this will also signal that Style content is to be ignored.
Top
Invalid Html
If Bearhtml is unable to display the html message this causes
LibTidy to be invoked to attempt a repair. An attempt is then made
to display the repaired message. If this fails the original source
html is shown in the display area. Failure at this point indicates
a seriously flawed html message. If the display is blank or badly
formatted, right click and select "Open in web browser".
Top
Character sets
Html is displayed using the users normal character set (eg
ISO-8859-1). If you see blank white squares where text should
appear, this is a sign that the sender is using a different
character set. Repeat the troubleshooting method above, but when in
your browser go to View/Character Encoding and select one of the
methods shown in the list. If one of these makes the message
readable, you should inform the sender of the character set
problem, and have them identify the character set they use in the
message headers.
Unicode character set is supported in both Big and Little Endian forms,
and is converted to Utf-8 to be displayed in Pegasus Mail.
Top
IDN
Url link targets that are encoded to the IDN protocol to allow display of accented
characters, will be displayed with the accented characters properly formatted, on
the Status line, and in the Link bubble comment.
Top
Suspicious Html
Urls that are clicked are checked for possibility of being
dangerous, ie Fraudulent asking for personal information
Specifically:
If a problem is detected a dialog will prompt you. Clicking OK will
invoke the browser. Clicking Cancel, the Url will be remembered for
the rest of the Pegasus Mail session. Moving the mouse cursor over
the Url again will cause the mouse cursor to turn into a stop
sign.
For BlackList checking: WantBl=Yes/No in BearHtml.ini. Click on the
Url link. The status line will show result.
If you want more detail check Bearhtml.log for the Blacklist
message. It will show an IP address last number "n" (127.0.0.n) that
resolves according to which SURBL.ORG combination of lists it
occurs in. See SURBl for its
current list.
Top
Phishing detection
In addition to blacklist validation, Bearhtml will also examine the
clickable link in the display. If well known and reputable
businesses domain names occur anywhere other than in the correct
part of a Url, a warning dialog will be displayed. Users can
maintain the list in Bearwarn.txt with their own domains. See
Bearwarn.txt for more info. You are STRONGLY recommended to
add the domain info (do not add the "www" portion of the Url address)
for your local bank(s) and credit card companies
Top
Scripting
No form of scripting is supported, ie Javascript. Any such coding
in a message is ignored. This makes the display of such messages
problematic. If needed this html should be passed to a full browser
.
In addition all requests for setting or retrieving Cookies are
ignored.
Top
FTP URL links
Bearhtml does not support Url links that attempt to establish an FTP session in
order to transfer files. You will see a status comment "Protocol refused: File://"
and a dialog will appear saying that FTP Url has been copied to
your clipboard. If you want to handle the FTP Url, open your browser and
paste in the Url in your clipboard. Then you can click on the FTP
download request in your browser and it will either Save or Open the file.
Top
Printing
Users can request Header and Footer information be added to the
print pages. See PrtFlags= line in Bearhtml.ini. The font used to
produce the page header and footer is defined through the
DefaultFontName= and DefaultFontSize= coded in Bearhtml.ini. The
current Body text size (adjustable) will be used when printing the
body.
Messages with large recipient lists may cause header truncation ( 7 cms reserved).
Top
Print Preview
Users can enable previewing of print by adding a line to Bearhtml.ini that requests it,
ie: preview=yes. Alternatively while viewing a message, key in Shift + Ctrl + N to toggle preview on/off.
Current status will show on Pegasus Mail status line. Once in Print Preview mode,
click Print button to print content.
Clicking on Next/Prev buttons scrolls pages.
Zooming in/out on text can be achieved by clicking on the magnifying glass.
Top
Styles
Remote URL location styles are not fetched.
With the introduction of CSS V3, the whole operation of STYLE tags has changed to more closely match the way that CLASS tag in CSS works.
Processing Style tags can be enabled, or disabled by using the WantStyle= in Bearhtml.ini (default is WantStyle=false ) or key'ing in
Shift + Ctrl + "S" to
flip between enabled or disabled state, then re-open the message. The default is to run disabled.
The Pegasus Mail status line will briefly show the newly set state.
Top
Fonts sizing/color
Increasing or decreasing the default fontsize using the Ctrl +
mousewheel may not work in all cases, and may cause strange
formatting in some cases. If a message already has coded font
sizes, these will override any default size. Secondly any message
with parts coded with a font size, and other parts left to the
default size may appear poorly formatted. Note there are multiple
keyboard methods to adjust font size in the list above.
Similarily by using DefaultFontColor= you can opt to display the
message text in any Windows defined color. Examples are:
Black Blue
Teal Aqua
Top
Logging
For problem investigation a log file can be created in the Pegasus
Mail NewMail directory (eg c:\pmail\mail), it is a text file with
name of Bearhtml.log, that can be reviewed using Notepad etc.
Top
Scrolling
There are two forms of scrolling up or down a webpage. Scrollbars
on the edge of the display and keyboard characters. In the case of
scrollbars, this always uses the Windows standard feature of moving
by an amount of pixels in either direction, regardless of where the
text cursor is located.
Using the keyboard performs text sensitive scrolling movements to
move by an amount of "lines" and relocate the text cursor. In this
case the distance scrolled can be an amount easily explained, or in
the case of mixed text and graphics the distance scrolled can be
quite difficult to explain. Bearhtml will for instance scroll
up/down by a page height of pixels and try to find the new line of
text completely in view to place the cursor.
Top
Redirection
Http protocol allows that a Url request be modified by the web
server to fetch an object (page or image) from another location.
Bearhtml can support this feature but by default is disabled. Care
must be taken in choosing to enable redirection. It is beyond the
scope of this file to describe the risks. See Google searches such
as:
http://computing-dictionary.thefreedictionary.com/Http+redirection
Top
Remote image fetching
For most of the time the default process to download graphics is called ReadWebData,
but an alternative can be selected when ReadWebData breaks. It is called GetUrl.
The keyword RemoteFetch= can be coded as either RemoteFetch=1 (default) or
Remotefetch=2 to select GetUrl. This is an advanced setting that should not be used unless
other avenues have been explored. The most likely reasom would be a problem with SSL certificates.
Top
Cache'ing
If enabled (by WantCache=yes), a copy of downloaded graphic files
is kept and subsequent requests for the same graphic are supplied
from cache. Cache can be cleared at any time by keying in Ctrl +
Shift + Y. Cache-days= influences how long files are kept in the
cache.
Top
Proxy Servers
For some installations, workstations are not allowed to connect to
the Internet directly. They are instead required to connect to a
local proxy server. The proxyserver= value allows this server to be
identified and port number to be used. Users of Microsoft's
Internet Explorer may have this proxy server already configured.
See IE menu Tools/Internet Options/Connections/LAN settings. The
same information may be found in Firefox menu
Tools/Options/General/Connection Settings. Bearhtml at presnt only
checks the Windows Registry for I.E configuration values.
Top
Installation
- Shut-down Pegasus Mail
- Unzip the content of the new bearhtml.zip into the Pegasus Mail
executables directory (eg: c:\pmail).
- If required, edit Bearhtml.ini and Bearwarn.txt
- If required, save Bearhtml.ini into the user NewMail directory
to override the default location values
- Restart Pegasus Mail
Top
Un-Install
- Shut-down Pegasus Mail
- Rename or delete Bearhtml.dll
- Restart Pegasus Mail
Top
Contents of Bearhtml.ini
- ScrollPixels= (default 20) pixel height to move for
mousewheel
- ScrollRepeat= (default 1) repeat scroll for mousewheel
- ScrollDelayMs= (default 1mSec) delay between scrolls for
mousewheel
- DefaultFontSize= (default 12) Display font size
- DefaultFontName= (default Arial) Font to use
- DefaultFontColor= (default Black) Text color to use, if not
pre-defined
- WantBl= (default No, Yes/No) Blacklist checking
- WantCache= (default Yes, Yes/No) Save graphics in Newmail
sub-directory RmtFiles. Files with extension type .Rmt and .Cac are
created
- cache-days= (default 1) If WantCache=yes then operate a elapsed
time cache, keeping remote graphics cache'd beyond a Pegasus Mail
session. Cache-days=0 keeps remote graphics for remainder of the
current day only.
- LocalIPAddress= (no default, use to avoid local non-routable
numeric addresses such as 127.0.0.1 causing Phishing warnings,
multiple addresses separated by commas.
ie localIPAddress=127.0.0,192.168 would exclude 127.0.0.n and
192.168.n.n.
- Redirection= ( default No) Http Url redirect to alternative
location (risk)
- proxyserver= (no default, code per example:
http://127.0.0.1:8080)
- Skype= (full pathname to Skype executable). Used for Callto:
and Skype: protocols
- PrinterSetup= (default Yes) Allow printer selection for html
printing
- Prtflags= (default 3) 1 = Headers, 2 = Footer, 3 = Both
- Preview= (default = Yes) display in Print preview mode
- Shortinfo= (default Yes) show only domain name in Hint window
Url.
- WarnExtensions= (default .EXE.SCR.PIF) detect risky file
extension types on Urls
- UnloadWinInet= (default=No) Only use to force unloading of WinInet.dll>
- WantUrlRequest= (default = yes) Urls with "?" character
- WantCSS= (default = no) process CSS
- RemoteFetch= (default = 1) Select procedure to fetch remote graphics (troubleshooting)
- FixGoogle= (default = No) Temporary fix for Google Alerts image downloading problem
- FixAmazon= (default = yes) Correct wrongly coded font sizing
- MaxFetchTime= (default 15 seconds )
- Loglevel= (default 3) Uses same reporting levels as Pegasus
Mail, ie
Loglevel=1 Reports critical Bearhtml function errors |
Loglevel=2 Reports Loglevel=1 and serious errors |
Loglevel=3 Reports Loglevel=1-2 and normal events |
Loglevel=4 Reports Loglevel 1-3 and detailed transaction
information |
Loglevel=5-8 Reports Loglevel 1-8 (all levels) and Tidy html warnings and
errors |
Top
Copyrights
Top
[quote user="Euler GERMAN"]<p>Hi Melissa,</p><p>I know it can be very frustrating, but it would help a lot if you could provide real information about your system, not just a Windows crash dialog. We need a starting point to guess what may be causing this behavior.
</p><p>Let's begin with your Pegasus Mail version. Than you can also inform IERenderer and/or BearHTML versions (open an HTML message and click Shift+F1. Version is shown on title bar [IERenderer] or on status bar [BearHTML]). Most likely what may be causing the crash was already sorted on updated versions of those programs.</p><p>&nbsp;</p><p>[/quote]</p><p>&nbsp;</p><p>I've tried replying to this TWICE already and someone ( moderator? ) is blocking me and deleting my replies. Wait, working now...</p><p>&nbsp;</p><p>Pegasus 4.73.639.</p><p>&nbsp;The Bear thing only gives me this:</p><p>&nbsp;</p><h2>BEARHTML Help</h2>
<h4>Shift + F1 displays Bearhtml version information and switches between this help and the message shown
before</h4>
<a href="http://www3.telus.net/public/irelam/">BearHtml HomePage</a>
&nbsp;&nbsp;
<a href="http://community.pmail.com/files/folders/pegadd/default.aspx">BearHtml at Community</a>
<p>
<a name="top" class=""></a>Contents:
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#bearini">Bearhtml.ini</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#cache">Cache'ing</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#css">CSS</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#charsets">Charsets</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#copyrites">CopyRights</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#fontsizing">Font sizing</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#fetching">Fetching</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#ftp">FTP links</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#graphics">Graphics</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#idna">IDN</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#installation">Installation</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#intro">Introduction</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#invalid">Invalid Html</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#keyboard">Keyboard</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#logging">Logging</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#phishing">Phishing</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#printing">Printing</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#preview">Print Preview</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#proxy">Proxy Servers</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#redirection">Redirection</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#scripting">Scripting</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#scrolling">Scrolling</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#styles">Styles</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#suspicious">Suspicious HTML</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#timeout">Timeout</a>
&nbsp;<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#uninstall">Un-install</a>
<a name="keyboard" class=""></a>
</p><h3>Keyboard</h3>
<table border="1">
<tbody>
<tr>
<td>Pg Up/Pg Dn</td>
<td>Scrolls display by a page</td>
</tr>
<tr>
<td>Shift + Pg Up/Pg Dn</td>
<td>Scrolls and selects by a page</td>
</tr>
<tr>
<td>Home/End</td>
<td>Scrolls to beginning/end of line</td>
</tr>
<tr>
<td>Shift + Home/End</td>
<td>Scrolls &amp; Selects to beginning/end of line</td>
</tr>
<tr>
<td>Shift + Ctrl + Home/End</td>
<td>Scrolls &amp; Selects to beginning/end of document</td>
</tr>
<tr>
<td>Left/Right Arrow</td>
<td>Scrolls by char</td>
</tr>
<tr>
<td>Shift + Left/Right Arrow</td>
<td>Scrolls &amp; Selects chars</td>
</tr>
<tr>
<td>Ctrl + Left/Right Arrow</td>
<td>Scrolls by words</td>
</tr>
<tr>
<td>Shift + Ctrl + Left/Right Arrow</td>
<td>Scrolls &amp; Selects words</td>
</tr>
<tr>
<td>DoubleClick</td>
<td>Selects current word</td>
</tr>
<tr>
<td>Up/Down Arrow</td>
<td>Scrolls by line</td>
</tr>
<tr>
<td>Mousewheel</td>
<td>Scrolls by line (+)</td>
</tr>
<tr>
<td>Shift + Up/Down Arrow</td>
<td>Scrolls &amp; Selects lines</td>
</tr>
<tr>
<td>Shift + F8</td>
<td>Select current line</td>
</tr>
<tr>
<td>Ctrl + C</td>
<td>Copy selected text to Clipboard</td>
</tr>
<tr>
<td>Ctrl + A</td>
<td>Select All</td>
</tr>
<tr>
<td>SpaceBar</td>
<td>Scrolls down a page</td>
</tr>
<tr>
<td>Ctrl + SpaceBar</td>
<td>Scrolls up a page</td>
</tr>
<tr>
<td>Ctrl + Mousewheel <b>(removed)</b></td>
<td>Attempt to Decrease/Increase fontsize (*)</td>
</tr>
<tr>
<td>Numpad '/' (÷) or '*'</td>
<td>Attempt to Decrease/Increase fontsize (*)</td>
</tr>
<tr>
<td>'&lt;' or '&gt;'</td>
<td>Attempt to Decrease/Increase fontsize (*)</td>
</tr>
<tr>
<td>'Ctrl + PageDown/PageUp</td>
<td>Attempt to Decrease/Increase fontsize (*)</td>
</tr>
<tr>
<td>Shift + Ctrl + 'N'</td>
<td>Enable/disable Preview print page</td>
</tr>
<tr>
<td>Shift + Ctrl + 'P'</td>
<td>Print html page</td>
</tr>
<tr>
<td>Shift + Ctrl + 'R'</td>
<td>Enable/disable CSS coding</td>
</tr>
<tr>
<td>Shift + Ctrl + 'S'</td>
<td>Enable/disable STYLE tags</td>
</tr>
<tr>
<td>Shift + Ctrl + 'U'</td>
<td>Display remote graphics</td>
</tr>
<tr>
<td>Shift + Ctrl + 'Y'</td>
<td>Clear remote graphics cache</td>
</tr>
</tbody>
</table>
(*) For different keyboards
(+) See Mousewheel scrolling amounts in Bearhtml.ini
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="intro" class=""></a>
<h3>Introduction.</h3>
Bearhtml is an Html page renderer (displayer), <b>it is not a
browser</b>. Bearhtml supports Html 3.2 and parts of Html 4.1/XHTML.
CSS (Style definitions) is supported at level 1 and partly at level 2.
Failure to display a page may be for one of two main
reasons:
<ol>
<li>Badly coded Html or unsupported Html/CSS</li>
<li>Dynamic coding (scripting)</li>
</ol>
In either case you can attempt to view the page by right clicking
and selecting "Show in Browser"
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="graphics" class=""></a>
<h3>Graphics</h3>
Remote URL location graphics files are displayed as gray boxes; To see remote
graphics, key in Shift + Ctrl + 'U', or right click in the message
area (not on a graphic area) and select "Show picture", or ensure
that Message Reader option is set to choose fetching automatically.
There will be a delay while graphics are fetched. If a timeout occurs while downloading graphics,
you will see a warning on the Pegasus Mail status line, and further downloading
for the current message will stop. Increasing the MaxFetchtime= amount will allow some timeouts to be overcome.
While remote graphics are being downloaded, a counter can be seen to show
progress. Do not close the message until this counter completes the countdown.
In the case of corrupt or truncated graphics files a small box with
an exclamation point inside it will be displayed to indicate the
presence of an undisplayable graphic. Unavailable graphics files
will stay as a gray box
Images can be captured by right-clicking on the image. A Save file dialog will appear.
Images used to track access to a remote site, typically given a set of image dimensions to make
the image almost invisible can be problematic. A file BearTracking.txt can be used to deny
downloads from a host listed in Beartracking.txt.
<a href="file:///C:/PMAIL/Programs/href=http://community.pmail.com/forums/EditPost.aspx?PostID=51382&amp;ReturnUrl=%2fforums%2fShowThread.aspx%3fPostID%3d51382%2351382#top"></a>
<a name="timeout" class=""></a>
<h3>Timeout</h3>
Can occur if the time to download a remote graphic exceeds the value set in Bearhtml.ini
on the MaxfetchTime= line. Attempting to fetch all further remote graphics is stopped
and these graphics will be replaced by a gray box. To retry, key in Shift + Ctrl + U.
<a href="file:///C:/PMAIL/Programs/href=http://community.pmail.com/forums/EditPost.aspx?PostID=51382&amp;ReturnUrl=%2fforums%2fShowThread.aspx%3fPostID%3d51382%2351382#top"></a>
<a name="css" class=""></a>
<h3>CSS</h3>
CSS style tags are a method of enhancing HTML based content.
Unlike Html, CSS is ever-improving and adding new features. Bearhtml has full
support for CSS V1, and limited support for CSS V2. There is no support for CSS V3 onwards.
<i> toggle keystroke sequence (Shift + Ctrl + "R") to enable or disable CSS then re-open the message.
</i> Status line shows current state after a toggle.
Alternatively use the "Open in Browser" right click menu to invoke a full browser.
Note that Style tags commonly contain CSS content, so if WantCSS= Bearhtml.ini is set to
WantCSS=No, this will also signal that Style content is to be ignored.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="invalid" class=""></a>
<h3>Invalid Html</h3>
If Bearhtml is unable to display the html message this causes
LibTidy to be invoked to attempt a repair. An attempt is then made
to display the repaired message. If this fails the original source
html is shown in the display area. Failure at this point indicates
a seriously flawed html message. If the display is blank or badly
formatted, right click and select "Open in web browser".
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="charsets" class=""></a>
<h3>Character sets</h3>
Html is displayed using the users normal character set (eg
ISO-8859-1). If you see blank white squares where text should
appear, this is a sign that the sender is using a different
character set. Repeat the troubleshooting method above, but when in
your browser go to View/Character Encoding and select one of the
methods shown in the list. If one of these makes the message
readable, you should inform the sender of the character set
problem, and have them identify the character set they use in the
message headers.
Unicode character set is supported in both Big and Little Endian forms,
and is converted to Utf-8 to be displayed in Pegasus Mail.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="idna" class=""></a>
<h3>IDN</h3>
Url link targets that are encoded to the IDN protocol to allow display of accented
characters, will be displayed with the accented characters properly formatted, on
the Status line, and in the Link bubble comment.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="suspicious" class=""></a>
<h3>Suspicious Html</h3>
Urls that are clicked are checked for possibility of being
dangerous, ie Fraudulent asking for personal information
Specifically:
<ul>
<li>Check for numeric IP address ie http://191.168.0.1</li>
<li>Check for dual domain link address, ie
http://www.goodsite.com@www.badsite.com</li>
<li>Check for misleading links, ie underlined link Url is different
from target Url</li>
<li>Check for obscured Url domain names ie
http://%37icrosoft.com</li>
<li>Check Url with contents of Bearwarn.txt file (Phishing
tests)</li>
<li>Check if target Url domain in blacklist service
www.Surbl.org</li>
</ul>
If a problem is detected a dialog will prompt you. Clicking OK will
invoke the browser. Clicking Cancel, the Url will be remembered for
the rest of the Pegasus Mail session. Moving the mouse cursor over
the Url again will cause the mouse cursor to turn into a stop
sign.
For BlackList checking: WantBl=Yes/No in BearHtml.ini. Click on the
Url link. The status line will show result.
If you want more detail check Bearhtml.log for the Blacklist
message. It will show an IP address last number "n" (127.0.0.n) that
resolves according to which SURBL.ORG combination of lists it
occurs in. See <a href="http://www.surbl.org/lists">SURBl</a> for its
current list.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="phishing" class=""></a>
<h3>Phishing detection</h3>
In addition to blacklist validation, Bearhtml will also examine the
clickable link in the display. If well known and reputable
businesses domain names occur anywhere other than in the correct
part of a Url, a warning dialog will be displayed. Users can
maintain the list in Bearwarn.txt with their own domains. See
Bearwarn.txt for more info. You are <b>STRONGLY</b> recommended to
add the domain info (do not add the "www" portion of the Url address)
for your local bank(s) and credit card companies
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="scripting" class=""></a>
<h3>Scripting</h3>
No form of scripting is supported, ie Javascript. Any such coding
in a message is ignored. This makes the display of such messages
problematic. If needed this html should be passed to a full browser
.
In addition all requests for setting or retrieving Cookies are
ignored.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="ftp" class=""></a>
<h3>FTP URL links</h3>
Bearhtml does not support Url links that attempt to establish an FTP session in
order to transfer files. You will see a status comment "Protocol refused: File://"
and a dialog will appear saying that FTP Url has been copied to
your clipboard. If you want to handle the FTP Url, open your browser and
paste in the Url in your clipboard. Then you can click on the FTP
download request in your browser and it will either Save or Open the file.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="printing" class=""></a>
<h3>Printing</h3>
Users can request Header and Footer information be added to the
print pages. See PrtFlags= line in Bearhtml.ini. The font used to
produce the page header and footer is defined through the
DefaultFontName= and DefaultFontSize= coded in Bearhtml.ini. The
current Body text size (adjustable) will be used when printing the
body.
Messages with large recipient lists may cause header truncation ( 7 cms reserved).
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="preview" class=""></a>
<h3>Print Preview</h3>
Users can enable previewing of print by adding a line to Bearhtml.ini that requests it,
ie: preview=yes. Alternatively while viewing a message, key in Shift + Ctrl + N to toggle preview on/off.
Current status will show on Pegasus Mail status line. Once in Print Preview mode,
click Print button to print content.
Clicking on Next/Prev buttons scrolls pages.
Zooming in/out on text can be achieved by clicking on the magnifying glass.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="styles" class=""></a>
<i><h3>Styles</h3></i>
Remote URL location styles are not fetched.
With the introduction of CSS V3, the whole operation of STYLE tags has changed to more closely match the way that CLASS tag in CSS works.
Processing Style tags can be enabled, or disabled by using the WantStyle= in Bearhtml.ini (default is WantStyle=false ) or key'ing in
Shift + Ctrl + "S" to
flip between enabled or disabled state, then re-open the message. The default is to run disabled.
The Pegasus Mail status line will briefly show the newly set state.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="fontsizing" class=""></a>
<h3>Fonts sizing/color</h3>
Increasing or decreasing the default fontsize using the Ctrl +
mousewheel may not work in all cases, and may cause strange
formatting in some cases. If a message already has coded font
sizes, these will override any default size. Secondly any message
with parts coded with a font size, and other parts left to the
default size may appear poorly formatted. Note there are multiple
keyboard methods to adjust font size in the list above.
Similarily by using DefaultFontColor= you can opt to display the
message text in any Windows defined color. Examples are:
<font color="black">Black</font> <font color="blue">Blue</font>
<font color="teal">Teal</font> <font color="aqua">Aqua</font>
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="logging" class=""></a>
<h3>Logging</h3>
For problem investigation a log file can be created in the Pegasus
Mail NewMail directory (eg c:\pmail\mail), it is a text file with
name of Bearhtml.log, that can be reviewed using Notepad etc.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="scrolling" class=""></a>
<h3>Scrolling</h3>
There are two forms of scrolling up or down a webpage. Scrollbars
on the edge of the display and keyboard characters. In the case of
scrollbars, this always uses the Windows standard feature of moving
by an amount of pixels in either direction, regardless of where the
text cursor is located.
Using the keyboard performs text sensitive scrolling movements to
move by an amount of "lines" and relocate the text cursor. In this
case the distance scrolled can be an amount easily explained, or in
the case of mixed text and graphics the distance scrolled can be
quite difficult to explain. Bearhtml will for instance scroll
up/down by a page height of pixels and try to find the new line of
text completely in view to place the cursor.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="redirection" class=""></a>
<h3>Redirection</h3>
Http protocol allows that a Url request be modified by the web
server to fetch an object (page or image) from another location.
Bearhtml can support this feature but by default is disabled. Care
must be taken in choosing to enable redirection. It is beyond the
scope of this file to describe the risks. See Google searches such
as:
http://computing-dictionary.thefreedictionary.com/Http+redirection
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="Fetching" class=""></a>
<h3>Remote image fetching</h3>
For most of the time the default process to download graphics is called ReadWebData,
but an alternative can be selected when ReadWebData breaks. It is called GetUrl.
The keyword RemoteFetch= can be coded as either RemoteFetch=1 (default) or
Remotefetch=2 to select GetUrl. This is an advanced setting that should not be used unless
other avenues have been explored. The most likely reasom would be a problem with SSL certificates.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="cache" class=""></a>
<h3>Cache'ing</h3>
If enabled (by WantCache=yes), a copy of downloaded graphic files
is kept and subsequent requests for the same graphic are supplied
from cache. Cache can be cleared at any time by keying in Ctrl +
Shift + Y. Cache-days= influences how long files are kept in the
cache.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="proxy" class=""></a>
<h3>Proxy Servers</h3>
For some installations, workstations are not allowed to connect to
the Internet directly. They are instead required to connect to a
local proxy server. The proxyserver= value allows this server to be
identified and port number to be used. Users of Microsoft's
Internet Explorer may have this proxy server already configured.
See IE menu Tools/Internet Options/Connections/LAN settings. The
same information may be found in Firefox menu
Tools/Options/General/Connection Settings. Bearhtml at presnt only
checks the Windows Registry for I.E configuration values.
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="installation" class=""></a>
<h3>Installation</h3>
<ol>
<li>Shut-down Pegasus Mail</li>
<li>Unzip the content of the new bearhtml.zip into the Pegasus Mail
executables directory (eg: c:\pmail).</li>
<li>If required, edit Bearhtml.ini and Bearwarn.txt</li>
<li>If required, save Bearhtml.ini into the user NewMail directory
to override the default location values</li>
<li>Restart Pegasus Mail</li>
</ol>
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="uninstall" class=""></a>
<h3>Un-Install</h3>
<ol>
<li>Shut-down Pegasus Mail</li>
<li>Rename or delete Bearhtml.dll</li>
<li>Restart Pegasus Mail</li>
</ol>
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="bearini" class=""></a>
<h3>Contents of Bearhtml.ini</h3>
<ul>
<li>ScrollPixels= (default 20) pixel height to move for
mousewheel</li>
<li>ScrollRepeat= (default 1) repeat scroll for mousewheel</li>
<li>ScrollDelayMs= (default 1mSec) delay between scrolls for
mousewheel</li>
<li>DefaultFontSize= (default 12) Display font size</li>
<li>DefaultFontName= (default Arial) Font to use</li>
<li>DefaultFontColor= (default Black) Text color to use, if not
pre-defined</li>
<li>WantBl= (default No, Yes/No) Blacklist checking</li>
<li>WantCache= (default Yes, Yes/No) Save graphics in Newmail
sub-directory RmtFiles. Files with extension type .Rmt and .Cac are
created</li>
<li>cache-days= (default 1) If WantCache=yes then operate a elapsed
time cache, keeping remote graphics cache'd beyond a Pegasus Mail
session. Cache-days=0 keeps remote graphics for remainder of the
current day only.</li>
<li>LocalIPAddress= (no default, use to avoid local non-routable
numeric addresses such as 127.0.0.1 causing Phishing warnings,
multiple addresses separated by commas.
ie&nbsp;localIPAddress=127.0.0,192.168 would exclude 127.0.0.n and
192.168.n.n.</li>
<li>Redirection= ( default No) Http Url redirect to alternative
location (risk)</li>
<li>proxyserver= (no default, code per example:
http://127.0.0.1:8080)</li>
<li>Skype= (full pathname to Skype executable). Used for Callto:
and Skype: protocols</li>
<li>PrinterSetup= (default Yes) Allow printer selection for html
printing</li>
<li>Prtflags= (default 3) 1 = Headers, 2 = Footer, 3 = Both</li>
<li>Preview= (default = Yes) display in Print preview mode</li>
<li>Shortinfo= (default Yes) show only domain name in Hint window
Url.</li>
<li>WarnExtensions= (default .EXE.SCR.PIF) detect risky file
extension types on Urls</li>
<strike><li>UnloadWinInet= (default=No) Only use to force unloading of WinInet.dll&gt;</li></strike>
<strike><li>WantUrlRequest= (default = yes) Urls with "?" character</li></strike>
<li>WantCSS= (default = no) process CSS</li>
<li>RemoteFetch= (default = 1) Select procedure to fetch remote graphics (troubleshooting)</li>
<li>FixGoogle= (default = No) Temporary fix for Google Alerts image downloading problem</li>
<li>FixAmazon= (default = yes) Correct wrongly coded font sizing</li>
<li>MaxFetchTime= (default 15 seconds )</li>
<li>Loglevel= (default 3) Uses same reporting levels as Pegasus
Mail, ie
<table border="1">
<tbody><tr>
<td>Loglevel=1 Reports critical Bearhtml function errors</td>
</tr>
<tr>
<td>Loglevel=2 Reports Loglevel=1 and serious errors</td>
</tr>
<tr>
<td>Loglevel=3 Reports Loglevel=1-2 and normal events</td>
</tr>
<tr>
<td>Loglevel=4 Reports Loglevel 1-3 and detailed transaction
information</td>
</tr>
<tr>
<td>Loglevel=5-8 Reports Loglevel 1-8 (all levels) and Tidy html warnings and
errors</td>
</tr>
</tbody></table>
</li>
</ul>
<a href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a> <a name="copyrites" class=""></a>
<h3>Copyrights</h3>
<ul>
<li>Pegasus Mail: David Harris (<a href="http://www.pmail.com/">http://www.pmail.com</a>)</li>
<li>Tidy: LibTidy-Project <a href="http://tidy.sourceforge.net/">http://tidy.sourceforge.net</a> and
<a href="http://www.w3c.org/">http://www.w3c.org</a></li>
<li>BearHtml: Martin Ireland (<a href="mailto:irelam@telus.net">mailto:irelam@telus.net</a>)</li>
<li>ReadWebData: Michael in der Wiesche</li>
</ul>
<p><a style="font-size: 10pt;" href="file:///C:/PMAIL/Programs/bearhlp-en.htm#top">Top</a><span style="font-size: 10pt;">&nbsp;</span></p>