[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

System User's Guide: Operating System and Devices

Chapter 13. Documentation Library Service


The Documentation Library Service allows you to read, search, and print online HTML documents. It provides a library application that appears in your web browser. The application includes links to read installed documents and a search form that you can use to search for text. When you search, a results page displays the results of the search with links to the documents containing the search target words.

Starting with AIX 5.1, you can also download printable versions of books by using the Print Tool button in the documentation library service form.

Two types of forms are provided: a global search form that shows all the volumes installed on a search server, and a specific search form that just searches a specific set of volumes such as the manuals for an application.

The documentation library service allows you to search documents that have been registered with the search service. Registration is done by the system administrator. You cannot search the Internet or any unregistered documents on your search server.

If you write HTML documents at your site, your system administrator can add these documents to the documentation library so that you can read, search, and print the documents.

Using the Documentation Library Service

To use the Library:

After the library application opens, you can click on the Help link in the upper right corner for instructions on how to use the library.

How to Change the Documentation Library Service Language

By default, when you open the CDE Desktop icons for the operating system Documentation Search Service or the Base Library, the documents that are displayed appear in the same language as your CDE Desktop.

However, you might need to see the documentation in a language that is different than your desktop language. For example, your desktop runs in your native language but the manuals may only be available in English. You can change your documentation language so that documents appear in a different language than that used in your desktop.

  1. These techniques do not affect the language used if you are opening a document or search form from an HTML link inside another document. These techniques only affect the language used for the Documentation Search Service or the Base Library desktop icons.
  2. Make sure there is documentation installed for the language you want to use.

You can change your documentation language by running the following command:

/usr/bin/chdoclang locale

Where locale is replaced by the locale name that is the new language for viewing and searching documentation. Locale names can be found in the Locale Naming Conventions inAIX 5L Version 5.1 System Management Concepts: Operating System and Devices.

  1. You must log out and then log back in to see the language change take effect.
  2. If you are using the CDE Desktop, you must also edit your Desktop file $HOME/.dtprofile so that your documentation language setting in your $HOME/.profile file will be read during CDE login. To do this, complete the following steps:
    • Open your .dtprofile file in the dtpad editor by typing the following command:

      dtpad $HOME/.dtprofile
    • Find the line that contains the text:

    • If there are any comment (#) characters at the start of that line, delete just the # characters, not the entire line. If there are no comment characters, close the editor.
    • Save your changed .dtprofile file.
    • Log out and log back in.

For example, if you want to change your documentation language to Spanish (es_ES), type the following command:

/usr/bin/chdoclang es_ES

Log out and log back in to your desktop.

After you change your documentation language, you can delete the language setting so that documentation will again appear in the same language as your desktop. To delete your language setting, type the following command:

/usr/bin/chdoclang -d

Log out and log back in to your desktop.

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]