HydraExpress comes with a full set of documentation. For single-point access to the HTML documentation for all installed HydraExpress products, point your browser to <installdir>\docs\index.html.
For a list of documents and their locations, see Section 1.7.
The documentation for HydraExpress uses typographic conventions and pathname conventions similar to other Rogue Wave documentation. These conventions are summarized in the following tables:
| Conventions | Purpose | Example |
| Courier | Function names, code, paths, directory and file names, URLs, operating system commands. | Config(const Config& config);www.roguewave.com rwsfserver start |
| italic | variables in code Conventional uses, such as new terms and titles. |
<installdir>\docs The deployment descriptor provides… Reference Guide |
| bold italic | Class names and emphasis. | rwsf::Exception |
| bold | Conventional uses, such as emphasis. Commands from an interface. |
You should always read the manual. Click the OK button |
| ... (or vertical ellipses) | Indicates part of the code is missing from an example. | foo(){ ... // Something happens } |
| Convention | Purpose | Example |
| <installdir> | The directory where HydraExpress was installed. | <installdir>\docs\index.html |
| \ | The Windows delimiter in a path name. If you use UNIX, replace \ with /. | For <installdir>\docs, a UNIX user enters <installdir>/docs. |
Rogue Wave HydraExpress class names and types are typically referenced with the namespace qualification rwsf::. Template parameter values for templatized classes appear in angle brackets < > like this: rwsf::Enumeration<T>. Formal template parameters appear in text only when they are important to the discussion, so you may occasionally see this: rwsf::Enumeration<T>, but generally it is simply rwsf::Enumeration.
All member function names start with a lower case letter, but subsequent words are capitalized. In most class and function names, words are fully spelled out, for example:
| rwsf::ServletContext | A class name |
| getContext() | A function name |
In our manuals, we sometimes refer to an instance of a class generically; for example, the "servlet class" instead of "rwsf::Servlet class." We do this for readability when the meaning should be clear from context. If there is possible ambiguity, however, we use the actual class name.
Throughout the documentation, references to "self" mean *this.
Our manuals present command lines in courier. When a command line is identical on all supported operating systems, the command begins with the word "prompt", as shown below:
prompt> echo "The same on all systems."
When the syntax of a command line differs depending on the operating system, we provide a table that lists the operating systems and the command syntax. We use simply "Windows" for all versions of the Windows operating system. We use the phrase "UNIX/Linux" to mean UNIX operating systems and the Linux operating system. For UNIX and Linux systems, the syntax of a command may also depend on the shell. For example, the command below sets an environment variable:
| Windows | set PATH=%RW_HOME%\bin;%PATH% |
| UNIX/Linux sh | PATH=$RW_HOME/bin:$PATH ; export PATH |
Copyright © Rogue Wave Software, Inc. All Rights Reserved.
The Rogue Wave name and logo are registered trademarks of Rogue Wave Software, and HydraExpress is a trademark of Rogue Wave Software. All other trademarks are the property of their respective owners.
Provide feedback to Rogue Wave about its documentation.