
                               BookView
                    NDTP client written in Tcl/Tk.

   This is edition 2.4.1, for BookView version 2.4.1.


What is BookView?
*****************

   BookView is a NDTP (Network Dictionary Transfer Protocol) client
written in Tcl/Tk.  It requires Tcl8.0jp/Tk8.0jp (`jp' means `Japanized
version').

   BookView is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2, or (at your option) any
later version.

   BookView is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

   This edition corresponds to version 2.4.1 of BookView.


`services' File
***************

   Before invoking BookView, you have to do an system adminstrative
work.  The service name `ndtp' must be added to the `services' file on
your system (usually, `/etc/services'), if missing.  If your host runs
as NIS client, you have to edit the NIS map on the NIS server, instead.

   This line shuold be added, if missing.

     ndtp          tcp/2010

The `services' file on your system may have the `tcp/2010' line by
default, but its service name may not be `ndtp', like as following:

     search        tcp/2010

   In this case, please add the service name `ndtp' to the line as an
alias:

     search        tcp/2010        ndtp

(For details, please read the manual for your system.)


Basic Use of BookView
*********************

   This chapter explains basic usage of BookView.


Invoking BookView
=================

   To invoke BookView from a command line, type as follows:

     	/usr/local/bin/bookview

(It assumes that BookView has been installed under `/usr/local'.)


Summary of Options to `wish'
============================

   The following command line options are recognized by `wish':

`-colormap new'
     Colormap for main window

`-display DISPLAY'
     Display to use

`-geometry GEOMETRY'
     Initial geometry for window

`-name NAME'
     Name to use for application

`-sync'
     Use synchronous mode for display server

`-visual'
     Visual for main window

`--'
     Pass all remaining arguments through to script


Summary of Options to `bookview'
================================

   The following command line options are recognized by `bookview'
itself:

`-bg COLOR'
`-background COLOR'
     Specify a background color

`-fg COLOR'
`-foreground COLOR'
     Specify a foreground color

`-fn FONT'
`-font FONT'
     Specify a font

`-fk FONT'
`-kanjifont FONT'
     Specify a kanji font

`-iconic'
     Iconify the window

`-title TITLE'
     Specify a title of the window

`-version'
     Output version number, then exit


Setup...
========

   Select the `Setup...' command in the `File' menu.  A setup
sub-window will be popped up.  The sub-window consists of two parts;
`Servers:' and `Bitmap:'.

   In the `Server:' part, you can specify your NDTP servers.  Fill the
hostname and port entrires of NDTP servers.  In a hostname entry, you
can specify a hostname (e.g. `localhost') or an address (e.g.
`127.0.0.1').  In a port entry, you can specify a service name (e.g.
`ndtp') or a port number (e.g. `2010').  You can specify three servers
maximum.

   Each server entry also has an extra entry `start book ID'.
`bookview' selects the book with the book ID filled in this entry when
it connects to this server.  If the entry is empty, no book is selected.
Please keep the entry empty if you aren't experienced at using BookView.

   In the `Bitmap:' part, you can choose a preference order of bitmap
sizes of characters defined in CD-ROM books.

   When setup have been done, click the `Ok' button in the sub-window.
The setup sub-window will be destroyed.  The configuration will be
recorded to the file `$HOME/.bookview'.  The file is automatically
loaded at start of BookView, so that you don't have to setup at the
next time you invoke BookView.

   When you click the `Cancel' button, the setup sub-window will be
destroyed and all modifications in the sub-window will be discarded.


Select Server
=============

   Click the `Server:' menu.  The servers specified at setup will be
listed here.  Selcet a server in the list, and then BookView connects
to the server.

   If you have set the start book ID for the server, BookView selects
the server.  Otherwise, the book list of the server is displayed.


Select Book
===========

   Available books in the current selected server are listed in the
`Book:' menu.  Please select a book in the list.


Search Word
===========

   Input a word to search in the `Word:' entry, and then press <Return>
or click the `Query' button.  BookView will send a search request to
the current server and receive a response from the server.  Candidates
matched to the input word will be listed in the first text area ("Hits"
area).  Each candidate has `(->text)' in its tail.  Click here and then
the corresponding text to the entry will be displayed in the second
text area ("Text" area).

   The `Clear' button makes the `Word:' entry be empty.

   An asterisk (`*') can be placed at the beginning or end of the input
word.  An asterisk matches to any sequence of zero or more characters.
Note that you cannot put two or more asterisks into a word.


Menu
====

   If the selected book supports "Menu search", the `MENU' button in
the tool bar and the `Menu' command in the `View' menu come to be
enabled.  Click the button or select the command to enter the `Menu
search' mode.


Copyright Notice
================

   If the selected book has "copyright notice", the `RIGHT' button in
the tool bar and the `Copyright' command in the `View' menu come to be
enabled.  Click the button or select the command to view the copyright
notice.


Reference
=========

   If text in the Text area contain a reference, it is displayed as
`(->link)' with underline and colored blue.  Click it, and then
referenced text will be displayed.


History Operations
==================

   BookView records a history of text displayed in the Text area.  The
history is listed in the `Go' menu in the menu bar.  Select an item in
the list, and then BookView displays the corresponding text in the Text
area.

   To take a step backward in a history list, click the `PREV' button
in the tool bar, select the `Previous' command in the `Go' menu, or
type <Alt+P> or <Alt+Left>.  To take a step forward in a history list,
click the `NEXT' button in the tool bar, select the `Next' command in
the `Go' menu, or type <Alt+N> or <Alt+Right>.


Help
====

   Select the `Help (English)...' or `Help (Japanese)...' command in
the `Help' menu.  A sub-window is popped up, and this document will be
displayed in it.


Quit
====

   Select the `Quit' command in the `File' menu or type <Alt+Q>, then
quit.


Advanced Use of BookView
************************

   This chapter explains functions for expert users.


Search the Selection
====================

   There is the `Q Sel' button between the `Query' and `Clear' buttons.
`Q Sel' is the "Query Selection" short-cut button; is clears the
`Word:' entry, pastes the selection onto the entry, and then query the
word.

   Also the `Query Selection' command in the `View' menu, and
<Alt+Return> do the same action.


Find Pattern in Text
====================

   `Find in Text...' command in the `View' menu and the `FIND' button
in the tool bar are equvalend.  They are used to search a word in the
Text area.  Choosing this command, then the sub-window `find word in
text' will be popped up.  Type the pattern you want to find in the
`Find:' entry, and then hit <Return> or click the `Find' button, then
BookView finds the pattern in the Text area.


Book List
=========

   Choosing the `Book List' command in the `View' menu, BookView shows
the book list that the current server provides.  When a connection to
the server is established, and if you have not set the start book ID
for the server, BookView shows this list automatically.


Display or Hide Bitmaps
=======================

   Whether BookView displays text with bitmaps or not can be switched
by the `Display Bitmaps' check-button in the `View' menu.  By default,
bitmaps are displayed.

   However, bitmaps aren't displayed regardless of this parameter, if
the CD-ROM book doesn't have any size of bitmaps listed in the
preference order you choose,


Display or Hide Bitmaps
=======================

   Whether BookView displays the tool bar or not can be switched by the
`Display Tool Bar' check-button in the `View' menu.

   By default, the tool bar is displayed.


Adjust Text Spacing
===================

   The `Text Spacing' command in the `View' menu has a cascade menu.
The cascade menu has, in tern, five items; 0, 2, 4, 6, 8 pixels.  These
items are used to determines space between lines in the Text area.  The
default value is `0 pixel'.


Keyboard Operation
******************

   You can invoke all functions of BookView by keyboard.  This chapter
explains how to operate BookView with keyboard.


Focus Operations
================

   The following key operations move the focus on a widget.  These
operations are sensed anywhere on the BookView main window.

<Alt+F>
     Pull the `File' menu down and grab it.

<Alt+V>
     Pull the `View' menu down and grab it.

<Alt+G>
     Pull the `Go' menu down and grab it.

<Alt+H>
     Pull the `Help' menu down and grab it.

<Alt+S>
     Pull the `Server:' menu down and grab it.

<Alt+B>
     Pull the `Book:' menu down and grab it.

<Alt+W>
     Focus on the `Word:' Entry.

<Tab>
     Move the focus to the Word entry, Hits area, and Text area, in that
     order.


Operations In Menu
==================

   In a grabbed menu, you can do the following operations.

<Up>
<Control+P>
     Move the highlight entry up.

<Down>
<Control+N>
     Move the highlight entry down.

<Return>
     Select the highlight entry.

<Esc>
     Abort a menu selection.

   Some other operations are defined by Tk itself.  See the manual page
of menu(n) for more details.


Operations In Word Entry
========================

   In the `Word:' entry, the following keyboard operations are sensed.

<Left>
<Control+B>
     Move the cursor backward by a character.

<Right>
<Control+F>
     Move the cursor forward by a character.

<Home>
<Control+A>
     Move the cursor to the beginning of the entry.

<End>
<Control+E>
     Move the cursor to the end of the entry.

<Backspace>
<Control+H>
     Delete a character to the left of the cursor.

<Delete>
<Control+D>
     Delete a character to the right of the cursor.

<Control+K>
     Delete all characters to the right of the cursor.

   Some other operations are defined by Tk itself.  See the manual page
of entry(n) for more details.


Operations In Hits Area
=======================

   In the Hits area, the following keyboard operations are sensed.

<Up>
<Control+P>
     Move the cursor one line down.

<Down>
<Control+N>
     Move the cursor one line up.

<Prior (Page Up)>
<Alt+V>
     Move the cursor backward by one page.

<Next (Page Down)>
<Control+V>
     Move the cursor forward by one page.

<Return>
     Choose the hit entry at the inesrtion cursor.  Text of the hit
     entry is displayed at the Text area.

   Some other operations are defined by Tk itself.  See the manual page
of text(n) for more details.


Operations In Text Area
=======================

   In the Text area, the following keyboard operations are sensed.

<Left>
<Control+B>
     Move the cursor backward by a character.

<Right>
<Control+F>
     Move the cursor forward by a character.

<Down>
<Control+N>
     Move the cursor one line up.

<Up>
<Control+P>
     Move the cursor one line down.

<Prior (Page Up)>
<Alt+V>
     Move the cursor backward by one page.

<Next (Page Down)>
<Control+V>
     Move the cursor forward by one page.

<space>
     Move the cursor to the next anchor (`(->link)') in the text.

<BackSpace>
     Move the cursor to the previous anchor (`(->link)') in the text.

<Return>
     If the cursor is on the anchor, jump to the reference.

   Some other operations are defined by Tk itself.  See the manual page
of text(n) for more details.


Miscellaneous Operations
========================

   These operations are sensed anywhere on the BookView main window.

<Alt+Q>
     Quit.  This key operation is equivalent to the `Quit' command in
     the `File' menu.

<Alt+Return>
     Query selection.  This key operation is equivalent to the `Query
     Selection' command in the `View' menu.

<Alt+Left>
<Alt+P>
     Take a step backward in a history list.  This key operation is
     equivalent to the `Previous' command in the `Go' menu.

<Alt+Right>
<Alt+N>
     Take a step forward in a history list.  This key operation is
     equivalent to the `Next' command in the `Go' menu.

<Alt+/>
     Pop up the `Find in Text' sub-window, and grab it.  This key
     operation is equivalent to the `Find in Text...' command in the
     `View' menu.


