Installing The Registered Version of TRichView
(Frequently Asked Questions)

Q: I recently ordered the full version of TRichview. I received the reg key, and I have included this info into the registry. However I am still seeing the "Unregistered" message when I run my programs. How do I fix this problem?

A: Trial version of TRichView always shows this message. You need to install the full source code version (see the links in the registration e-mail)

Q: I installed the full source code version, but this message still appears.

A: This means that Delphi continues using old trial version when compiling programs (even though full source code is installed), because its location is still specified in the Delphi�s library paths. Find the files of the old trial version (*.dcu) and delete them from your hard drive.

Q: I have an installation problem. Delphi compiler shows the error message:
[Fatal Error] RVPkgD5.dpk(74): Unit RVFuncs was compiled with a different version of RVStyle.TRVScreenAndDevice
(names of package, unit and class in the error message may vary)

A: You have several versions of RichView installations on your hard drive. They conflict to each other. Delete all of them except from the latest one.

Q: I have a problem installing RichViewActions (or RichView) in C++Builder. It shows error messages:
[Linker Error] Unresolved external '__fastcall Outline::TCustomOutline::~TCustomOutline()' referenced from E:\PROGRAM FILES\BORLAND\CBUILDER6\LIB\BCBSMP.LIB|.\cdiroutl.cpp
[Linker Error] Unresolved external '__fastcall Outline::TCustomOutline::TCustomOutline(Classes::TComponent *)' referenced from E:\PROGRAM FILES\BORLAND\CBUILDER6\LIB\BCBSMP.LIB|.\cdiroutl.cpp
...

A: Such errors occur when compiling packages that were saved after the previous compilation. Solution: (1) restore the package files (*.bpk) from the installation (2) never save packages after their compilation in C++Builder (C++Builder adds redundant references in the saved package; these references may prevent compilation)

Extended Guide

Almost all the information below can be found in install.txt/readme.txt for TRichView and its addons. An extended step-by-step instruction can be useful nevertheless.

1) ABOUT SOURCE FILES (PAS, DPK, DCU, ... ETC.)

The simplest way for updating - installing updates of the components in the same directory as their previous versions. In this case you do not need to delete files of the old version of the components because files of the new one override them.

But if you, for example, previously installed TRichView 11 in one directory, and newly installed TRichView 12 in another directory, this may lead to problems. In this case, delete all files of old version (delete the directory with *.pas and *.dcu files in Windows Explorer or other file manager). Or better, copy files of the newer version to the location of the old version (override it), and delete a new directory.

The same is for RichView addons: RvHtmlImporter, RvXML, RichViewActions, ScaleRichView. Each of them must be installed in their own directory, but make sure that there are no different versions of the same component in different directories! The same applies to any third-party components that you use, not only to TRichView and its addons.

Note: the word "install" above means extracting/copying files of components to the specific directory, not installing components in Delphi.

2) ABOUT THE FIRST INSTALLATION OF THE COMPONENTS

The instructions below are for Delphi XE. Installing in different versions of Delphi and C++Builder is made in a similar way.

2.a) Installing TRichView

• Install RVPkgDXE.dproj: open RVPkgDXE.dproj (File | Open). Right click on the package name in the Project Manager, choose "Install" command in the context menu. (for older versions of Delphi: click "Install" button in the package window)
• Install RVDBPkgDXE.dproj: do the same with RVDBPkgDXE.dproj
• Add the TRichView directory in the Delphi library path: menu "Tools | Options", page "Environment Options | Delphi Options | Library", click "..." button near the "Library path" edit-box. In the "Directories" dialog, add the directory to TRichView files (PAS, DPK, etc) in the list. Close all these dialog clicking "OK" buttons.

2.b) Installing RvHtmlImporter

This procedure must be performed after performing all the steps of (2.a)

• Install RvHtmlDXE.dproj
• Add the RvHtmlImporter directory in the Delphi library path

2.c) Installing RichViewXML

This procedure must be performed after performing all the steps of (2.a)

• Install RVXMLDXE.dproj
• Add the RichViewXML directory in the Delphi library path

2.d) Installing RvHtmlViewImporter

This procedure must be performed after performing all the steps of (2.a)

• Read "readme.txt" from RvHtmlViewImporter's zip. Make changes in THTMLViewer according to this file and [re]install it.
• Install RvHtmlViewImportDXE.dproj
• Add the RvHtmlViewImporter directory in the Delphi library path

2.e) Installing wrapper for Addict 3 or 4

This procedure must be performed after performing all the steps of (2.a)

• Read "readme.txt" from adrv3.zip. Make changes in Addict3/4 packages according to this file and [re]install it. Make sure that you do not have duplicate bpl/dcp files in different directories.
• Install Addict4_RichView_dxe.dproj
• Add the wrapper's directory in the Delphi library path

2.f) Installing RichViewActions

This procedure must be performed after performing all the steps of (2.a). If you want to allow RichViewActions working with RvHtmlImporter, RichViewXML, RvHtmlViewImporter, Addict3/4, the steps of (2.b)...(2.e) must be performed first.

• Make changes in RichViewActions.inc to allow support of additional components. See RichViewActions' install.txt for details.
• Install RichViewActionsDXE.dproj
• Add the RichViewActions directory in the Delphi library path

2.g) Installing ScaleRichView

This procedure must be performed after performing all the steps of (2.f).

• Install SRVPkgDXE.dproj
• Install DBSRVPkgDXE.dproj
• Add the ScaleRichView directory in the Delphi library path

2.g) Installing SRVControls

This procedure must be performed after performing all the steps of (2.g)

• Install SRVControls.dproj
• Add the SRVControls directory in the Delphi library path

3) ABOUT UPDATES

So, you downloaded and extracted files of new version of TRichView, and may be, of some of its addons.

You followed the rules of (1) and (2).

Now you need to install updates in the Delphi environment.

Updates must be installed in the same order as in (2).

Updating is simpler than the first time installing because all paths to the source files are already in the Delphi library paths list. Of course, if you extracted files of new versions of the components in the same directories as their old versions. Otherwise you need to update Delphi library paths

After compiling some packages, you may get a sequence of error messages by Delphi: "XXX could not be located in the dynamic link library YYY.dpk". Click "OK" in such messages. "Can't load package ZZZ. AAA cannot be found. Do you want to attempt to load this package the next time a project is loaded? [Yes/No]". Click "No" (or "Yes", it does not matter). These annoying messages will continue appearing from time to time until you recompile all the packages. These messages appear not for all updates of TRichView, only if there were some important changes in the interface part of TRichView units.

That's all.