Browser Testing

This file tests Natural Docs’ generated output.  Particularly useful when testing various browsers.

Browsers

The specific browser versions tested are below.  Everything is tested on Windows Vista unless otherwise noted.

Firefox 2.0.0.102.0 released October 2006.
Firefox 1.5.0.81.5 released Novemer 2005.
Firefox 1.0.81.0 released November 2004.  Not critical to support.
IE 7.07.0 released October 2006.
IE 6.06.0 released August 2001.  Tested on Windows XP SP2 via Virtual PC.
Safari 3.0.43.0 released June 2007.  Tested Windows version.
Safari 2.0.42.0 released April 2005.  Tested on Mac OS X 10.4 Tiger.
Opera 9.029.0 released June 2006.
Opera 8.548.5 released September 2005.
Opera 8.028.0 released April 2005.
Opera 7.517.5 released around August 2004 I think.  Not critical to support.
Opera 7.027.0 released January 2003.  Not critical to support.
Konqueror 3.5.5Tested on openSUSE 10.2 via VMware Player.

Search

Unframed HTML Search

Tests

  • Make sure the search box appears and disappears correctly on hover.
  • Type to bring up results.  Type further to narrow them.  Narrow until there’s no results.
  • Backspace to bring the results back.  Backspacing to empty closes the results.
  • Type to bring up results with a different first letter.  (Tests iframe content switch.)
  • Type Z to bring up empty page when there’s nothing with that first letter.  (Tests generic no results page.)
  • Type Name in Everything search to test expanding and collapsing, especially between two that differ only by case.
  • Change filter to Functions to test changing filter while results are open.  Change to Types to switch to one with no results.
  • Test Close button on results.  Should deactivate panel as well.
  • Clicking away should deactivate panel if the box is empty, not have an effect if there are results open.
  • Text should always change back to “Search” when deactivating.

Results

Firefox 2.0OK
Firefox 1.5OK
Firefox 1.0OK
IE 7.0OK
IE 6.0Functionally OK.  Search panel doesn’t activate on hover.  Works fine when clicked.
Safari 3.0OK
Safari 2.0Broken.  Results panel doesn’t show up.  Border around deactivated search box.
Opera 9.0OK
Opera 8.5OK
Opera 8.0OK
Opera 7.5Functionally OK.  Search panel has sunken border when deactivated, minor pixel shifting.
Opera 7.0Broken.  Completely.
Konqueror 3.5Broken.  Results panel doesn’t show up.  Seems to fail on “resultsFrame = window.frames.MSearchResults;”

Framed HTML Search

Tests

  • Make sure the search box appears and disappears correctly on hover.
  • Type to bring up results on right.  Type further to narrow them.  Narrow until there’s no results.
  • Backspace to bring the results back.
  • Type to bring up results with a different first letter.  (Tests frame content switch.)
  • Type Z to bring up empty page when there’s nothing with that first letter.  (Tests generic no results page.)
  • Type Name in Everything search to see that there’s no collapsing in this mode.
  • Change filter to Functions to test changing filter while results are open.  Change to Types to switch to one with no results.
  • Clicking away should deactivate panel.
  • Clicking a result should deactivate panel and show up in correct frame.
  • Text should always change back to “Search” when deactivating.

Results

Firefox 2.0OK
Firefox 1.5OK
Firefox 1.0OK
IE 7.0OK
IE 6.0Functionally OK.  Search panel doesn’t activate on hover, is a little wide.  Works fine when clicked.
Safari 3.0OK
Safari 2.0Functionally OK.  Has a sunken border around the deactivated seach field.
Opera 9.0OK
Opera 8.5OK
Opera 8.0OK
Opera 7.5Functionally OK.  Search panel has sunken border when deactivated, minor pixel shifting.
Opera 7.0Broken.
Konqueror 3.5Functionally OK.  Panel doesn’t reset and deactivate when clicking a result link.

Other

Images

Tests

  • Here is an embedded image on its own line.
  • Here is a reference in the middle of a sentence, in the middle of a bullet list: (see logo) It should have been converted to a link with the image appearing below the bullet list and the file name used as a caption.  Make sure the caption positions correctly.
  • Here’s a link to a non-existent image, which should appear literally: (see images/doesntexist.jpg)
  • Here is an embedded image that doesn’t exist on it’s own line.
logo

(see images/doesntexist.png)

  • Here is a link using the “(see)” syntax which shouldn’t be interpreted as an image link because it doesn’t end with an acceptable extension.  Also, links should still resolve because of that.  (see Framed HTML Search)

Results

Firefox 2.0OK
Firefox 1.5OK
Firefox 1.0OK
IE 7.0OK
IE 6.0OK
Safari 3.0OK
Safari 2.0OK
Opera 9.0OK
Opera 8.5OK
Opera 8.0OK
Opera 7.5OK
Opera 7.0OK
Konqueror 3.5OK

Prototypes and Tooltips

Hover over NaturalDocs::Parser::JavaDoc->ParseComment() and NaturalDocs::Parser::JavaDoc->IsMine()

Tests

  • A tooltip should appear about a second after you hover over the link above.
  • It should go away when you move the cursor away.
  • It shoud be positioned directly underneath with a slight gap.
  • The prototype should be formatted cleanly with each parameter on its own line and aligned in columns.
  • The asterisk should be in a separate column.
  • Test it with the link too close to the edge of the window so the pop-up has to shift left to fit.

Results

Firefox 2.0OK
Firefox 1.5OK
Firefox 1.0OK
IE 7.0OK
IE 6.0OK
Safari 3.0OK
Safari 2.0OK
Opera 9.0OK.  Has its own tooltips turned on by default which can cover it up though.
Opera 8.5OK.  Has its own tooltips turned on by default which can cover it up though.
Opera 8.0OK.  Has its own tooltips turned on by default which can cover it up though.
Opera 7.5OK.  Has its own tooltips turned on by default which can cover it up though.
Opera 7.0Broken.  Usually works, if the window is too narrow may collapse completely.
Konqueror 3.5OK

Long code block scrolling

Go to Prototype Parameter Styles.

Tests

  • Shrink the browser window so that a line extends past the end of it.  Only the line should have a scrollbar, not the entire page.
  • Expand the browser window.  The scrollbar should disappear.

Results

Firefox 2.0OK
Firefox 1.5OK
Firefox 1.0OK
IE 7.0OK
IE 6.0OK
Safari 3.0OK
Safari 2.0OK
Opera 9.0OK
Opera 8.5OK
Opera 8.0OK
Opera 7.5OK
Opera 7.0OK
Konqueror 3.5OK

Menu and Class Hierarchies

Go to NaturalDocs::Languages::Simple.

Tests

  • Class hierarchy should look okay.
  • Make sure the menu hierarchy opens up on its own when the page is loaded.
  • You should be able to click on groups to open and close them.

Results

Firefox 2.0OK
Firefox 1.5OK
Firefox 1.0OK
IE 7.0OK
IE 6.0OK
Safari 3.0OK
Safari 2.0OK
Opera 9.0OK
Opera 8.5OK
Opera 8.0OK
Opera 7.5OK
Opera 7.0OK
Konqueror 3.5OK
sub ParseComment #(string[] commentLines,
bool isJavaDoc,
int lineNumber,
ParsedTopics[] *parsedTopics)
Parses the JavaDoc-syntax comment and adds it to the parsed topic list.
sub IsMine #(string[] commentLines,
bool isJavaDoc)
Examines the comment and returns whether it is definitely JavaDoc content, i.e.
A class containing the characteristics of a particular programming language for basic support within Natural Docs.
Close