`perldoc` does not work inside container

[KES777]

Description
I want to see some documentation, but perldoc can not find one of required modules though perl -MPod::Text -e 0 works.

Steps to Reproduce

FROM ubuntu:latest

# Prevent interactive prompts during apt install
ENV DEBIAN_FRONTEND=noninteractive

# Install basic deps
RUN apt-get update && apt-get install -y \
    curl git ca-certificates bash \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

# Install nvm
ENV NVM_DIR=/root/.nvm
RUN mkdir -p $NVM_DIR
SHELL ["/bin/bash", "-c"]
RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Install latest Node.js via nvm and make it default
RUN source $NVM_DIR/nvm.sh && \
    nvm install node && \
    nvm alias default node && \
    nvm install-latest-npm

# Install Codex CLI globally
RUN source $NVM_DIR/nvm.sh && \
    npm install -g @openai/codex

# Install perl
RUN \curl -L https://install.perlbrew.pl | bash

RUN cat << EOF >> $HOME/.bashrc
if [ -f ~/perl5/perlbrew/etc/bashrc ]; then
  source ~/perl5/perlbrew/etc/bashrc
  source ~/perl5/perlbrew/etc/perlbrew-completion.bash
  alias pb="perlbrew"
  complete -F _perlbrew_compgen pb
fi
EOF

RUN apt-get update && apt-get install -y build-essential

RUN source ~/perl5/perlbrew/etc/bashrc && perlbrew install perl-5.42.0 --switch \
	|| cat /root/perl5/perlbrew/build.perl-5.42.0.log


# Set working dir inside container
WORKDIR /app

# Default command
CMD ["/bin/bash"]

docker build --progress=plain -t codex-cli .
docker run -it --rm -v ./codex/auth.json:/root/.codex/auth.json -v ./codex/config.toml:/root/.codex/config.toml -v ./img:/app codex-cli

root@244a9d552a97:/app# perldoc Mojolicious::Controller
Can't find any loadable formatter class in Pod::Perldoc::Totext Pod::Perldoc::Totext Pod::Perldoc::ToText Pod::Perldoc::ToTEXT Pod::Simple::text Pod::Simple::text Pod::Simple::Text Pod::Simple::TEXT Pod::text Pod::text Pod::Text Pod::TEXT Pod::Perldoc::ToPod?!
Aborting
 at /root/perl5/perlbrew/perls/perl-5.42.0/bin/perldoc line 13.

root@244a9d552a97:/app# which perldoc 
/root/perl5/perlbrew/perls/perl-5.42.0/bin/perldoc

root@244a9d552a97:/app# perl -I local-lib/lib/perl5/ $(which perldoc) Mojolicious::Controller
Can't find any loadable formatter class in Pod::Perldoc::Totext Pod::Perldoc::Totext Pod::Perldoc::ToText Pod::Perldoc::ToTEXT Pod::Simple::text Pod::Simple::text Pod::Simple::Text Pod::Simple::TEXT Pod::text Pod::text Pod::Text Pod::TEXT Pod::Perldoc::ToPod?!
Aborting
 at /root/perl5/perlbrew/perls/perl-5.42.0/bin/perldoc line 13.

root@244a9d552a97:/app# perl -MPod::text -e 0
Can't locate Pod/text.pm in @INC (you may need to install the Pod::text module) (@INC entries checked: /root/perl5/perlbrew/perls/perl-5.42.0/lib/site_perl/5.42.0/x86_64-linux /root/perl5/perlbrew/perls/perl-5.42.0/lib/site_perl/5.42.0 /root/perl5/perlbrew/perls/perl-5.42.0/lib/5.42.0/x86_64-linux /root/perl5/perlbrew/perls/perl-5.42.0/lib/5.42.0).
BEGIN failed--compilation aborted.

root@244a9d552a97:/app# perl -MPod::Text -e 0
root@244a9d552a97:/app#

Expected behavior
Perl doc should show documentation

Perl configuration

