diff options
| -rw-r--r-- | .gitignore | 5 | ||||
| -rw-r--r-- | HACKING | 8 | ||||
| -rw-r--r-- | Makefile.am | 3 | ||||
| -rw-r--r-- | README | 2 | ||||
| -rw-r--r-- | configure.ac | 6 | ||||
| -rw-r--r-- | po-docs/Makefile.am | 88 | ||||
| -rw-r--r-- | po-docs/ja.po | 28 | ||||
| -rw-r--r-- | po-docs/ja/Makefile.am | 94 | ||||
| -rw-r--r-- | po-docs/libguestfs-docs.pot | 21 |
9 files changed, 253 insertions, 2 deletions
@@ -197,6 +197,11 @@ po/en@quot.header po/insert-header.sin po/quot.sed po/remove-potcdate.sin +po-docs/po4a.conf +po-docs/*/*.pl +po-docs/*/*.pod +po-docs/*/*.1 +po-docs/*/*.3 python/bindtests.py python/guestfs.py python/guestfs-py.c @@ -116,7 +116,13 @@ ocaml/ OCaml bindings. po/ - Translations. + Translations of simple gettext strings. For translations of + longer documents, see po-docs/. + +po-docs/ + The build infrastructure and PO files for translations of + manpages and POD files. Eventually this will be combined + with the po/ directory, but that is rather complicated. perl/ Perl bindings. diff --git a/Makefile.am b/Makefile.am index a33c91c3..085202b5 100644 --- a/Makefile.am +++ b/Makefile.am @@ -20,7 +20,7 @@ include $(top_srcdir)/subdir-rules.mk ACLOCAL_AMFLAGS = -I m4 # Basic source for the library. -SUBDIRS = gnulib/lib images src examples po +SUBDIRS = gnulib/lib images src examples po po-docs if ENABLE_DAEMON SUBDIRS += daemon @@ -181,6 +181,7 @@ all-local: grep -v '/guestfs_protocol.c' | \ grep -v '/rc_protocol.c' | \ grep -v 'appliance/debian/root' | \ + grep -v '^po-docs/' | \ LC_ALL=C sort | \ sed 's,^\./,,' > po/POTFILES.in @@ -94,6 +94,8 @@ in virt-inspector). - (Optional, but highly recommended) perl-libintl for translating perl code. +- (Optional) po4a for translating manpages and POD files. + Running ./configure will check you have all the requirements installed on your machine. diff --git a/configure.ac b/configure.ac index acc1f885..935abdc7 100644 --- a/configure.ac +++ b/configure.ac @@ -768,6 +768,10 @@ AM_CONDITIONAL([HAVE_INSPECTOR], AM_CONDITIONAL([HAVE_TOOLS], [test "x$PERL" != "xno" -a "x$missing_perl_modules" != "xyes"]) +dnl po4a for translating man pages and POD files (optional). +AC_CHECK_PROG([PO4A],[po4a],[po4a],[no]) +AM_CONDITIONAL([HAVE_PO4A], [test "x$PO4A" != "xno"]) + dnl Library versioning. MAX_PROC_NR=`cat $srcdir/src/MAX_PROC_NR` AC_SUBST(MAX_PROC_NR) @@ -802,6 +806,8 @@ AC_CONFIG_FILES([Makefile gnulib/lib/Makefile gnulib/tests/Makefile fuse/Makefile + po-docs/Makefile + po-docs/ja/Makefile ocaml/META perl/Makefile.PL]) AC_OUTPUT diff --git a/po-docs/Makefile.am b/po-docs/Makefile.am new file mode 100644 index 00000000..ebb80c02 --- /dev/null +++ b/po-docs/Makefile.am @@ -0,0 +1,88 @@ +# libguestfs translations of man pages and POD files +# Copyright (C) 2010 Red Hat Inc. +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + +# XXX The use of po4a is naive here. Also we should integrate this +# into the po/ directory and the translations into the usual +# libguestfs.pot file. + +# Languages. +LINGUAS = ja + +EXTRA_DIST = \ + libguestfs-docs.pot \ + $(LINGUAS:%=%.po) + +CLEANFILES = po4a.conf + +# Build the final man pages from the translated POD files. Each +# language directory contains a Makefile.am that we need to keep up to +# date (note each $lang/Makefile.am should be identical). +# XXX Is there a better way? +SUBDIRS = $(LINGUAS) + +# List of english POD sources which can be translated. +# Perl files count as POD as far as po4a is concerned. +PODFILES = \ + ../src/guestfs.pod \ + ../src/guestfs-actions.pod \ + ../src/guestfs-availability.pod \ + ../src/guestfs-structs.pod \ + ../fish/guestfish.pod \ + ../fish/guestfish-actions.pod \ + ../test-tool/libguestfs-test-tool.pod \ + ../fuse/guestmount.pod \ + ../inspector/virt-inspector.pl \ + $(wildcard ../tools/virt-*.pl) + +if HAVE_PO4A +update-po: libguestfs-docs.pot +else +update-po: +endif + +if HAVE_PO4A + +# Note: po4a leaves empty '=encoding' lines in POD files. Also it +# includes a large warning message which ends up in the output. We +# post-process the output to remove both. +libguestfs-docs.pot: po4a.conf + $(PO4A) \ + -M utf-8 -L utf-8 -A utf-8 \ + -v \ + -k 0 \ + --package-name $(PACKAGE_NAME) \ + --package-version $(PACKAGE_VERSION) \ + --msgid-bugs-address libguestfs@redhat.com \ + --copyright-holder "Red Hat Inc." \ + po4a.conf + for f in `find $(LINGUAS) -name '*.pod' -o -name '*.pl'`; do \ + awk 'FNR >= 14 { print }' < $$f > $$f.new; \ + mv $$f.new $$f; \ + done + +po4a.conf: $(PODFILES) + rm -f $@-t + echo "[po_directory] ." >> $@-t + echo >> $@-t + for f in $(PODFILES); do \ + b=`basename -- $$f`; \ + echo "[type: pod] $$f \$$lang:\$$lang/$$b" >> $@-t; \ + echo >> $@-t; \ + done; + mv $@-t $@ + +endif diff --git a/po-docs/ja.po b/po-docs/ja.po new file mode 100644 index 00000000..9b313912 --- /dev/null +++ b/po-docs/ja.po @@ -0,0 +1,28 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) YEAR Free Software Foundation, Inc. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"Report-Msgid-Bugs-To: libguestfs@redhat.com\n" +"POT-Creation-Date: 2010-09-02 14:43+0200\n" +"PO-Revision-Date: 2010-09-02 14:46+0100\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +# type: =head1 +#: ../src/guestfs.pod:3 ../fish/guestfish.pod:3 +#: ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3 +#: ../inspector/virt-inspector.pl:38 ../tools/virt-cat.pl:32 +#: ../tools/virt-df.pl:34 ../tools/virt-edit.pl:33 +#: ../tools/virt-list-filesystems.pl:30 ../tools/virt-list-partitions.pl:30 +#: ../tools/virt-ls.pl:33 ../tools/virt-make-fs.pl:35 +#: ../tools/virt-rescue.pl:31 ../tools/virt-resize.pl:40 +#: ../tools/virt-tar.pl:32 ../tools/virt-win-reg.pl:36 +msgid "NAME" +msgstr "名前" diff --git a/po-docs/ja/Makefile.am b/po-docs/ja/Makefile.am new file mode 100644 index 00000000..e088ebbe --- /dev/null +++ b/po-docs/ja/Makefile.am @@ -0,0 +1,94 @@ +# libguestfs translations of man pages and POD files +# Copyright (C) 2010 Red Hat Inc. +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 2 of the License, or +# (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with this program; if not, write to the Free Software +# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. + +# Note that each Makefile.am in po-docs/$lang/Makefile.am should be +# identical. If you create a new $lang.po, create the $lang/ +# subdirectory and copy the Makefile.am from an existing language. + +LINGUA = $(shell basename -- `pwd`) + +CLEANFILES = *.1 *.3 + +# Ship the final translated manpages in the tarball. +MANPAGES = \ + guestfs.3 \ + guestfish.1 \ + libguestfs-test-tool.1 \ + guestmount.1 \ + $(patsubst %.pl,%.1,$(wildcard virt-*.pl)) + +EXTRA_DIST = $(MANPAGES) + +all-local: $(MANPAGES) + +guestfs.3: guestfs.pod guestfs-actions.pod guestfs-availability.pod guestfs-structs.pod + sed \ + -e '/@ACTIONS@/rguestfs-actions.pod' \ + -e 's/@ACTIONS@//' \ + -e '/@AVAILABILITY@/rguestfs-availability.pod' \ + -e 's/@AVAILABILITY@//' \ + -e '/@STRUCTS@/rguestfs-structs.pod' \ + -e 's/@STRUCTS@//' \ + < $< | \ + $(POD2MAN) -u \ + --section 3 \ + -c "Virtualization Support" \ + --name "guestfs" \ + --release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \ + > $@-t; mv $@-t $@ + +guestfish.1: guestfish.pod guestfish-actions.pod + sed \ + -e '/@ACTIONS@/rguestfish-actions.pod' -e 's/@ACTIONS@//' \ + < $< | \ + $(POD2MAN) -u \ + --section 1 \ + -c "Virtualization Support" \ + --name "guestfish" \ + --release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \ + > $@-t; mv $@-t $@ + +guestmount.1: guestmount.pod + $(POD2MAN) -u \ + --section 1 \ + -c "Virtualization Support" \ + --name "guestmount" \ + --release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \ + $< > $@-t; mv $@-t $@ + +libguestfs-test-tool.1: libguestfs-test-tool.pod + $(POD2MAN) -u \ + --section 1 \ + -c "Virtualization Support" \ + --release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \ + $< > $@-t; mv $@-t $@ + +virt-%.1: virt-%.pl + $(POD2MAN) -u \ + --section 1 \ + -c "Virtualization Support" \ + --release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \ + $< > $@-t && mv $@-t $@ + +# XXX Can automake do this properly? +install-data-hook: + $(MKDIR_P) $(DESTDIR)$(mandir)/$(LINGUA)/man1 + $(INSTALL) -m 0644 guestfish.1 $(DESTDIR)$(mandir)/$(LINGUA)/man1 + $(INSTALL) -m 0644 guestmount.1 $(DESTDIR)$(mandir)/$(LINGUA)/man1 + $(INSTALL) -m 0644 virt-*.1 $(DESTDIR)$(mandir)/$(LINGUA)/man1 + $(MKDIR_P) $(DESTDIR)$(mandir)/$(LINGUA)/man3 + $(INSTALL) -m 0644 guestfs.3 $(DESTDIR)$(mandir)/$(LINGUA)/man3 diff --git a/po-docs/libguestfs-docs.pot b/po-docs/libguestfs-docs.pot new file mode 100644 index 00000000..04ffac2c --- /dev/null +++ b/po-docs/libguestfs-docs.pot @@ -0,0 +1,21 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Red Hat Inc. +# This file is distributed under the same license as the libguestfs package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: libguestfs 1.5.7\n" +"Report-Msgid-Bugs-To: libguestfs@redhat.com\n" +"POT-Creation-Date: 2010-09-02 14:43+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=CHARSET\n" +"Content-Transfer-Encoding: ENCODING" + +# type: =head1 +msgid "NAME" +msgstr "" |