Our Manuals are written in DocBook and we generate HTML and CHM manuals for distributing.

We have currently manuals in the following languages:

• English
• Japanese

• Official DocBook homepage
• DocBook Wiki

The user's manual is XML, so you can use XML editor or your favourite text editor.

Note that XML requires document to be well formed, unlike HTML, before it can be processed.

See these tutorials for editing DocBook:

• NewbieDoc DocBook guide
• Customising HTML output with DSSL
• Customising print formats with DSSL
• DocBook XSL: The Complete Guide

• {LANG}\_Copyrights.xml Update copyright information’s
• {LANG}\_VersionNumbers.xml Update WinMerge version number and Manual revision
• {LANG}\xsl\html.xsl Update WinMerge version number at parameter headtitle.suffix

The translation of the manual is managed using PO files, similar to the WinMerge program. We use po4a for extracting the translatable text from the English XML files and applying the translations back to the translated XML files. To update the various translation-related files after editing the English XML files or PO files, please install po4a.

Install MSYS2 in C:\msys64 or D:\msys64, and in the launched terminal, install po4a and diffutils as follows:

pacman -S po4a diffutils

Our preferred build system uses the following tools:

• xsltproc
• DocBook DTD
• XSL StyleSheets
• HTML Help Compiler

The easiest way is to download our manual build tools package v2. The package contains required tools for manual building.

Installing the tools is easy - just unzip the tools package to folder \Docs\Manual\Tools.

The batch files are located at the \Docs\Manual folder.

Every language has his one batch files. Paths to the installed tools are written in the configuration.bat file.

• build_html_en.bat
  Creates the English HTML files without ads under the folder \Build\Manual\html-en.

• build_html_en.bat withads
  Creates the English HTML files with ads under the folder \Build\Manual\html-en.

• build_htmlhelp_en.bat
  Creates the English CHM file under the folder Build\Manual\htmlhelp.

• update_translations.bat
  Extract translatable text from English XML files and apply translations back to the translated XML files.

The Japanese batch files ends with _jp for example.