LOCALE::PO4A::MAN.3PM(1) User Contributed Perl Documentation Locale::Po4a::Man - / PO Po4a (PO For Anything) gettext () Locale::Po4a::Man nroff () [] PO4A::MAN nroff groff nroff POD (Perl Online Documentation) I -- \fItext\fP ".I text" B -- \fBtext\fP ".B text" R -- \fRtext\fP CW -- \f(CWtext\fP ".CW text" groff CW Po4a (-) (\-) PO (-) roff (\-) roff '\[hy]' (latin1 0xA0) roff ('\ ') `` '' \*(lq \*(rq. roff ( '\&' '\&') '<' '>' E E ( POD ) debug verbose groff_code .de.ie .if fail .de.ie .if verbatim .de.ie .if translate .de.ie .if verbatim generated po4a po4a mdoc mdoc po4a 'NAME' mdoc 'NAME' mdoc According to the groff_mdoc page, the NAME, SYNOPSIS and DESCRIPTION sections are mandatory. There are no known issues with translated SYNOPSIS or DESCRIPTION section, but you can also specify these sections this way: -o mdoc=NAME,SYNOPSIS,DESCRIPTION This mdoc issue can also be solved with an addendum like this one: PO4A-HEADER:mode=before;position=^.Dd .TH DOCUMENT_TITLE 1 "Month day, year" OS "Section Name" The following options specify the behavior of a user-defined macro (with a .de request), or of a classical macro that is not supported by po4a. They take as argument a comma-separated list of macros. For example: -o noarg=FO,OB,AR -o translate_joined=BA,ZQ,UX po4a roff po4a untranslated untranslated () noarg noarg untransted po4a translate_joined translate_joined po4a translate_each translate_each no_wrap begin:end begin end end begin no_wrap end ( begin ) begin ( end) end ( fi) begin ( nf) () inline foo <.bar baz qux> quux bar baz qux unknown_macros po4a po4a failed ()untranslatednoargtranslate_joined translate_each () PO4A::MAN nroff nroff po4a man nroff nroff nroff (200) po4a::man po4a::man 250 .. ." .AT .b .bank .BE ..br .Bu .BUGS .BY .ce .dbmmanage .do .En .EP .EX .Fi .hw .i .Id .l .LO .mf .N .na .NF .nh .nl .Nm .ns .NXR .OPTIONS .PB .pp .PR .PRE .PU .REq .RH .rn .S< .sh .SI .splitfont .Sx .T .TF .The .TT .UC .ul .Vb .zZ po4a po4a other other other other po4a groff .if !'po4a'hide' .B other ( -o groff_code=verbatim ) A new macro can also be defined to automate this: .de IR_untranslated . IR \\$@ .. .IR_untranslated \-q ", " \-\-quiet ( -o groff_code=verbatim -o untranslated=IR_untranslated .if !'po4a'hide' po4a ) or using an alias: .als IR_untranslated IR .IR_untranslated \-q ", " \-\-quiet -o untranslated=als,IR_untranslated nroff \c ( 40 ) nroff ( po4a::pod POD SGML XML ) po4a::man POD XMLpo4a::man POD po4a::pod nroff 4323 1432 POD po4a::man po4a::man "bugs" Linux o po4a ( POD SGML) o 10% ( groff ) o 1% po4a () o ( 10% ) Locale::Po4a::Pod(3pm), Locale::Po4a::TransTractor(3pm), po4a(7) Denis Barbier Nicolas Francois Martin Quinson (mquinson#debian.org) (C) 2002-2008 SPI, Inc. This program is free software; you may redistribute it and/or modify it under the terms of GPL v2.0 or later (see the COPYING file). perl v5.42.0 2025-11-22 LOCALE::PO4A::MAN.3PM(1)