THIS DEVELOPER MANUAL contains information for those who wish to modify the FreeVeracity source code. This manual is somewhat patchy, so if you look for some information and it's not there, please email the webmaster.

The SEARCH facility in the margin provides a quick way to find what you need quickly. If you are not already familiar with FreeVeracity, you may wish to refer to the FreeVeracity Tutorial Manual which provides a structured introduction to FreeVeracity, along with lots of examples and application-specific information.

Disclaimer of liability: Rocksoft makes no express or implied representations or warranties in relation to this Software. To the full extent permitted by law, unless a specific contract is negotiated between Rocksoft and the user of this Software, Rocksoft will not be liable to the user under any law for any loss or damage (including but not limited to direct, indirect, economic and consequential loss or damage) in respect of any matter whatsoever related to the use of this Software, including without limitation, loss or damage caused by the negligent acts or omissions of Rocksoft or lost profits and damage suffered as a result of claims by any third person. Further, Rocksoft does not accept any responsibility or liability for any computer virus infection arising from the Software, or any loss or damage caused by the hardware or other software that is used in conjunction with the Software.

Warning: FreeVeracity is not licensed or available on commercial platforms. If you want to run FreeVeracity on a commercial platform, you should purchase a licence for the commercial Veracity data integrity product instead. FreeVeracity does, however, contain many commercial-platform-related features that allow it to use snapshots taken by Veracity on commercial platforms. This manual was generated from the Veracity Developer Manual and may contain sentences that imply that FreeVeracity is available for commercial platforms. These are incorrect. Please email the FreeVeracity Webmaster if you find one. Thank you.

Note: This product contains software developed by Rocksoft Limited (www.rocksoft.com).

1 Introduction

1.1 Introduction
1.2 Licensing

2 How To Build FreeVeracity

2.1 How To Obtain The FreeVeracity Source Code
2.2 How The Source Code Is Organized
2.3 Building FreeVeracity For Unix
2.4 Building FreeVeracity For MS-DOS And Windows
2.5 Building FreeVeracity For Macintosh
2.6 Building FreeVeracity For OpenVMS
2.7 Cleanup Script
2.8 FunnelWeb Build Script

3 Source Code Notes

3.1 Coding Design Goals
3.2 Language
3.3 Source Code Filenames
3.4 Identifier Lengths
3.5 Package Mnemonics
3.6 Pointer Identifiers And Type Identifiers
3.7 Function Identifiers
3.8 Package Abstractions
3.9 Magic Numbers
3.10 C Style And Language Extensions
3.11 The Rope Package
3.12 Error Strings, Ropes And Stacks
3.13 Documentation Conventions
3.14 Memory Management
3.15 Intellectual Property Summary

4 Common Changes

4.1 Porting To A New Platform
4.2 Adding A New File Attribute