readmejp of 2012.2jp (English)


%!includeconf: ../userGuide.t2tconf

- last update: 2012-06-15
- updated by: Takuya Nishimoto (nishimotz atmark, Twitter @nishimotz)

= Table of Contents =[toc]

+ NVDAJP Release Notes +

Release by NVDA Japanese Team (nvdajp), based on NVDA 2012.2.1 from

This release is Japanese localization of the NVDA open-source screen reader for Windows.

++ Changes from original NVDA ++

+++ Japanese Keyboard +++

- CapsLock key of Japanese keyboard cannot be used as NVDA modifier key. This is the limitation of the Windows device driver.
- NonConvert key of Japanese keyboard can be used as NVDA modifier key.
- Japanese translations added for Input Help Mode: "IME Non convert", "IME Convert", "Pause".

+++ Input Method +++

- Japanese input method editor (IME) support (for 32bit/64bit environment) is added. Some applicaitions are not fully supported. 
- Key events of enabling or disabling IME are reporeted in Japanese message.
- Typing within composition window is reported.
- After pressing space bar (as IME conversion command), first candidate is reported using character description table.
- Pressing space bar (as candidate selection command), selected candidate is also reported.
- Pressing enter key (as IME session end command), the result string is reported.
- Input method is reported, even if 'Speak Typed Characters' setting is disabled.

Keyboard Settings:

- Support IME: If enabled, IME is supported. When changing, the setting must be saved and NVDA must be restarted.
- Beep if IME mode is changed: If enabled, key events of enabling or disabling IME are reported with beep.
- Reading at IME session end: If enabled, result string is reported at IME session end.
- Discriminant reading: If enabled, candidate is reported using character description table.
- Phonetic representation reading: If enabled, Kana characters are reported using phonetic representation.

For example, Kana characters 'ta' 'su' 'ke' 'ru' are converted to Kanji character 'help' and Kana Characters 'ke' 'ru'.

- Kanji 'help' is reported as 'suke' (spelling output) or 'tasukeru no jo' (discriminant reading output).
- Kana 'ke' is reported as 'ke' (spelling output) or 'keshiki no ke' (phonetic output).
- Kana 'ru' is reported as 'ru' (spelling output) or 'rusuban no ru' (phonetic output).

Note that 'tasukeru' is the meaning of Kanji character 'help', and 'keshiki' (scenery) or 'rusuban' (house keeping) are intelligible words to show the character 'ke' or 'ru'.

In this case, the options work as follows:

- Discriminant off + Phonetic off : 'suke' 'ke' 'ru'
- Discriminant on  + Phonetic off : 'tasukeru no jo' 'ke' 'ru'
- Discriminant on  + Phonetic on  : 'tasukeru no jo' 'keshiki no ke' 'rusuban no ru'

+++ Character Desription +++

- Japanese default table for character description is updated. The new table will be merged to the NV Access version.
- Character description of nvdajp can be customized. If characterDescriptions-(locale).dic file is found in userConfig file, it supersedes built-in dictionary.

+++ Speech Driver Support +++

JTalk driver:

- Japanese Text-to-Speech engine JTalk is added (based on Open JTalk, MMDAgent, Mecab project)
- JTalk (Japanese TTS) has M001, Lite, and Mei voices. 
- M001 and Lite are male voices. Mei is female voice. 
- M001 and Mei are at sampling rate of 48kHz. Lite is at sampling rate of 16kHz. 
- Speed, Volume, Pitch, Inflection can be changed.
- Rate boost option is available.
- 'Capital pitch change percentage' (capPitchChange) is supported.
- 'Automatic Language switching' is not supported.
- 'Automatic Dialect switching' is not supported.
- If the voice spelling functionarity is used, speech rate is changed to default.

JTalk2 experimental driver: 

- 'Automatic Language switching' is supported. language switching among Japanese and other languages, which are supported by eSpeak.

Haruka (MS Speech Platform) driver: 

- Haruka (MSSP) driver is customized version of original MSSP driver. It contains the workaround for spelling functionarity of Japanese voice.

+++ Braille Display Support +++

- "Braille Viewer" is added in Tools menu. Available for Japanese language. It uses braille Unicode font. For Windows XP, the braille font is available if LibreOffice or is installed.
- Braille code table "Japanese by NVDAJP" is added. It uses MeCab to process Japanese text. This table can be used with all braille display drivers.
- KGS braille display driver is added. A version which enables manual COM port selection (KGS2) is also provided. 
- KGS Braille Memo BM46 is used for development.
- DirectBM driver is legacy and experimental. It does not work on Windows x64. We may discontinue the support in the future.

+++ Miscellaneous Changes +++

- Application icon is changed to the NVDAJP Telescope Goldfish.
- AppModules for Search Aid, VoicePopper and WinAltair (popular self-voicing applications in Japan) are added.
- Report Time (NVDA+f12) is modified for Japanese environment.
- Help documents are opened by HTML application (HTA) window, not the system's default web browser. This is because Japanese popular voice web browser for screen reader users is difficult to use with NVDA.
- Update Check is disabled. Default setting of update-autoCheck is changed to false.

++ Developer Guide ++

We use as bazaar source-code repository.

- project site:
- site:

Repositories are as follows:
- lp:~nvdajp/nvdajp/jp2012.2
- lp:~nvdajp/nvdajp/MiscellaneousDependencies rev 83