dxbook(1X)																dxbook(1X)

Name
       dxbook - Bookreader

Syntax
       dxbook [ options ] [ file ]

Arguments
       file	 Specifies a bookshelf file.  If you do not include this argument, Bookreader uses the file specified by the environment variable.
		 If is not defined, Bookreader uses the default bookshelf file,

Description
       The command runs Bookreader.  Bookreader lets you view online documentation on your workstation screen.

       Bookreader has two windows:  the selection window and the topic window.	The selection window lists the	bookshelves  and  books  available
       from  Bookreader,  and  the  table  of  contents or index when a book is open.  The topic window displays the contents of the book you have
       selected to view.

       A bookshelf is a group of related books.  To view a book that is in a shelf, you must first open the shelf by double-clicking  MB1  on  the
       shelf title.  When you open a shelf, a list of the books and bookshelves in that shelf appears in the selection window.

       When you open a book by double-clicking MB1 on the book title, the table of contents for that book appears in the selection window, and the
       title page for the book appears in the topic window.

       You can move through a book's contents in the topic window using the scroll bar and the Next Topic, Previous Topic, Go Back, and More  but-
       tons.

       In the topic window, a reference in the text to a figure, a table, or an example is a hotspot.  That is, if you position the pointer at the
       reference and click MB1, the figure, table, or example is displayed in a separate window.  A figure, table, or example  may  also  be  dis-
       played by selecting it from the book's table of contents in the selection window.

       Cross-references  to  other sections of text are also hotspots.	Clicking on a reference to another section causes the new topic to be dis-
       played in the topic window.

       Hotspots are normally highlighted only when you move the pointer over the reference.  You can cause hotspots to be continuously highlighted
       by choosing the Hot Spot menu item from the topic window View menu.

       Clicking MB1 on the Index button located at the bottom of the selection window displays the book's index; clicking MB1 on the Contents but-
       ton displays the table of contents.  Double-clicking MB1 on an item in the book's table of contents or index displays the referenced  topic
       in the topic window.  Use the scroll bar in the selection window to move quickly through the book's table of contents or index.

       Every  command  button  has  an	equivalent menu item in the Control or View menu of the selection or topic window; therefore, you can also
       choose a selection or navigation function by selecting the appropriate menu item.

Options
       -bg color	   Specifies the color of the selection window's background (color displays only).  The default is white.

       -d dispname	   Specifies the display screen on which displays its windows.	If the display option is not specified, uses  the  display
			   screen  specified  by  the  environment variable.  The display option has the format hostname:number.  Using two colons
			   (::) instead of one (:) causes DECnet to be used for transport.  The default is :0.	For more information, see

       -display dispname   This option is the same as the -d option.

       -fg color	   Specifies the color of Bookreader windows' foreground (color displays only).  The default is black.

       -geometry	   Specifies the width, length, and location of the selection window.  If the geometry argument  is  not  specified,  uses
			   default  values.   The  geometry option has the format =[width][xlength][x][y], where width and length are specified in
			   pixels.  Note that changing the width or length of the selection window may make the contents of the  window  difficult
			   to read.  For more information about the screen coordinate system, see

       -rv		   Reverses the default color values (for example, black becomes white and white becomes black).

Menus
       Many  of the items in the Control and View menus of the selection and topic windows have equivalent command buttons, located along the bot-
       tom edge of the selection and topic windows.  You can select a function using the menu item or the equivalent command button.

Selection Window
       The Bookreader selection window contains the following menus:
       Control
       View

   Control Menu
       The Control menu in the selection window allows you to open and close shelves and books, and exit the Bookreader application.  The  Control
       menu contains the following menu items:

       Open Shelf	   Opens the bookshelf you have selected.  The titles of the books in the bookshelf are displayed in the selection window.

       Open Book	   Opens the book you have selected.  The title page of the book is displayed in the topic window, and the book's table of
			   contents is displayed in the selection window.

       Close Shelf	   Closes the bookshelf currently displayed in the selection window.

       Close Book	   Closes the book currently displayed in the topic window.

       Quit		   Exits from the Bookreader application and closes all windows.

   View Menu
       The View menu in the selection window allows you to select what Bookreader displays in the selection window.  The View  menu  contains  the
       following menu items:

       Library		   Displays  the  top-level list of shelves and books that can be viewed online, and closes an open book in the topic win-
			   dow.

       Table of Contents   Displays the table of contents for the book that is currently open.

       Index		   Displays the index for the book that is currently open.

       Tables		   Displays a list of the tables in the book that is currently open.

       Figures		   Displays a list of the figures in the book that is currently open.

       Examples 	   Displays a list of the examples in the book that is currently open.

       Topic		   Displays the selected topic in the topic window.

