Package: po4a
Version: 0.69-1

We ran into a problem with po4a on LinuxCNC,
<URL: https://github.com/linuxcnc/linuxcnc/ >. The issue is po4a going
into a seemingly endless loop print lines like these:

  Use of uninitialized value $line in scalar chomp at
    /usr/share/perl5/Locale/Po4a/Man.pm line 2344.
  Use of uninitialized value $line in concatenation (.) or string at
    /usr/share/perl5/Locale/Po4a/Man.pm line 2345.
  Use of uninitialized value $line in pattern match (m//) at
    /usr/share/perl5/Locale/Po4a/Man.pm line 2346. 
  Use of uninitialized value $line in pattern match (m//) at
    /usr/share/perl5/Locale/Po4a/Man.pm line 2347.

It was triggered by adding .ie to some generated groff files in
<URL: 
https://github.com/LinuxCNC/linuxcnc/commit/d1414e63eb19f2ebb6c300ea40b4404869c516a3
 >,
causing docs/man/man9/toggle.9 and docs/man/man9/toggle2nist.9 to
confuse po4a.
We have applied a fix by commenting out the files in docs/po4a.cfg.

To trigger the error, just uncomment the lines, touch one of the adoc
files in docs/src/ (for example docs/src/config/ini-config.adoc) and run
'debuild'.

One of the problematic files, toggle.9, look like this:

==========================================================================
.\" -*- mode: troff; coding: utf-8 -*-
.\"*******************************************************************
.\"
.\" This file was extracted from hal/components/toggle.comp using halcompile.g.
.\" Modify the source file.
.\"
.\"*******************************************************************

.TH TOGGLE "9" "2024-07-21" "LinuxCNC Documentation" "HAL Component"
.SH NAME

toggle \- 'push-on, push-off' from momentary pushbuttons
.SH SYNOPSIS
.HP
.B loadrt toggle [count=\fIN\fB|names=\fIname1\fB[,\fIname2...\fB]]
.SH DESCRIPTION


.ie '\*[.T]'html' \{ .HTML <tt> \}
\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u2510]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u250C]\[u2500]\[u2500]\[u2510]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u250C]\[u2500]\[u2500]\[u2510]
.br
in\[u00A0]:\[u00A0]\[u2514]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2518]\[u00A0]\[u00A0]\[u2514]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2518]\[u00A0]\[u00A0]\[u2514]\[u2500]\[u2500]
.br
\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u2510]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u250C]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2510]
.br
out:\[u00A0]\[u2514]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]\[u2518]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u00A0]\[u2514]\[u2500]\[u2500]\[u2500]\[u2500]\[u2500]
.ie '\*[.T]'html' \{ .HTML </tt> \}

.SH FUNCTIONS
.TP
\fBtoggle.\fIN\fB\fR

.SH PINS
.TP
.B toggle.\fIN\fB.in\fR bit in \fR
button input
.TP
.B toggle.\fIN\fB.out\fR bit io \fR
on/off output
.SH PARAMETERS
.TP
.B toggle.\fIN\fB.debounce\fR u32 rw \fR(default: \fI2\fR)
debounce delay in periods
.SH AUTHOR

John Kasunich
.SH LICENSE

GPL
==========================================================================

-- 
Happy hacking
Petter Reinholdtsen

Reply via email to