[Po4a-commits] "po4a/lib/Locale/Po4a Man.pm,1.128,1.129"
Nicolas FRANCOIS
nekral-guest at alioth.debian.org
Thu Mar 16 21:24:57 UTC 2006
Update of /cvsroot/po4a/po4a/lib/Locale/Po4a
In directory haydn:/tmp/cvs-serv3791/lib/Locale/Po4a
Modified Files:
Man.pm
Log Message:
The Man module is no more beta. Update the statistics.
Index: Man.pm
===================================================================
RCS file: /cvsroot/po4a/po4a/lib/Locale/Po4a/Man.pm,v
retrieving revision 1.128
retrieving revision 1.129
diff -u -d -r1.128 -r1.129
--- Man.pm 9 Mar 2006 21:15:37 -0000 1.128
+++ Man.pm 16 Mar 2006 21:24:54 -0000 1.129
@@ -285,48 +285,34 @@
=head1 STATUS OF THIS MODULE
-I think that this module is still beta, but could be used for most of the
-existing man pages. I ran some test, processing all pages of my box and
-diff'ing between the original and the version processed trough po4a. The
-results are the following:
+This module can be used for most of the existing man pages.
- # of pages : 5060
+Some tests are regularly run on Linux boxes:
- Ignored pages : 1742 (34%)
- parser fails : 530 (12% of all; 18% of unignored)
+=over 4
- works perfectly : 1947 (39% of all; 59% of unignored; 70% of processed)
- change wrapping : 409 ( 8% of all; 12% of unignored; 15% of processed)
- change wrapping
- and/or font : 364 ( 7% of all; 11% of unignored; 13% of processed)
+=item *
- undetected problems: 68 ( 1% of all; 2% of unignored; 2% of processed)
+one third of the pages are refused because they were generated from
+another format suported by po4a (e.g. pod or SGML).
-Ignored pages are so, because they are not the source files. They are for
-example generated from POD or SGML. In that case, you should translate the
-[real] source file with the relevant po4a module instead of the generated
-man page.
+=item *
-Parser fails on pages based on mdoc(7), pages using conditionals with .if,
-defining new macros with .de, using non standard fonts, and more generally,
-not following the advices of the previous section.
+10% of the remaining pages are rejected with an error (e.g. mdoc pages,
+groff macro not supported).
-Pages with undetected problems are processed without complain by po4a::man,
-but the generated output is different from the original one (some strings
-are present in the original page and not in the one normalized by po4a, or
-the contrary). All of them are bugs, but most of the time this exhibit
-issues in the original page.
+=item *
-Most of the pages in the "change wrapping and/or font" category will only
-have their wrapping changed (but it was too difficult to figure this out
-automatically), or have other more serious formatting change (ie, which
-chars are italics, which ones are bold, etc.).
+Then, less than 1% of the pages are accepted silently by po4a, but with
+significant issues (i.e. missing words, or new words inserted)
-So, it seems like since ignored pages are translatable with po4a::pod and
-since wrapping changes are acceptable in most cases, the current version
-of po4a can translate 80% of the man pages on my machine. Moreover, most of
-the untranslatable pages could be fixed with some simple tricks given
-above. Isn't that coooool?
+=item *
+
+The other pages are usually handled without differences more important
+than spacing differences or line rewrapped (font issues in less than 10% of
+the processed pages).
+
+=back
=head1 SEE ALSO
More information about the Po4a-commits
mailing list