


XJDIC(1)                      XJDIC                      XJDIC(1)


NNAAMMEE
       XJDIC - an  electronic  Japanese-English  dictionary  pro-
       gram (V2.3)

       NNBB:: this man page contains a summary of the information in
       the xxjjddiicc2233..iinnff file.


SSYYNNOOPPSSIISS
       xxjjddiicc [[ ooppttiioonnss ]]

        - The XXJJDDIICC stand-alone program, or client which allows a
       user to connect to the xxjjddsseerrvveerr via a network.

       xxjjddsseerrvveerr [[ ooppttiioonnss ]]

        - The XXJJDDIICC server, which carries out dictionary searches
       on behalf of clients.

       xxjjddxxggeenn [[ ooppttiioonnss ]] ddiiccttiioonnaarryy__ffiillee

        - creates the .xjdx index file for dictionary files.


DDEESSCCRRIIPPTTIIOONN
       XXJJDDIICC  is  an   electronic   Japanese-English   dictionary
       program  designed  to operate  in  the  X11  window  envi-
       ronment.   In particular,  it must run in an "xterm" envi-
       ronment which has Japanese language support such  as  pro-
       vided by "kterm" or internationalized xterm, aixterm, etc.

       It  is based on JJDDIICC and JJRREEAADDEERR which were  developed  to
       run under MS-DOS on IBM PCs or clones.

       XXJJDDIICC functions as:

       (a)  an  English  to  Japanese  dictionary  (eiwa  jiten),
       searching   for   and  displaying  entries  for  key-words
       entered in English;

       (b)   a  Japanese  to  English  dictionary  (waei  jiten),
       searching for and  displaying  entries  for  keywords   or
       phrases    entered   in   Japanese   (kanji,  hiragana  or
       katakana);

       (c)  a  Japanese-English   Character   dictionary   (kanei
       jiten),   capable  of  selecting  kanji  characters by JIS
       code, radical, stroke count,  Nelson Index number or read-
       ing, and displaying compounds containing that kanji.

       XXJJDDIICC  is  typically run in a window of its own.  The user
       can then use it as a free-standing on-line dictionary.  It
       can  also  be   used   as  an  accessory when  reading  or
       writing  text  in  another window (e.g.  reading the  "fj"



UNIX                      September 1998                        1





XJDIC(1)                      XJDIC                      XJDIC(1)


       Japanese news groups.) Strings of text,  either English or
       Japanese,  can be moved to  and  from  XXJJDDIICC  using  X11's
       mouse "cut-and-paste" operations.

       All  the Japanese displayed by XJDIC is in kana and kanji,
       so if you  cannot read  at least  hiragana  and  katakana,
       this is not the program for you.  The author has no inten-
       tion whatsoever of producing a  version  using   romanized
       Japanese.


CCOOMMMMAANNDD LLIINNEE OOPPTTIIOONNSS
       Each option begins with a separate "-" identifier. Options
       are tagged: CL, SA or SV according  to  whether  they  are
       applicable  to the Client, Stand-alone or Server versions.
       Many of the options can also be set in the ..xxjjddiiccrrcc  file.

       --hh [CL,SV,SA]
              display list of options and exit.

       --EE [CL,SA]
              instruct  the  program  that it is in EUC mode, and
              refrain from interpreting the 3-byte kanji  of  the
              JIS  X  0212  set,  which  starts with a hex 8F, as
              Shift-JIS.


       --vv [CL,SA]
              disable the verb de-inflection function.


       --VV [CL,SA]
              disable the use of reverse-video in the display  of
              matches.


       --cc ccoonnttrrooll__ffiillee [CL,SV,SA]
              specify  the  path and name of a control file to be
              used instead of the default ".xjdicrc" file.


       --dd ddiiccttiioonnaarryy__ffiillee [SV,SA]
              specify a dictionary file to use (up to  9  may  be
              specified.)


       --kk kkaannjjii__ffiillee [SV,SA]
              specify a kanji data file to use.


       --jj jj//ee//ss [CL,SA]
              Specify the output coding for Japanese text (j=JIS,
              e=EUC, s=Shift-JIS)




UNIX                      September 1998                        2





XJDIC(1)                      XJDIC                      XJDIC(1)


       --PP ppoorrtt__nnoo [CL,SV]
              instruct the client/server version to use UDP  port
              nnnnn,  instead of the default  port  (47512).


       --SS sseerrvveerr__aaddddrreessss [CL]
              instruct  the  client  that  the  server is  to  be
              found  at  the specified network  address.


       --CC cclliippbbooaarrdd__ffiillee [CL,SA]
              the name of the file to use as the clipboard.


       --KK [SV]
              prevent  the  server   from   establishing   itself
              as  a  daemon.



