diff --git a/doc/ja/Makefile b/doc/ja/Makefile
new file mode 100644
--- /dev/null
+++ b/doc/ja/Makefile
@@ -0,0 +1,21 @@
+SOURCES=$(wildcard *.[0-9].ja.txt)
+MAN=$(SOURCES:%.txt=%)
+HTML=$(SOURCES:%.txt=%.html)
+
+all: man html
+
+man: $(MAN)
+
+html: $(HTML)
+
+%: %.xml
+ xmlto man $*.xml
+
+%.xml: %.txt
+ -asciidoc -d manpage -b docbook -f docbook.ja.conf $*.txt
+
+%.html: %.txt
+ asciidoc -b html4 $*.txt
+
+clean:
+ $(RM) $(MAN:%.ja=%) $(MAN:%=%.xml) $(MAN:%=%.html)
diff --git a/doc/ja/docbook.ja.conf b/doc/ja/docbook.ja.conf
new file mode 100644
--- /dev/null
+++ b/doc/ja/docbook.ja.conf
@@ -0,0 +1,583 @@
+#
+# docbook.conf
+#
+# Asciidoc configuration file.
+# Modified docbook backend for Japanese.
+#
+
+[miscellaneous]
+outfilesuffix=.xml
+# Printable page width in pts.
+pagewidth=380
+pageunits=pt
+
+[attributes]
+basebackend=docbook
+basebackend-docbook=
+
+[replacements]
+# Line break markup is dropped (there is no DocBook line break tag).
+(?m)^(.*)\s\+$=\1
+# Superscripts.
+\^(.+?)\^=\1
+# Subscripts.
+~(.+?)~=\1
+
+[ruler-blockmacro]
+# Only applies to HTML so don't output anything.
+
+[image-inlinemacro]
+
+
+
+
+ {1={target}}
+
+
+[image-blockmacro]
+
+{title%}
+
+[indexterm-inlinemacro]
+# Inline index term.
+# Generate separate index entries for primary, secondary and tertiary
+# descriptions.
+# Primary only.
+{2%}
+{2%} {1}
+{2%}
+# Primary and secondary.
+{2#}{3%}
+{2#}{3%} {1}{2}
+{2#}{3%}
+{2#}{3%}
+{2#}{3%} {2}
+{2#}{3%}
+# Primary, secondary and tertiary.
+{3#}
+ {1}{2}{3}
+{3#}
+{3#}
+ {2}{3}
+{3#}
+{3#}
+ {3}
+{3#}
+
+[indexterm2-inlinemacro]
+# Inline index term.
+# Single entry index term that is visible in the primary text flow.
+
+ {1}
+
+{1}
+
+[footnote-inlinemacro]
+# Inline footnote.
+{0}
+
+[callout-inlinemacro]
+# Inline callout.
+
+
+[tags]
+# Bulleted, numbered and labeled list tags.
+ilist={title?{title}}|
+ilistitem=|
+ilisttext=|
+olist={title?{title}}|
+olist2=|
+olistitem=|
+olisttext=|
+vlist={title?{title}}|
+vlistentry=|
+vlistterm=|
+vlisttext=|
+vlistitem=|
+# Horizontal labeled list (implemented with two column table).
+# Hardwired column widths to 30%,70% because the current crop of PDF
+# generators do not auto calculate column widths.
+hlist=<{title?table}{title!informaltable}{id? id="{id}"} tabstyle="{style=hlabeledlist}" pgwide="0" frame="none" colsep="0" rowsep="0">{title?
{title}}|<{title?/table}{title!/informaltable}>
+hlistentry=|
+hlisttext=|
+hlistterm=|
+hlistitem=|
+
+# Question and Answer list.
+qlist={title?{title}}|
+qlistentry=|
+qlistterm=|
+qlistitem=|
+qlisttext=|
+# Bibliography list.
+blist=|
+blistitem=|
+blisttext=|
+# Glossary list.
+glist=|
+glistentry=|
+glistterm=|
+glistitem=|
+glisttext=|
+# Callout list.
+colist={title?{title}}|
+colistitem=|
+colisttext=|
+
+# Quoted text
+emphasis=|
+strong=|
+monospaced=|
+quoted={amp}#8220;|{amp}#8221;
+
+# Inline macros
+[http-inlinemacro]
+{0={name}:{target}}
+[https-inlinemacro]
+{0={name}:{target}}
+[ftp-inlinemacro]
+{0={name}:{target}}
+[file-inlinemacro]
+{0={name}:{target}}
+[mailto-inlinemacro]
+{0={target}}
+#{target}
+[link-inlinemacro]
+{0={target}}
+# anchor:id[text]
+[anchor-inlinemacro]
+
+# [[id,text]]
+[anchor2-inlinemacro]
+
+# [[[id]]]
+[anchor3-inlinemacro]
+[{1}]
+# xref:id[text]
+[xref-inlinemacro]
+{0}
+{2%}
+# <>
+[xref2-inlinemacro]
+{2}
+{2%}
+
+
+# Special word macros
+[emphasizedwords]
+{words}
+[monospacedwords]
+{words}
+[strongwords]
+{words}
+
+# Paragraph substitution.
+[paragraph]
+{title}
+{title%}
+|
+{title%}
+{title#}
+{empty}
+
+[admonitionparagraph]
+<{name}{id? id="{id}"}>|{name}>
+
+[literalparagraph]
+# The literal block employs the same markup.
+template::[literalblock]
+
+[verseparagraph]
+template::[verseblock]
+
+# Delimited blocks.
+[literalblock]
+{title}
+
+|
+
+{title#}
+
+[listingblock]
+{title}
+
+|
+
+{title#}
+
+[verseblock]
+{title}
+{title%}
+{title#}
+|
+
+{title#}
+
+[sidebarblock]
+
+{title}
+|
+
+
+[backendblock]
+|
+
+[quoteblock]
+# The epigraph element may be more appropriate than blockquote.
+
+{title}
+
+{attribution}
+{citetitle}
+
+|
+
+
+[exampleblock]
+<{title?example}{title!informalexample}{id? id="{id}"}>
+{title}
+|
+{title?example}{title!informalexample}>
+
+[admonitionblock]
+<{name}{id? id="{id}"}>
+{title}
+|
+{name}>
+
+# Tables.
+[tabledef-default]
+template=table
+colspec=
+bodyrow=|
+bodydata=|
+
+[table]
+<{title?table}{title!informaltable}{id? id="{id}"} pgwide="0"
+frame="{frame=topbot}"
+{grid%rowsep="0" colsep="0"}
+{eval:\{"none":"rowsep=\"0\" colsep=\"0\"", "cols":"rowsep=\"0\" colsep=\"1\"", "all":"rowsep=\"1\" colsep=\"1\"", "rows":"rowsep=\"1\" colsep=\"0\"" \}["{grid}"]}
+>
+{title}
+
+{colspecs}
+{headrows#}
+{headrows}
+{headrows#}
+{footrows#}
+{footrows}
+{footrows#}
+
+{bodyrows}
+
+
+{title?table}{title!informaltable}>
+
+[specialsections]
+ifdef::doctype-article[]
+^Abstract$=sect-abstract
+endif::doctype-article[]
+
+ifdef::doctype-book[]
+^Colophon$=sect-colophon
+^Dedication$=sect-dedication
+^Preface$=sect-preface
+endif::doctype-book[]
+
+^Index$=sect-index
+^(Bibliography|References)$=sect-bibliography
+^Glossary$=sect-glossary
+^Appendix [A-Z][:.](?P.*)$=sect-appendix
+
+# Special sections.
+[sect-preface]
+
+{title}
+|
+
+
+[sect-index]
+
+{title}
+|
+
+
+[sect-bibliography]
+
+{title}
+|
+
+
+[sect-glossary]
+
+{title}
+|
+
+
+[sect-appendix]
+
+{title}
+|
+
+
+
+[header-declarations]
+
+
+
+#-------------------------
+# article document type
+#-------------------------
+ifdef::doctype-article[]
+
+[header]
+template::[header-declarations]
+
+
+{doctitle#}
+ {doctitle}
+ {date}
+ {authored#}
+ {firstname}
+ {middlename}
+ {lastname}
+ {email}
+ {authored#}
+
+# If file named like source document with -revhistory.xml suffix exists
+# include it as the document history, otherwise use current revision.
+{revisionhistory#}{include:{docdir}/{docname}-revhistory.xml}
+{revisionhistory%}{revision}{date}{revremark?{revremark}}
+
+ {companyname}
+{doctitle#}
+
+[footer]
+
+
+[preamble]
+# Untitled elements between header and first section title.
+|
+
+[sect-abstract]
+
+|
+
+
+[sect1]
+
+
+[sect2]
+
+
+[sect3]
+
+
+[sect4]
+
+
+endif::doctype-article[]
+
+#-------------------------
+# manpage document type
+#-------------------------
+ifdef::doctype-manpage[]
+
+[replacements]
+# The roff format does not substitute special characters so just print them as
+# text.
+\(C\)=(C)
+\(TM\)=(TM)
+
+[header]
+template::[header-declarations]
+
+
+{mantitle}
+{manvolnum}
+
+
+ {manname}
+ {manpurpose}
+
+
+[footer]
+
+
+# Section macros
+[sect-synopsis]
+
+|
+
+
+[sect1]
+
+{title}
+|
+
+
+[sect2]
+
+{title}
+|
+
+
+[sect3]
+
+{title}
+|
+
+
+endif::doctype-manpage[]
+
+#-------------------------
+# book document type
+#-------------------------
+ifdef::doctype-book[]
+
+[header]
+template::[header-declarations]
+
+
+{doctitle#}
+ {doctitle}
+ {date}
+ {authored#}
+ {firstname}
+ {middlename}
+ {lastname}
+ {email}
+ {authored#}
+
+# If file named like source document with -revhistory.xml suffix exists
+# include it as the document history, otherwise use current revision.
+{revisionhistory#}{include:{docdir}/{docname}-revhistory.xml}
+{revisionhistory%}{revision}{date}{revremark?{revremark}}
+
+ {companyname}
+{doctitle#}
+
+[footer]
+
+
+[preamble]
+# Preamble is not allowed in DocBook book so wrap it in a preface.
+
+Preface
+|
+
+
+[sect-dedication]
+
+|
+
+
+[sect-colophon]
+
+|
+
+
+[sect0]
+
+{title}
+|
+
+
+[sect1]
+
+{title}
+|
+
+
+[sect2]
+
+
+[sect3]
+
+
+[sect4]
+
+
+endif::doctype-book[]
+
+ifdef::sgml[]
+#
+# Optional DocBook SGML.
+#
+# Most of the differences between DocBook XML and DocBook SGML boils
+# down to the empty element syntax: SGML does not like the XML empty
+# element <.../> syntax, use <...> instead.
+#
+[miscellaneous]
+outfilesuffix=.sgml
+
+[header-declarations]
+
+
+[tabledef-default]
+colspec=
+
+[image-inlinemacro]
+
+
+
+
+ {1={target}}
+
+
+[image-blockmacro]
+
+{title%}
+
+# Inline macros
+[xref-inlinemacro]
+{0}
+{2%}
+[xref2-inlinemacro]
+# <>
+{2}
+{2%}
+[anchor-inlinemacro]
+
+[anchor2-inlinemacro]
+# [[id,text]]
+
+
+endif::sgml[]
diff --git a/doc/ja/hg.1.ja.txt b/doc/ja/hg.1.ja.txt
new file mode 100644
--- /dev/null
+++ b/doc/ja/hg.1.ja.txt
@@ -0,0 +1,867 @@
+HG(1)
+=====
+Matt Mackall
+
+??????
+--
+hg - Mercurial ????????????????????????????????????
+
+??????
+--
+'hg' [-v -d -q -y] [command options] [files]
+
+??????
+--
+hg(1) ??????????????? Mercurial ?????????????????????????????????????????????????????????
+???????????????????????????
+
+???????????????
+----
+
+-R, --repository::
+ ??????????????????????????????????????????????????????????????????
+
+--cwd::
+ ?????????????????????????????????????????????
+
+-y, --noninteractive::
+ ??????????????????????????????????????????????????????????????? 'yes' ??????????????????
+ ????????????
+
+-q, --quiet::
+ ???????????????????????????
+
+-v, --verbose::
+ ??????????????????????????????????????????
+
+7--debug::
+ ??????????????????????????????????????????
+
+--traceback::
+ ??????????????????????????????????????????????????????
+
+--time::
+ ????????????????????????????????????????????????????????????????????????
+
+--profile::
+ ???????????????????????????????????????????????????????????????????????????
+
+--version::
+ ??????????????????????????????????????????????????????
+
+-h, --help::
+ ??????????????????????????????????????????
+
+?????????????????????
+-------
+
+files ...::
+ 1???????????????????????????????????????????????????????????????; ????????????????????????
+ ?????????????????????????????????????????????????????????????????????????????????
+
+path::
+ ????????????????????????????????????????????????
+
+revision::
+ ???????????????????????????????????????????????????, ??????, ??????????????????????????????
+ ?????????????????????????????????????????????????????????????????????????????????????????????
+ ?????????
+
+repository path::
+ ?????????????????????????????????????????????????????????????????????????????? URI ??????
+ ????????????URI ???????????????????????????????????? 2 ???????????????????????????
+ http:// ???????????????old-http:// ????????????????????????????????????????????????
+ ???????????????????????????????????????
+
+????????????
+----
+
+add [options] [files ...]::
+ ?????????????????????????????????????????????????????????????????????????????????????????????
+ ????????????
+
+ ??????????????????????????????????????????????????????????????????????????????
+
+ ?????????????????????????????????????????????????????????????????????????????????????????????
+ ???????????????????????????????????????????????????
+
+addremove [options] [files ...]::
+ ?????????????????????????????????????????????????????????????????????????????????????????????
+ ????????????????????????
+
+ ???????????????????????? .hgignore ???????????????????????????????????????????????????
+ ????????????add ???????????????????????????????????????????????????????????????????????????
+
+annotate [-r -u -n -c] [files ...]::
+ ?????????????????????????????????????????????????????????????????????????????? id ?????????
+ ????????????
+
+ ?????????????????????????????????????????????????????????????????????????????????????????????
+ ???????????????????????????
+
+ -a ??????????????????????????????annotate ?????????????????????????????????????????????
+ ??????????????????????????????????????????-a ???????????????annotate ??????????????????
+ ??????????????????????????????????????????????????????????????????????????????
+
+ ???????????????:
+ -a, --text ?????????????????????????????????????????????????????????
+ -I, --include ????????????????????????????????????????????????????????????
+ ??????
+ -X, --exclude ????????????????????????????????????????????????????????????
+ ?????????
+ -r, --revision ?????????????????????????????????????????????????????????
+ -u, --user ????????????????????????
+ -c, --changeset ???????????????????????????????????????
+ -n, --number ?????????????????????????????????????????????
+ (???????????????)
+
+bundle ::
+ (?????????)
+
+ ????????????????????????????????????????????????????????????????????????????????????????????????
+ ?????????????????????????????????????????????????????????????????????
+
+ ?????????????????????????????????????????????????????????????????????????????????????????????
+ unbundle ????????????????????????????????????????????? push ??? pull ????????????
+ ?????????????????????????????????????????????????????????????????????????????????????????????
+ ????????????????????????????????????????????????????????? ".hg" ?????????
+
+ import/export ???????????????????????????????????????????????????????????????????????????
+ ?????????????????????????????????????????????????????????????????????????????????????????????
+
+cat [options] ::
+ ?????????????????????????????????????????????????????????????????????????????????????????????
+ ???????????????????????????????????????????????? tip ?????????????????????
+
+ ?????????????????????????????????????????????????????????????????????????????????????????????
+ ??????????????????????????????????????????????????????????????????????????? export ??????
+ ????????????????????????????????????????????????????????????????????????
+
+ %s ??????????????????????????????????????????
+ %d ????????????????????????????????????????????????????????????????????????????????????
+ ?????????????????? "."
+ %p ????????????????????????????????????????????????????????????
+
+ ???????????????:
+ -I, --include ???????????????????????????????????????????????????
+ ???????????????
+ -X, --exclude ???????????????????????????????????????????????????
+ ??????????????????
+ -o, --output ???????????????????????????????????????????????????
+ ???
+ -r, --rev ????????????????????????????????????????????????
+
+clone [-U]