FAQ - Pascal Browser

1. What is Pascal Browser and how can it make my developer life easier?
2. I'm a registered user, where can I find updated versions of the full program?
3. Which compiler versions are supported by Pascal Browser?
4. How can I make my Chinese comments show up correctly in the HTML pages?

1. What is Pascal Browser and how can it make my developer life easier?
Pascal Browser is a powerful and efficient source code documentation tool.

Just as its sibling product Pascal Analyzer, Pascal Browser will parse the source code it finds and gather all sorts of information. This information is used to create the document collection that describes the source code. The most common use of Pascal Browser will probably be to create hyperlinked HTML documents.

2. I'm a registered user, where can I find updated versions of the full program?
Read the mail you got when you ordered Pascal Browser. The same instructions apply for updates. If you cannot find this mail, let us know, and we will help you as soon as we can.

3. Which versions are supported by Pascal Browser?
Pascal Browser directly supports code written for the following compilers:

Borland Pascal 7 (or earlier)
Delphi 1
Delphi 2
Delphi 3
Delphi 4
Delphi 5
Delphi 6
Delphi 7
Delphi 8 .NET
Delphi 2005 Win32
Delphi 2005 .NET
Delphi 2006 Win32 (also Turbo Delphi for Win32)
Delphi 2006 .NET (also Turbo Delphi for .NET)
Delphi 2007 Win32
Delphi 2007 .NET

By setting appropriate compiler directives and conditional defines, PAL should also handle code written for Kylix (Delphi for Linux).

4. How can I make my Chinese comments show up correctly in the HTML pages when using charset "Big5"?

When Unicode comments are used in the source code, the default templates will not generate the correct output. The output in source code listings will display Unicode characters, but not in the other parts of the document that show comments.

The comments are written by PAB to the intermediate XML file, and the charset used is "iso-8859-1", and the XSLT transformation inserts a <META> tag in the resulting HTML pages that specifies "charset=iso-8859-1". The solution is to add an additional <META> tag that specifies for example the charset "Big5" (a charset for Chinese characters) in the templates, like this for Module.xsl:

<?xml version="1.0" encoding="iso-8859-1"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" >
<xsl:variable name="template">{#Template}</xsl:variable>

<xsl:include href="FooterInc.xsl"/>
<xsl:include href="HeaderInc.xsl"/>
<xsl:include href="ToolsInc.xsl"/>
<xsl:include href="TodoInc.xsl"/>
<xsl:include href="ImageInc.xsl"/>

<xsl:output method="html" version="1.0" encoding="iso-8859-1" indent="yes"/>

<xsl:template match="/">
<xsl:variable name="Me" select="//Items/Item[@id='{#selfID}']"/>
<xsl:variable name="ItemsInMe" select="//Items/Item[@modid='{#selfID}']"/>
<HTML>
<META http-equiv="Content-Type" content="text/html; charset=Big5"/>
<xsl:call-template name="header"/>
<BODY>
...

This <META> tag will take precedence, so the resulting output is displayed with the "Big5" charset.