KKEEYYBBOOAARRDD CCOOMMMMAANNDDSS
       XXJJDDIICC  operates  by  entering  text  strings of English or
       Japanese, upon which the matching dictionary  entries  are
       displayed.  As  well,  a range of single-character control
       commands are available to modify the program operation.

       The commands are:

       ??
              display a summary of the keyboard commands


       !!
              display the GNU GPL document.


       ##
              engage the romaji to  katakana  conversion  feature
              for the subsequent input.


       @@
              engage  the  romaji  to hiragana conversion feature
              for the subsequent input.


       &&
              toggle kana-input mode.


       //
              toggle  the display jukugo with a kanji in  a  non-
              initial position mode.




UNIX                      September 1998                        3





XJDIC(1)                      XJDIC                      XJDIC(1)


       \\
              go into kanji dictionary mode (see below.)


       ||
              toggle unedited output mode.


       ==
              switch  the  active  dictionary  to the next in the
              list.


       ^^
              switch the active dictionary to the previous one in
              the list.


       __
              select an active dictionary by number.


       $$
              specify  a  list  of  dictionary  numbers to use in
              global-search mode.


       %%
              toggle global search mode.


       **
              display  buffer-usage  statistics  (only  for   the
              stand-alone version with paged I/O)


       [[
              toggle exact-match mode.


       }}
              toggle  reverse-video  display  of  matched strings
              mode.


       ++
              toggle selection of priority keys  in  the  dictio-
              nary.


       ]]
              initiate  search of the extension file (none avail-
              able yet!).




UNIX                      September 1998                        4