Topic Window
       The Bookreader topic window contains the following menus:
       Control
       View

   Control Menu
       The Control menu in the topic window allows you to control the topic window.  The Control menu contains the following menu item:

       Close Topic	   Closes the topic window.

   View Menu
       The View menu in the topic window allows you to select what Bookreader displays in the topic window.  The View menu contains the  following
       menu items:

       Previous Topic	   Displays the previous topic in the book.

       Next Topic	   Displays the next topic in the book.

       Go Back		   Displays the topic you were viewing just prior to the current topic.

       More		   Displays the next window of text in the current topic.  If the end of the current topic is visible in the topic window,
			   the next topic is opened.

       Hot Spots	   Enables and disables highlighting of hotspots, which are references to figures, tables, examples, footnotes,  or  other
			   sections of text.  By default, hotspots are not highlighted.

       Extensions	   Enables  and disables highlighting of programming language extensions.  By default, extensions to programming languages
			   are highlighted in the topic window.

X Defaults
       The application reads the file during startup and uses the appropriate resource specification to customize the appearance  or  characteris-
       tics of its displayed window.  The format for a resource specification in the file is:

       [name*]resource:  value

       name	 Specifies the application name or the name string that restricts the resource assignment to that application or to a component of
		 an application.  If this argument is not specified, the resource assignment is globally available to all X applications.

       resource  Specifies the resource.

       value	 Specifies the value that is to be assigned to the resource.

       For more information, see

       Because each toolkit-based application can consist of a combination of widgets (for example, push buttons and a scroll bar), you  can  form
       the  name  string  by  adding widget class and name identifiers to the string.  For further information about adding class and name identi-
       fiers, see

       For the application class identifier is DXBookreader.

       For the application name identifier is dxbook.

       The resources available for are:

       background	   Specifies the selection window background color.  The default is white.

       foreground	   Specifies the selection and topic window foreground color.  The default is black.

       initialState	   Specifies whether Bookreader starts up with the selection window displayed, or starts up as an icon.  Setting the  ini-
			   tial state to 3 causes Bookreader to start up as an icon.

   Examples
       To change the foreground color of the Bookreader windows, add the following entry to your file:
       dxbook*foreground:  yellow
       To cause Bookreader to start up as an icon, add this entry to your file:
       DXBookreader.initialState: 3

Specifying Libraries
       When  you first run Bookreader, the list of bookshelves and books that appears in the selection window is the top-level library.  A special
       file called the bookshelf file contains an entry for each bookshelf and book that appears in the top-level library.  You  can  specify  the
       bookshelf  file	explicitly,  using  the  file  argument on the command line.  If the file argument is not included, or does not contain an
       explicit pathname specification, Bookreader uses the environment variables and to locate the bookshelf file.

       DECW_BOOK	   Specifies the search path for book and bookshelf files.  Separate multiple pathnames with spaces.  If is not set and no
			   explicit pathname is specified on the command line, Bookreader looks for book and bookshelf files in

       DECW_BOOKSHELF	   Specifies  the  bookshelf  file.   If  is not set and the file argument is not included on the command line, Bookreader
			   looks for a bookshelf file named

			   If is not set, but is, Bookreader looks for bookshelf files named using the search path specified by

       The environment variables allow you to have Bookreader recognize additional books or bookshelf files.  You can store  bookshelf	files  and
       their  associated book files in different directories, and set the environment variable to specify all the pathnames. For example, you have
       the default bookshelf and books in and another bookshelf with its books in You set to specify both pathnames:
       setenv DECW_BOOK "/usr/lib/dxbook /usr/local/lib/localbooks"

       and all titles appear in the selection window when you run Bookreader.

Files
       Bookreader binary

       Default bookshelf

See Also
       Using Bookreader 	     Available online in the default bookshelf

																	dxbook(1X)