perl documentation for the container perl version

Author: bodo-hugo-barwich

Dockerfile

@@ -1,7 +1,7 @@
 FROM debian:buster
 RUN apt-get update &&\
   apt-get -y install apt-utils gcc make openssl &&\
-  apt-get -y install cpanminus perl-modules liblocal-lib-perl &&\
+  apt-get -y install cpanminus perl-modules perl-doc liblocal-lib-perl &&\
   apt-get -y install libdbi-perl libfile-pushd-perl libipc-run3-perl libmodule-runtime-perl libsort-versions-perl libdevel-patchperl-perl libmodule-build-tiny-perl libmodule-pluggable-perl\
     libsyntax-keyword-try-perl libcapture-tiny-perl libhttp-tinyish-perl libnet-ssleay-perl\
     liburl-encode-perl libextutils-config-perl libextutils-helpers-perl libextutils-installpaths-perl\

etc/docker/README.pod

@@ -29,7 +29,7 @@ the C<docker-compose> installation can break your Docker Engine installation.
 To install the Docker Engine it is recommended to follow the guides of the Official Documentation
 L<Docker Engine Installation|https://docs.docker.com/engine/install/>
 
-=head1 CONTAINER BUILD
+=head1 IMAGE BUILD
 
 =item preconditions
 
@@ -61,7 +61,16 @@ So the command to build the docker image and launch it is:
 
     docker-compose up --build
 
+=head1 IMAGE INITIALISATION
 
+The new built Container Image contains an empty C<perldoc-browser.pl> Installation
+To run correctly the Search Backend need to be populated.
+So the command to populate the Search Backend is:
+
+   docker run -it -v /absolute/path/to/perldoc_web:/home/perldoc-browser:Z perldoc_web perldoc-browser.pl index all
+
+This will execute C<perldoc-browser.pl index all> in the project directory.
+The results are stored persistently in the project directory for further container launches.