Chapter 1 Introduction

This chapter introduces the AnswerBook2 product and explains where you can find more information about using it. It includes the following information:

• "AnswerBook2 Overview"

• "AnswerBook2 Features and Functions"

• "New AnswerBook2 Features for This Release"

• "Pieces and Parts"

• "Frequently Asked Questions"

For information about running a documentation server, rather than viewing documentation, see Installing and Administering an AnswerBook2 Server.

AnswerBook2 Overview

The AnswerBook2 product is Sun's online documentation system. It uses a web-browser interface that lets you view and print a variety of Solaris information, including SGML-based AnswerBook^TM collections, Display PostScript^TM AnswerBook collections, and man pages.

The AnswerBook2 product provides a search engine that lets you find information throughout the documentation library. You can install AnswerBook2 document collections on a centralized documentation server or on a local server.

Throughout the AnswerBook2 documentation, the term AnswerBook1 refers to the version of the AnswerBook product provided with pre-2.6 versions of the Solaris operating environment.

AnswerBook2 Features and Functions

The AnswerBook2 product provides the following features and functions:

• Uses a web-browser-based interface so that you can view online documentation from any platform (running any operating system), provided that your web browser supports HTML 3.2

• Lets you copy information from AnswerBook2 documents and paste it into other locations, such as your command line, depending on your web browser's functionality

• Provides a search engine for finding words and word phrases throughout the documentation library

• Gives you the ability to print sections and books directly from the AnswerBook2 interface in a PostScript format that is near print-quality output

• Lets you view old and new AnswerBook documents using a single interface

• Lets you define a subset of document collections (a Personal Library) to be displayed when using a specific documentation server

• Allows you to choose a language in which to view on-screen instructions and Help information

• Uses a client-server architecture that allows the documents to be stored in a single location (server) and accessed from the user's desktop (client)

• Provides a command-line interface (CLI) and a browser-based interface (GUI) for performing documentation server administration functions

New AnswerBook2 Features for This Release

The following list identifies the new or substantially enhanced features provided in this release of the AnswerBook2 software.

• Man pages (Reference Manual) in AnswerBook2 format

  Traditional UNIX-style manual (man) pages are available in AnswerBook2 format. The search interface allows you to choose to search only the SGML-based man pages installed on the documentation server.

• Support for multimedia content

  If the document source includes audio or video files, the AnswerBook2 system lets you access them according to what you have defined in your browser for audio and video support.

• Ability to run an AnswerBook2 server directly from the CD

  You can run the AnswerBook2 server directly from the Solaris 7 Documentation CD using the ab2cd script if you have the CD and you have root access to the system on which the CD is connected. For detailed information about this feature, see the section Running a Documentation Server from the CD in Installing and Administering an AnswerBook2 Server.

Pieces and Parts

The AnswerBook2 product consists of the following elements:

• A client web browser -- The Solaris 7 release includes the Netscape^TM browser; however, you can use any HTML 3.2-compliant browser to view Sun's online documentation. To view Solaris 7 documentation, you need to know the URL for a documentation server or you can view all released Solaris documentation at http://docs.sun.com.

  ---

  Note -

  If you just want to view online documentation, you only need this element. All other elements are part of the documentation server system.

  ---

• A documentation server -- Performs query functions and "serves" documents to the client browser. Includes templates that provide a common "look and feel" for document viewing and printing; and provides both web-browser and command-line administration interfaces that perform database, password authentication, and other administrative functions.

• Document collections -- Can be new (SGML) documents or old (Display PostScript) documents.

Frequently Asked Questions

This section lists some common questions about the AnswerBook2 product along with answers to those questions.

What is AnswerBook2?

The AnswerBook2 product uses a standards-based documentation server to deliver Sun's online documentation through your favorite web browser. The AnswerBook2 interface lets you browse, search, and print a variety of Solaris information, including AnswerBook1 collections and man pages.

How is AnswerBook2 different from AnswerBook?

The previous AnswerBook product (now called AnswerBook1) used Display PostScript^TM to display electronic versions of documents primarily developed for paper delivery. The AnswerBook2 product uses a web browser to display documentation developed for online delivery using SGML and to display existing AnswerBook1 documents.

The following list identifies some key differences between the products:

• Web-browser interface -- You can use any HTML 3.2-compliant browser on any platform to view online documentation with the AnswerBook2 product.

• Source flexibility -- The documentation server can deliver AnswerBook1 (Display PostScript) documents or AnswerBook2 (SGML) documents.

• Client-server support -- The AnswerBook2 product allows you to install the server and document collections in a central location and view the documents from other systems. In addition, it includes a "fail-over" mechanism in which the document administrator can define multiple documentation servers so that links between documents always work.

• Cross-platform -- For this release, the AnswerBook2 documentation server must run in the Solaris 7 operating environment (SPARC or Intel). However, AnswerBook2 clients can run on any platform, and future releases might provide server functionality on additional platforms.

• Default search behavior -- The AnswerBook2 product uses AND for its default search behavior rather than OR (the default search behavior in the AnswerBook1 product).

Can I still view my old AnswerBook collections with AnswerBook2?

Yes, unless your old AnswerBook documents were created before the release of the Solaris 2.2 operating environment. To add AnswerBook1 collections to the documentation server's database, the document administrator uses the AnswerBook2 "add collection" function and points to the directory containing the AnswerBook1 ab_cardcatalog file.

Does AnswerBook2 provide the same functionality for AnswerBook1 and AnswerBook2 documents?

No. For consistency, the AnswerBook2 interface for AnswerBook1 documents is similar to the AnswerBook1 product interface. The following briefly lists the differences in functionality for AnswerBook1 and AnswerBook2 collections:

• You cannot show or hide all levels of an entire AnswerBook1 table of contents listing; you can only show or hide details for a specific section within the table of contents.

• AnswerBook1 content pages do not include Other Topics sections. To navigate from one page to another, you can use the Next Topic link or return to the Table of Contents and select another section in the book.

• AnswerBook1 content pages display the entire chapter at one time, not smaller sections.

• Search results icons poorly represent the probability of a match for AnswerBook1 information; the icons tend to be either completely filled or completely empty.

• Search terms are not highlighted in AnswerBook1 text.

• Some AnswerBook1 graphics cannot be displayed inline; they are identified by an icon that, when clicked on, brings up a PostScript display of the graphic.

• A Man Pages by Keyword search includes only the AnswerBook2 (SGML-based) man pages on the server, not the AnswerBook1 man pages.

• The AnswerBook1 man pages use the same interface as other AnswerBook1 documents; they do not have a special man page interface.