KIS001302 - Compiling context-sensitive help fails with latest version of Perl
Warning: This is not an approved Knowledge Base entry. Please treat it with caution.
This known issue was originally created by Rathodavinash and has been verified by Nokia Developer.
Article Metadata
Code Example
Source file: Media:Perlchanged.zip
Tested with
Devices(s): N/A
Compatibility
Platform(s): S60 3rd Edition and later
Article
Article ID: KIS001302
Keywords: N/A
Created: rathodavinash
(29 Jun 2007)
Last edited: hamishwillee
(03 Feb 2012)
Description
If you have a newer version of ActivePerl, you may face problems when compiling help files for your Symbian OS application.
There are two options:
- Switch to an older version of ActivePerl (the officially supported version is v5.6.1 build 635, which can be downloaded here) or
- Change the files param.pm and args.pm
These two files can be found in your SDK installation's Epoc32\tools\perllib path. In the file args.pm, change the following line (# 688)
$self->_iSpecArray->{$aName}= New CArgsSpec($aName, $aDefault, $aPattern,
$aExclusions, $aMandatory, $aRepeatable);
to
$self->_iSpecArray->{$aName}= CArgsSpec->New($aName, $aDefault, $aPattern,
$aExclusions, $aMandatory, $aRepeatable);
In the file params.pm, search for the word "New" and replace it with "foo->New()"; for example, if there is a function "New CLogs()", change it to "CLog->New()".
Take backups of the original files.
Alternatively, you can download File:Perlchanged.zip
22 Sep
2009
This article highlights the issue of context-sensitive help file creation failure, when using a newer version of perl. This article provides a good solution to overcome this issue.
Editing params.pm is only partial solution
Compiling will succeed, but special characters like ' (singlequote) or diacritics will be destroyed. This can be checked in intermediate cshlp.xml, where singlequote should appear as entity &# 8216 (on perl 5.6), but on newer perl cshlpcmp will insert the actual character. This is of particular concern for languages other than English Agent_L 13:07, 13 August 2010 (UTC)