XJDIC(1)                      XJDIC                      XJDIC(1)


       ''
              clear the  current  one-off  filter  (if  any)  and
              prompt for another.


       ;;
              set/clear general filters (as specified in the con-
              trol file.)


       {{
              enter clipboard mode (all search keys will  now  be
              taken from the clipboard file.)


       ::
              toggle verb-deinflection mode


       --
              toggle long kanji display mode.



KKaannjjii SSeeaarrcchh MMooddee
       Kanji Search Mode is entered using the `' command. In this
       mode, keys are entered which match against fields  in  the
       Kanji database.

       The keys are:

       kkaannaa
              (use  the  @  or  #  prefixes  to  key  hiragana or
              katakana.)


       jjxxxxxxxx
              a hex JIS code for a kanji


       jjhhxxxxxxxx
              a hex JIS code for a kanji from the JIS X  212-1990
              supplementary kanji.


       jjkknnnnnnnn
              a numeric kkuutteenn code for a kanji.


       jjkknnnnnnnn
              a  numeric  kkuutteenn  code  for a kanji from the JIS X
              212-1990 supplementary kanji.





UNIX                      September 1998                        5





XJDIC(1)                      XJDIC                      XJDIC(1)


       jjssxxxxxxxx
              a hex Shift-JIS code for a kanji.


       followed by one of the KKAANNJJIIDDIICC codes, such as  Snn,  Bnn,
       Vnnnn, etc.


       mm
              followed by the English "sense" or "meaning" of the
              kanji.


       rr
              to initiate a display of  the  radicals  and  their
              numbers.


       ll
              to enter the multi-radical selection mode.



MMuullttii--RRaaddiiccaall MMooddee
       This  is a sub-mode with the kanji selection mode. Radical
       elements are entered, and the kanji which match that  com-
       bination of elements are either displayed, or their number
       reported.

       The commands in the mode are:

       rr
              display the table of radical elements


       rraaddiiccaall
              add this element to the table.


       ddnn
              remove the nth element from the table.


       ssnn
              restrict the selection to kanji with n strokes


       ss--nn
              restrict the selection to kanji with <= n strokes


       ss++nn
              restrict the selection to kanji with >= n strokes




UNIX                      September 1998                        6





XJDIC(1)                      XJDIC                      XJDIC(1)


       ss00
              remove the kanji stroke restriction.


       cc
              clear the elements in the table


       ll
              force the display of currently matching kanji


       vv kkaannjjii
              display the elements of the specified kanji


       xx
              exit this mode.



CCOONNTTRROOLL FFIILLEE
       Configuration of the XJDIC system is accomplished via  the
       use  of the ..xxjjddiiccrrcc((11)) file, or the file specified in the
       --cc option.

       The control-file contains a  number  of  directives  which
       establish the working dictionaries and files, and also set
       some of the operating modes.

       The control file directives are:

       ffiilltt [SA,CL]
              set up filter details (see the FILTERS  section  in
              the xjdic23.inf file.)


       oommooddee ee//jj//ss [SA,CL]
              set  the  screen output codes to EUC, JIS or Shift-
              JIS


       kkaannaammooddee [SA,CL]
              set the initial default input mode to hiragana


       ddiiccddiirr ppaatthh__nnaammee [SA,SV,CL]
              set the location of the dictionary and data  files.
              The program will try this directory first, followed
              by the local operating directory. Affects all files
              except  the  clipboard and the control file itself.
              Note that this line should occur *before* any  dic-
              file, etc. lines.




UNIX                      September 1998                        7





XJDIC(1)                      XJDIC                      XJDIC(1)


       ddiiccffiillee ppaatthh__nnaammee [SA,SV]
              dictionary name (default: edict)


       kkddiiccffiillee ppaatthh__nnaammee [SA,SV]
              kanji dictionary name (default: kanjidic)


       rroommffiillee ppaatthh__nnaammee [SA,CL]
              romaji conversion file (default: romkana.cnv)


       vveerrbbffiillee ppaatthh__nnaammee [SA,CL]
              conjugation file (default: vconj)


       rraaddffiillee ppaatthh__nnaammee [SA,CL]
              radical/bushu no. file (default: radicals.tm)


       rraaddkkffiillee ppaatthh__nnaammee [SA,CL]
              radical/kanji  file  for  the  multi-radical search
              (default: radkfile)


       jjvveerrbb oonn||ooffff [SA,CL]
              enable or disable the verb de-inflection function


       kkddnnoosshhooww AABBCCDDEE......  [SA,CL]
              declaration of the KANJIDIC fields to be suppressed
              from  the display. For example, "kdnoshow YMQ" will
              prevent the display of the Pin-Yin information  and
              the Four-Corner and Morohashi indices.


       eexxlliisstt aanndd ffrroomm bbuutt ........ ........
              declaration of common words of 3 or more letters to
              be excluded from the XJDXGEN generation of an .xjdx
              file.   There can be more than one "exlist" line in
              the file.


       cclliippffiillee [SA,CL]
              specify the name of a clipboard file to use.


       ggnnuuffiillee [SA,CL]
              specify  the  name  of  GNU  Public  Licence   file
              (default is "gnu_licence".)


       rrvvddiissppllaayy oonn || ooffff [SA,CL]
              specify  the  initial  setting of the reverse video



UNIX                      September 1998                        8





XJDIC(1)                      XJDIC                      XJDIC(1)


              display of matches. (Default is ON)


       Note that some of these are also command-line options.  If
       both  are used, the control-file request takes precedence.


FFIILLEESS
       Apart from the .xjdicrc control file, XXJJDDIICC requires  five
       other files:

       rraaddiiccaallss..ttmm
              the list of bushu numbers and descriptive kanji


       rroommkkaannaa..ccnnvv
              the  list  of  romaji  to  kana  mappings  used  in
              the  input conversion routines.


       vvccoonnjj
              the verb/adjective inflections used to identify the
              dictionary forms of words prior to lookup.


       rraaddkkffiillee
              the   file  of  radicals  used in the multi-radical
              kanji search function, and the kanji matching  each
              radical.


       kkaannjjssttrrookkee
              file   of   kanji    and    their    stroke-counts,
              extracted  from  the kanjidic file.




EENNVVIIRROONNMMEENNTT
       The file ..xxjjddiiccrrcc((11)) defines the locations  of  the  files
       above.   The  programs  all  seek this file in the current
       working directory, the HOME directory, or in the directory
       specified by the XJDIC environment variable.


IINNPPUUTT MMEETTHHOODD
       As  well  as  having  its  own romaji conversion facility,
       XXJJDDIICC can receive Japanese input from IM systems  such  as
       kkiinnppuutt22..


BBUUGGSS
       Any spotted should be sent to the author.




UNIX                      September 1998                        9





XJDIC(1)                      XJDIC                      XJDIC(1)


AAUUTTHHOORR
       Jim Breen <jwb@dgs.monash.edu.au>. This man page initially
       created by William F.  Maton  <wmaton@enterprise.ic.gc.ca>
       with material taken from xjdic23.inf, and extended by Jim.


AACCKKNNOOWWLLEEDDGGMMEENNTTSS
       Many, many people have assisted with xxjjddiicc since it  first
       appeared  as  1.0  in  1992.  They  are  mentioned  in the
       xxjjddiicc2233..iiff file.















































UNIX                      September 1998                       10


