Chapter 8 Documentation Road Map: Where to Find What You Need
This chapter contains the following sections:
- 8.1, Printed (Hardcopy) Documentation
- 8.2, Documentation Available in HTML Help Viewer Format
- 8.3, Documentation Available in HTML Format
- 8.4, Documentation Available in PDF Format
- 8.5, Documentation Available in WinHelp Format
- 8.6, Information About New Features
- 8.7, Where to Find Information About Particular Topics
Note:
For information about using the sample programs, see Section 7.1, Using the Sample Programs.
For information about reading the Release Notes, see Section 2.2, Release Notes.
8.1 Printed (Hardcopy) Documentation
The two manuals available in printed form are the following:
This is the manual you are now reading.
This manual is also available online, in PDF format. See Section 8.4.2, Location of Installing and Getting Started PDF File.
This manual describes the Compaq Fortran language for all Compaq Fortran platforms, including Visual Fortran.
It contains information on language syntax and semantics and on Fortran standards and extensions to the standards.
Compaq extensions to the Fortran 95 standard are identified by blue-green color in the manual.
The Compaq Fortran Language Reference Manual is provided in HTML form on the Visual Fortran CD-ROM in the following directory: \Info\Df\Doc\LRM. Open the file Dflrm.htm.
The Compaq Fortran Language Reference Manual is also available online, with slightly different information, in HTML Help Viewer format. See Section 8.2.2, Language Reference.
Note:
The Compaq Visual Fortran Installing and Getting Started and Compaq Fortran Language Reference Manual are also available in HTML form on the Visual Fortran home page. To view them:
- Open the Fortran home page at: http://www.compaq.com/fortran
- Click on Online Documentation in the left margin.
- Scroll down under Compaq Visual Fortran to find the manuals.
To order additional copies of the printed Compaq Visual Fortran Installing and Getting Started and Compaq Fortran Language Reference Manual included with each single-user kit, contact a local Compaq sales office or reseller and request Compaq part number QA-5LBAA-GZ.6.6.
8.1.1 Compaq Fortran Online Bookstore
You might want to purchase additional books about the Fortran language, Visual Fortran, or programming for the Windows platform that are not provided in your kit. Visual Fortran provides an online bookstore that lists suggested titles.
To bring up the Compaq Fortran Online Bookstore:
- Open the Fortran home page at: http://www.compaq.com/fortran
- Click on Bookstore in the left margin.
- Click on the Compaq Fortran Online Bookstore link at the bottom of the page.
8.2 Documentation Available in HTML Help Viewer Format
Note:
For information about how to bring up the HTML Help Viewer, see Section 7.6, Viewing Online Documentation in the HTML Help Viewer.
For details about the HTML Help Viewer, see Chapter 9, Using the HTML Help Viewer
Visual Fortran and related online documentation appears under the Compaq Visual Fortran title.
The primary online reference materials for Visual Fortran are:
- Programmer's Guide (in the Compaq Visual Fortran title). See Section 8.2.1, Programmer's Guide.
- Language Reference (in the Compaq Visual Fortran title). See Section 8.2.2, Language Reference.
- Error Messages (in the Compaq Visual Fortran title). See Section 8.2.3, Error Messages.
- Compaq Array Visualizer documentation for the Professional and Enterprise Editions (several books in the Compaq Array Visualizer title). See Section 8.2.5, Compaq Array Visualizer Documentation.
- Visual C++ User's Guide (for Visual Fortran) (in the Developer Studio 98 title). See Section 8.2.4, Visual C++ User's Guide (for Visual Fortran).
- Platform SDK and SDK manuals in the Platform SDK and SDK Documentation titles. See Section 8.2.6, Platform SDK and SDK Documentation.
- Additional titles for the Enterprise Edition. See Section 8.2.7, Additional HTML Help for the Enterprise Edition.
These documentation resources are available online after you install Visual Fortran.
The Programmer's Guide, Language Reference, and Error Messages manuals are also available as .HTM files that you can view using your favorite browser, not the HTML Help Viewer.
8.2.1 Programmer's Guide
The Programmer's Guide covers the following aspects of Visual Fortran programming on Windows 2000, Windows NT 4, Windows Me, Windows 98, and Windows 95 systems:
- How to build and debug efficient applications using the visual development environment or the command line, selecting appropriate compiler and linker options, using the debugger, and performance guidelines.
- Detailed information about Visual Fortran project types: Fortran Console application, Fortran Standard Graphics application, Fortran QuickWin application, Fortran Windows application, Fortran COM Server application, Fortran static library, and Fortran dynamic-link library.
- Aspects of programming with Visual Fortran on Windows 2000, Windows NT 4, Windows Me, Windows 98, and Windows 95 systems, including portability, using dialogs and graphics, mixed-language programming, and multithread applications.
- Using COM and Automation objects (client) and creating a COM server (including support for dual interfaces).
- Intrinsic data types, handling run-time errors and exceptions, and converting foreign unformatted files.
- How to use IMSL library routines (included in the Professional and Enterprise Editions of Visual Fortran).
- How to use CXML library routines.
- Source compatibility and using Visual Fortran tools.
Compaq extensions to the Fortran 95 standard are identified by a blue-green color.
8.2.2 Language Reference
The Language Reference describes the Compaq Visual Fortran programming language. It contains all of the material in the printed Compaq Fortran Language Reference Manual described in Section 8.1, Printed (Hardcopy) Documentation that is relevant to Visual Fortran. It also contains information not found in the printed manual about routines available only on Windows platforms.
Information found in the Language Reference includes:
Topics include program structure, constants and variables, various types of statements, execution control, data transfer and I/O, scope and association, compilation control and directives, and other topics.
Organizes the functions, subroutines, and statements available in Visual Fortran by the operations they perform. Also has descriptions of all Visual Fortran statements, intrinsics, and library routines (arranged in alphabetical order).
Contains abbreviated definitions of some commonly used terms in the Visual Fortran documentation.
Compaq extensions to the Fortran 95 standard are identified by a blue-green color.
8.2.3 Error Messages
Error Messages is a list of error messages with explanations, including Visual Fortran run-time messages, linker messages, and tools messages.
8.2.4 Visual C++ User's Guide (for Visual Fortran)
The Visual C++ User's Guide (for Visual Fortran) provides information on navigating the menus and windows of the visual development environment. It describes how to set up projects, how to work with the editor, debugger, and browser, and how to set linker options.
8.2.5 Compaq Array Visualizer Documentation
The Compaq Array Visualizer online documentation provides information about the Array Visualizer, including how to get started with the Array Visualizer, Fortran (fagl and fav) routines reference information, C (agl and CAViewer Class) routines reference information, and Avis2D and AvisGrid ActiveX controls information (including properties and methods reference).
8.2.6 Platform SDK and SDK Documentation
The Platform Software Development Kit (SDK) online documentation is included to give you reference information about library routines (such as OpenGL) provided by your operating system. This documentation is shown under the online titles Platform SDK and SDK Documentation.
8.2.7 Additional HTML Help for the Enterprise Edition
The Enterprise Toolkit part of the Enterprise Edition includes additional documentation in HTML Help form, including Compaq Tru64 UNIX operating system documentation and related product documentation.
With the Enterprise Edition, the additional HTML Help (such as the Compaq Tru64 UNIX documentation) is added to its own collection. During installation of the Enterprise Toolkit, you can select existing collections (such as MSDN or Visual Fortran) to be added to the Compaq Enterprise Toolkit collection. The Visual Fortran collection remains as a separate collection that you can select. See Section 9.11, Other HTML Help Viewer Features.
You can use the subset capabilities of HTML Help to limit the information displayed or searched with the Search tab or F1 key. For example, you can define and use a subset that only contains the Compaq Tru64 UNIX documentation. See Section 9.9, Changing the Current Collection.
8.3 Documentation Available in HTML Format
The documentation described in Section 8.2, Documentation Available in HTML Help Viewer Format, is also provided in HTML format, to be read using your favorite browser. The HTML files are located on the Visual Fortran CD-ROM at:
\Info\Df\Doc\CVF_HTMLThe HTML files for the Compaq Fortran Language Reference Manual described in Section 8.1, Printed (Hardcopy) Documentation is located on the Visual Fortran
CD-ROM at:\Info\Df\Doc\CVF_LRM8.4 Documentation Available in PDF Format
This documentation is provided in PDF format, to be read using the Adobe Acrobat Reader:
- Compaq Visual Fortran Installing and Getting Started. See Section 8.4.2, Location of Installing and Getting Started PDF File.
- Compaq Extended Math Library Reference Guide. See Section 8.4.3, Location of CXML PDF File.
- IMSL PDF files for the Professional and Enterprise Editions. See Section 8.4.4, Location of IMSL PDF Files.
- FLEXlm End Users Manual. See Section 8.4.5, Location of FLEXlm PDF File.
- Visual Fortran and Array Visualizer HTML Help documentation, provided in PDF form for those who cannot or prefer not to view the HTML files. The PDF files are on the Visual Fortran CD-ROM in the following directory:
\Info\Df\Doc\CVF_PDFThe following PDF documentation is provided in this directory:
- Programmer's Guide, described in Section 8.2.1, Programmer's Guide
- Language Reference, described in Section 8.2.2, Language Reference
- Error Messages, described in Section 8.2.3, Error Messages
- Visual C++ User's Guide (for Visual Fortran), described in Section 8.2.4, Visual C++ User's Guide (for Visual Fortran)
- Array Visualizer PDF files, described in Section 8.2.5, Compaq Array Visualizer Documentation
8.4.1 Viewing PDF Files
To view the PDF files, you must use the Adobe Acrobat Reader, Version 4.0 or later. To get the latest version of Acrobat Reader, do one of the following:
- Download it from the Adobe Systems Web site and install it. The site is at:
http://www.adobe.com- Use the Acrobat Reader self-extracting installation file located on the Visual Fortran CD-ROM. In Windows Explorer, double-click on the file rs40eng.exe in the \x86\Tools\AcroRead directory.
It is recommended that you remove any previous versions of Acrobat Reader before you install a newer version.
8.4.2 Location of Installing and Getting Started PDF File
The Compaq Visual Fortran Installing and Getting Started PDF file Cvf_gs.pdf is located in the root directory of the Visual Fortran CD-ROM.
After installation, the PDF file is in:
\Program Files\Microsoft Visual Studio\Df988.4.3 Location of CXML PDF File
The Compaq Extended Math Library Reference Guide PDF file Cxmlref.pdf is located on the Visual Fortran CD-ROM in the following directory:
\x86\df\cxml\docAfter installation (if requested), the PDF file is in:
\Program Files\Microsoft Visual Studio\Df98\Cxml\Doc8.4.4 Location of IMSL PDF Files
The following PDF files are available for IMSL:
- IMSL contents file, Imsl.pdf
- IMSL Math/Library, Volumes 1 and 2, file Math.pdf
- IMSL Math/Library, Special Functions, file Sfun.pdf
- IMSL Stat/Library, Volume 1, file Statvol1.pdf
- IMSL Stat/Library, Volume 2, file Statvol2.pdf
- IMSL Fortran 90 MP Library, file, F9040.pdf
The PDF files are located on the Visual Fortran CD-ROM in the following directory:
\x86\Df\IMSL\HelpAfter installation (if requested), the PDF files are in:
\Program Files\Microsoft Visual Studio\Df98\Imsl\Help8.4.5 Location of FLEXlm PDF File
If you use the default installation directory when you install the FLEXlm software license manager, the FLEXlm End Users Manual PDF file, enduser.pdf, is installed in:
C:\FLEXLM8.5 Documentation Available in WinHelp Format
The following documentation is available in WinHelp format when you click on Help when using the products:
- Online help for Array Viewer
- Online help for some Visual Fortran tools, such as Bit Viewer and Format Editor.
8.6 Information About New Features
For information about new features for Visual Fortran, bring up the HTML Help Viewer. See Section 9.2, Displaying the HTML Help Viewer.
In the Contents pane, do the following:
- If not expanded, expand the Compaq Visual Fortran 6.6 title.
- If not expanded, expand Visual Fortran.
- If not expanded, expand Compaq Visual Fortran.
- Click on Home Page.
- Click on the link to New Features for Compaq Visual Fortran Version 6.6.
For information about new features for Array Visualizer, bring up the HTML Help Viewer. In the Contents pane:
- If not expanded, expand the Compaq Visual Fortran 6.6 title.
- If not expanded, expand Visual Fortran.
- If not expanded, expand Compaq Array Visualizer.
- Click on Home Page.
- Click on the link to New Features for Compaq Array Visualizer Version 1.6.
8.7 Where to Find Information About Particular Topics
Table 8-1 lists various topics and where to find information about them in the document set.
Note that you can search through the online books for keywords. See Section 9.7, Using the Search Tab to Locate Topics by Searching.
Table 8-1 Where to Find Information About Particular Topics Topic Where to Find It Using the Microsoft visual development environment Programmer's Guide: Building Programs and LibrariesVisual C++ User's Guide (for Visual Fortran): Visual C++ Environment, Working with Projects, Text Editor, Debugger, other sections Compatibility with versions of Microsoft Fortran and Microsoft extensions Programmer's Guide: Compatibility Information, Compiler and Linker Options Defining procedures for an application Language Reference: Program Structure, Characters, and Source Forms, Program Units and ProceduresCompaq Fortran Language Reference Manual: Program Structure, Characters, and Source Forms, Program Units and Procedures Compiling and linking Programmer's Guide: Building Programs and Libraries, Using the Compiler and Linker from the Command Line, Compiler and Linker Options, Using Tools from the Command Line in the topic Using Visual Fortran Tools Starting a new program Programmer's Guide: Portability and Design Considerations Handling run-time errors Programmer's Guide: Handling Run-Time Errors, Locating Run-Time Errors in the Debugger in the topic Debugging Fortran ProgramsVisual C++ User's Guide (for Visual Fortran): Debugger Improving performance Programmer's Guide: Performance: Making Programs Run Faster Adding windows to your application Programmer's Guide: Using QuickWin, Using Dialogs Getting user input with dialog boxes Programmer's Guide: Using Dialogs Adding mouse functions to your application Programmer's Guide: Using QuickWin Adding graphic elements Programmer's Guide: Drawing Graphic Elements, Using Fonts from the Graphics Library Multitasking Programmer's Guide: Creating Multithread Applications Interacting with other applications Programmer's Guide: Programming with Mixed Languages, Creating Fortran DLLs Working with other platforms Programmer's Guide: Portability and Design Considerations, Portability Library, Compatibility Information, The Floating-Point Library Handling foreign character sets Programmer's Guide: Using National Language Support Routines CXML routines Programmer's Guide: Using the Compaq Extended Math Library (CXML) IMSL routines Programmer's Guide: Using the IMSL Mathematical and Statistical Libraries Using COM and Automation objects from Fortran applications Programmer's Guide: Using COM and Automation Objects Creating a Fortran COM server Programmer's Guide: Creating a COM Server Compaq Array Viewer and Array Visualizer description Section 7.7, Using the Array VisualizerGetting Started in the Compaq Array Visualizer title Using the Array Viewer Help menu in the Array ViewerGetting Started in the Compaq Array Visualizer title Calling the Array Visualizer routines from Fortran applications API Calls for Fortran Programmers in the Compaq Array Visualizer title Calling the Array Visualizer routines from C or C++ applications API Calls for C Programmers and API Calls for C++ Programmers in the Compaq Array Visualizer title Using the Array Visualizer Avis2D and AvisGrid ActiveX controls Array Visualizer Controls in the Compaq Array Visualizer title Differences between Fortran 95 and Fortran 90 Language Reference: Fortran 95 Features, Fortran 90 FeaturesCompaq Fortran Language Reference Manual: Overview Differences between Fortran 90 and FORTRAN 77 Language Reference: Fortran 95 Features, Fortran 90 FeaturesCompaq Fortran Language Reference Manual: Overview Glossary of terms Language Reference: GlossaryCompaq Fortran Language Reference Manual: Glossary