Show page source of User_guide_update #62412

== NVDAユーザーガイドの更新

すでにNVDAパッケージに同梱されているNVDAユーザーガイドを更新します。
 * 日本語のソースコードはuser_docs/ja/userguide.htmlから参照できます。
 * ユーザーガイドのソースはuserguide.t2tで、[http://txt2tags.sourceforge.net/ txt2tags]を使ってHTMLに変換します。

=== revno: 3653

  Updated English user guide with the following changes:
 * object navigation: removed paragraph mentioning that NVDA does not have display hooks, not true anymore.
 * Object navigation: remove mention of nextInFlow/previousInFlow/sayAllObjects scripts, they no longer exist.
 * Review cursor: add paragraph explaining how the review cursor works in virtualBuffers (reviews the entire buffer) and Windows (reviews a flat layout of the window).
 * Saving and Reloading the configuration: changed this section heading to be only two levels deep, not 3 (i.e. its within Configuring NVDA, not Preferences).
 * Saving and reloading the configuration: remove paragraph mentioning nvda.ini.
 * Saving and reloading the configuration: slightly re-wrod paragraph about how NVDA does not automatically ave settings.
 * Added a section within Configuring NVDA called "Configuration files and user profiles" which talks about where NVDA's settings are stored for both the
portable and installed versions.
 * Trouble shooting: added mention that website contains info for email lists and other community resources.

=== revno: 3715
  Large reformat of the English User guide to clean up the way key commands are mentioned, to actually mention laptop key commands, and to allow future
generation of a key commands document from the user guide.
  Specific changes:
 * Converted all existing key command lists in to key command tables. Each key command includes a name, a desktop command, a laptop command, and a description.
 * Added a Basic key commands section within the Getting Started section, which just contains a Basic key commands table summarizing stop speech, pause
speech, NVDA Menu, keyboard help mode, quit NVDA and report date/time.
 * Split the About NVDA key commands section in the Getting Started section in to subsections.
 * Added a Keyboard Layout subsection to the Getting Started section, which mentions the two layouts, and a note about laptops and numberpads.
 * Removed the Forms and focus mode subsection from the Virtual buffers section as it seems quite redundant.
 * Mention Adobe Flash and Google Chrome as using virtual buffers in the Virtual buffers section.
 * Document formatting settings section: converted the comma-separated list of formatting types in to a proper list. Also included landmarks which wasn't
listed previously.
 * Preferences menu section: remove all inline mentions of settings dialog key commands, and instead mention the key command in each respective heading.
 * Moved mention of Move mouse to navigator object and move navigator object to mouse out of the navigating by object section and in to the navigating
with the mouse section.
 * Added a Synth Settings Ring section after Voice settings
 * Added a Review Cursor settings section after the Mouse settings section.

=== revno: 3717
  English User Guide: Add markup to allow the Key Commands document to be generated automatically. Some slight reorganisation was needed in one section
to make this work well. Also fix some typos.

=== revno: 3735
  English User guide: Getting NVDA section: rather than just saying "Here" for the link, say
www.nvda-project.org,
as the previous link would make no sence if it was printed or brailled.

=== revno: 3732
  English User guide: rewrite section about the NVDA modifier key, to make it clear that any of the NVDA modifier keys can be pressed twice quickly to
 produce the original key press.

=== revno: 3734
  English User guide: Major highlights section: do not mention Firefox and IE separately, instead just say Browsing the Web with Mozilla Firefox and Windows
Internet Explorer. Same with email (Thunderbird / Outlook Express / Windows Mail). Remove the word early from IBM lotus Symphony mention.

=== revno: 3733
  English user guide:  pause speech key command description: note that unpausing will only work if the current synthesizer supports pausing. Although not
actually mentioned in the User guide, SAPI5 is one example of where it does not work.

=== revno: 3738
  English user guide:  for  each of the last three options in General settings (to do with startup and logon etc), note that the option is only available
for installed copies of NVDA.

=== revno: 3740
  English user guide: include pass key through script in the basic key commands table.

=== revno: 3741
  English user guide: rewrite the top paragtraph in the Virtual Buffer quick key navigation section, and include it in the key commands quick reference
so that the key commands quick references mentions that the Shift key will move to previous.

=== revno: 3742
  English user guide:  Added commands: refresh, find, find next and find previous, to the first key command table in the Virtual buffers section.

=== revno: 3745
  English User Guide:
	* Rename "Advanced Tools for Developers" to "Extra Tools", as the Speech Viewer isn't just for developers, among other reasons.
	* Remove the detailed info about the Python Console, as it's not really useful to most users (and thus not relevant to the User Guide). Instead, provide
a link to the article on the NVDA web site.
	* Slight change to the mention of the Tools menu.

=== revno: 3750
  English User Guide: Rename "Troubleshooting NVDA" section to "Further Information" and rewrite somewhat to widen its scope and appear less like an excuse
for outdated documentation.

=== revno: 3751

  English User Guide: Getting NVDA: Add note about needing an installed copy to access secure Windows screens.

=== revno: 3754

  English User Guide: Move information about supported braille displays into an appendix. Remove specific mention of English braille codes.

=== revno: 3755
  English User Guide: Just make Supported Braille Displays into a normal numbered section. txt2tags doesn't support appendix numbering and there's no reason
this absolutely must be an appendix anyway.

=== revno: 3756
  English User Guide: Accessing the log file is hardly a particularly important user task.

=== revno: 3757
  English User Guide: Clarify that you need to install NVDA to access apps running as admin as well.

=== revno: 3758
  English User Guide: Handy Tech Braille Displays: Update link for universal driver to version 1.2.0.6a.

=== revno: 3762
  English User Guide: Now that Supported Braille Displays is a numbered heading, number its sub-headings as well.

=== revno: 3766

  English user guide: place a line break between each sentence within paragraphs in the user guide. This will aide trainslators in future as then diffs
will much more clearly show  what sentences have changed. Note that the breaks only appear in the sourc, and not the HTML output.  Paragraphs that act
as descriptions for key commands have not beensplit as  the processing to generate the key commands document only graabs the first line.

=== revno: 3767
  English user guide: Voice Settings section: remove description of Synth Settings Ring scripts, as they are now document in their own section below voice
settings. Instead of that description, just add a sentence linking to the Synth Settings Ring section, mentioning that its a quicker alternative way of
changing speech parameters.

=== revno: 3768
  English user guide: Remove redundant information from the NVDA menu section describing each submenu etc. The top description is more than enough.

=== revno: 3769
  English user guide: add a subsection to the Document Formatting settings section, for the Announce Formatting Changes after the Cursor option. Also change
the word 'All' to 'Most' in the top paragraph of the Document Formatting Settings section, as not 'all' checkboxes are used to configure specific format
types. Also remove the mention of Wordpad and Microsoft Word from the top sentence of the Document Formatting Settings section as formatting is definitly
supported any many other places.

=== revno: 3770
  English user guide: clarify the fact that there is a performance decrease if enabling the Announce formatting changes after the cursor -- Document Formatting
Settings.

=== revno: 3771
  English user guide changes:
  * Move information about each supported synthesizer in to a Supported Speech Synthesizers section just before Supported Braille Displays.
 * Majorly rewrite information about each speech synthesizer. Note: could someone !*please!* contribute some information about the AudioLogic and NewFon
synthesizers, thanks.
 * Synthesizer dialog section: rearrange so that the Synthesizer option is its own subsection, and add a subsection for the Output Device option.

===revno: 3772
  English user guide: remove another sentence I missed about the synth settings ring, from the Voice settings dialog section. Thanks Jamie.

=== revno: 3773
  English user guide: Added small bit of info for the Audiologic speech synthesizer.

=== revno: 3783
  English User Guide: Supported Speech Synthesizers:
 * eSpeak: Remove mention of SAPI runtime, as this won't make sense to most users.
	* SAPI 4/5: There should be a space between SAPI and the number, so add it.
 * SAPI 4: Add link to SAPI 4 runtime binaries.
	* AudioLogic: Rename to Audiologic Tts3, which is the full name of the synth. Also clarify that it must be installed on the system.
	* Add info about Newfon.
	* Other minor fixes.

=== revno: 3784
  English User Guide: Handy Tech Displays: Clarify that only some USB displays need USB drivers installed, as Handy Tech now have some HID displays.

=== revno: 3785
  English User Guide: We seem to have settled on U.S. English somehow, so change "organized" to "organised". <looks disgruntled>

=== revno: 3786
  English User Guide: Preferences: Add an introductory paragraph. Move info about OK and Cancel buttons from the General Settings sub-section to this paragraph,
as it is relevant to all settings dialogs.

=== revno: 3790
  English User Guide: Mention support for Windows Live Mail.

=== revno: 3802
  English User Guide: Newfon: Change link to downloads section of Russian community site.

=== revno: 3803
  English User Guide: Mention that pressing Report title thrice copies to clipboard.

=== revno: 3829
  English User Guide: Don't even mention Windows 2000, as recent user testing seems to indicate that this is now completely broken.

=== revno: 3835
  English User Guide: Remove last update date.
  We always forget to update it, nothing else in NVDA includes a last update date and it just isn't necessary.
  Translators should do this also.