openbsd-ports/japanese
2001-03-17 16:09:07 +00:00
..
canna must enclose COMMENT in quotes if it contains shell meta-chars 2001-03-17 16:09:07 +00:00
funetfonts Kill 2000-10-22 15:41:23 +00:00
groff Kill 2000-10-22 15:41:23 +00:00
intlfonts Bye, bye, EXTRACT_CMD, EXTRACT_BEFORE_ARGS, EXTRACT_AFTER_ARGS 2000-12-14 13:22:59 +00:00
jvim Describe available flavors 2000-12-26 23:47:24 +00:00
kakasi ${CONFIGURE_SHARED} + --enable-static 2001-02-18 23:23:31 +00:00
kanjips Fix my address. Dust off details. 2000-10-10 00:40:20 +00:00
kbanner Change Homepage: to WWW: to match other ports. 2001-02-23 10:21:57 +00:00
kinput2 Two more maintainers 2000-10-22 19:01:59 +00:00
kterm Kill 2000-10-22 15:41:23 +00:00
less Kill 2000-10-22 15:41:23 +00:00
nkf Fix my address. Dust off details. 2000-10-10 00:40:20 +00:00
onew-canna LOCALBASE is no longer prefixed with DESTDIR on fake-install, fix. 2001-02-12 11:41:21 +00:00
onew-wnn4 LOCALBASE is no longer prefixed with DESTDIR on fake-install, fix. 2001-02-12 11:41:21 +00:00
onew-wnn4-canna LOCALBASE is no longer prefixed with DESTDIR on fake-install, fix. 2001-02-12 11:41:21 +00:00
Wnn Simplify 2001-03-16 15:42:49 +00:00
Wnn-data Fix my address. Dust off details. 2000-10-10 00:40:20 +00:00
Makefile enable kbanner. 2001-02-13 06:54:58 +00:00
README help japanese beginners make sense of our japanese support 1998-11-22 00:14:51 +00:00

The japanese tools are somewhat ackward to use and difficult to setup
for the time being. Here is some useful information.

* japanese and locale
OpenBSD does not have any true japanese locale support for the time being.
Startup errors for kterm (`can't set locale for ja...') are quite normal.

Manual pages for, e.g., jvim do install under /usr/local/man/ja_JP.EUC/,
as they are written in Japanese.
For the time being, you will have to fix your /etc/man.conf to see them,
so that the _default setup reads:

_default /usr/{share,X11R6,X386,X11,X11R4,contrib,gnu,local}/{man,man/old,man/ja_JP_EUC}/

* is kterm working ?
Not under vanilla 2.4, due to some tinkering with ncurses/termcap.
With the default OpenBSD.cf, kterm links against -ltermcap, where it should
link against -lcurses.
This is fixed in current X11 sources. The fix is to add 
#if defined(TermcapLibrary)
#undef TermcapLibrary
#endif
#define TermcapLibrary   -lcurses
to /usr/X11R6/lib/X11/config/OpenBSD.cf
Once kterm is built, the distribution holds an uuencoded file (DEMO.kt.uu)
that you should be able to cat after uudecoding.
Note that the choice of fonts is reduced when you need to display japanese
or corean characters.

* jless vs. less
Normally, jless should be highly compatible with less, to the point where 
it doesn't display japanese before you set JLESSCHARSET in your
environment. iso8 is the sanest setting.

* the jvim puzzle
jvim depends on several pieces to work correctly:
- kterm for the display, jvim uses ONLY EUC mode,
- Wnn for the dictionary conversion,
- onew for the interface between Wnn and jvim.

as japanese includes thousands of characters, the only reasonable method
for inputting these is to use a dictionary: you enter your text
phonetically, then the automated dictionary makes a guess at the conversion,
and you confirm the right choice. Wnn is the dictionary server.
It needs to be started as root (this will probably be fixed in the future), 
it is called /usr/local/bin/Wnn4/jserver.

To handle conversions, jvim adds another set of modes to the usual vim
modes. 

ctrl-space, ctrl-@, or ctrl-\ is used to toggle from normal insert mode to
japanese inserts. If Wnn does not work, you can still enter
katakana/hiragana, but you will need Wnn to convert them to kanji.