perl -V
Summary of my perl5 (revision 5 version 42 subversion 0) configuration:
   
  Platform:
    osname=linux
    osvers=6.8.0-83-generic
    archname=x86_64-linux
    uname='linux buildkitsandbox 6.8.0-83-generic #83-ubuntu smp preempt_dynamic fri sep 5 21:46:54 utc 2025 x86_64 x86_64 x86_64 gnulinux '
    config_args='-de -Dprefix=/root/perl5/perlbrew/perls/perl-5.42.0 -Aeval:scriptdir=/root/perl5/perlbrew/perls/perl-5.42.0/bin'
    hint=recommended
    useposix=true
    d_sigaction=define
    useithreads=undef
    usemultiplicity=undef
    use64bitint=define
    use64bitall=define
    uselongdouble=undef
    usemymalloc=n
    default_inc_excludes_dot=define
  Compiler:
    cc='cc'
    ccflags ='-fwrapv -fno-strict-aliasing -pipe -fstack-protector-strong -I/usr/local/include -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64'
    optimize='-O2'
    cppflags='-fwrapv -fno-strict-aliasing -pipe -fstack-protector-strong -I/usr/local/include'
    ccversion=''
    gccversion='13.3.0'
    gccosandvers=''
    intsize=4
    longsize=8
    ptrsize=8
    doublesize=8
    byteorder=12345678
    doublekind=3
    d_longlong=define
    longlongsize=8
    d_longdbl=define
    longdblsize=16
    longdblkind=3
    ivtype='long'
    ivsize=8
    nvtype='double'
    nvsize=8
    Off_t='off_t'
    lseeksize=8
    alignbytes=8
    prototype=define
  Linker and Libraries:
    ld='cc'
    ldflags =' -fstack-protector-strong -L/usr/local/lib'
    libpth=/usr/local/lib /usr/lib/x86_64-linux-gnu /usr/lib /usr/lib64
    libs=-lpthread -ldl -lm -lcrypt -lutil -lc
    perllibs=-lpthread -ldl -lm -lcrypt -lutil -lc
    libc=/lib/x86_64-linux-gnu/libc.so.6
    so=so
    useshrplib=false
    libperl=libperl.a
    gnulibc_version='2.39'
  Dynamic Linking:
    dlsrc=dl_dlopen.xs
    dlext=so
    d_dlsymun=undef
    ccdlflags='-Wl,-E'
    cccdlflags='-fPIC'
    lddlflags='-shared -O2 -L/usr/local/lib -fstack-protector-strong'


Characteristics of this binary (from libperl): 
  Compile-time options:
    HAS_LONG_DOUBLE
    HAS_STRTOLD
    HAS_TIMES
    PERLIO_LAYERS
    PERL_COPY_ON_WRITE
    PERL_DONT_CREATE_GVSV
    PERL_HASH_FUNC_SIPHASH13
    PERL_HASH_USE_SBOX32
    PERL_MALLOC_WRAP
    PERL_OP_PARENT
    PERL_PRESERVE_IVUV
    PERL_USE_SAFE_PUTENV
    USE_64_BIT_ALL
    USE_64_BIT_INT
    USE_LARGE_FILES
    USE_LOCALE
    USE_LOCALE_COLLATE
    USE_LOCALE_CTYPE
    USE_LOCALE_NUMERIC
    USE_LOCALE_TIME
    USE_PERLIO
    USE_PERL_ATOF
  Built under linux
  Compiled at Sep 29 2025 00:52:35
  %ENV:
    PERLBREW="command perlbrew"
    PERLBREW_HOME="/root/.perlbrew"
    PERLBREW_MANPATH="/root/perl5/perlbrew/perls/perl-5.42.0/man"
    PERLBREW_PATH="/root/perl5/perlbrew/bin:/root/perl5/perlbrew/perls/perl-5.42.0/bin"
    PERLBREW_PERL="perl-5.42.0"
    PERLBREW_ROOT="/root/perl5/perlbrew"
    PERLBREW_SHELLRC_VERSION="1.02"
    PERLBREW_VERSION="1.02"
  @INC:
    /root/perl5/perlbrew/perls/perl-5.42.0/lib/site_perl/5.42.0/x86_64-linux
    /root/perl5/perlbrew/perls/perl-5.42.0/lib/site_perl/5.42.0
    /root/perl5/perlbrew/perls/perl-5.42.0/lib/5.42.0/x86_64-linux
    /root/perl5/perlbrew/perls/perl-5.42.0/lib/5.42.0

[mauke]

docker build fails here:

#0 building with "default" instance using docker driver

#1 [internal] load build definition from Dockerfile
#1 transferring dockerfile: 1.31kB done
#1 DONE 0.2s
Dockerfile:32
--------------------
  30 |     
  31 |     RUN cat << EOF >> $HOME/.bashrc
  32 | >>> if [ -f ~/perl5/perlbrew/etc/bashrc ]; then
  33 |       source ~/perl5/perlbrew/etc/bashrc
  34 |       source ~/perl5/perlbrew/etc/perlbrew-completion.bash
--------------------
ERROR: failed to solve: dockerfile parse error on line 32: unknown instruction: if

[mauke]

If I work around the Dockerfile error, the perlbrew install command fails:

#13 1311.6 # Failed test 124 - perldoc command works fine at ../lib/perl5db.t line 3026
#13 1311.6 #      got 'This system has been minimized by removing packages and content that are\nnot required on a system that users do not log into.\n\nTo restore this content, including manpages, you can run the \'unminimize\'\ncommand. You will still need to ensure the \'man-db\' package is installed.\n'
#13 1311.6 # expected /(?^:No (?:manual )?entry for perlrules)/
#13 1311.6 ../lib/perl5db.t .....................................................
#13 1311.6 Failed 1/163 subtests
#13 1311.6      (less 2 skipped subtests: 160 okay)

[KES777]

@mauke To workaround this you can run perlbrew install with -n option. or you can add into Dockerfile apt install man-db package. Right now I am trying to resolve the error you see here: #23780 (comment)

[KES777]

docker build fails here

It works on my side:

docker --version
Docker version 28.4.0, build d8eb465