add CI action for seL4 manual about ci-actions

[kent-mcleod]

I noticed earlier that the seL4 docker wasn't able to build the manual because of missing doxygen dependencies. I believe that this is something that should be supported.

[lsf37]

You mean, should be supported in the main seL4 docker container? Yes, good idea. Will add the deps there.

[lsf37]

Hm, that's going to add a good 2GB to the container:

in-container:/host$ sudo apt-get install texlive texlive-latex-extra texlive-fonts-extra doxygen
Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following additional packages will be installed:
  dbus fontconfig fontconfig-config fonts-adf-accanthis fonts-adf-berenis fonts-adf-gillius fonts-adf-universalis fonts-cabin
  fonts-comfortaa fonts-croscore fonts-crosextra-caladea fonts-crosextra-carlito fonts-dejavu-core fonts-dejavu-extra fonts-droid-fallback
  fonts-ebgaramond fonts-ebgaramond-extra fonts-font-awesome fonts-freefont-otf fonts-freefont-ttf fonts-gfs-artemisia fonts-gfs-complutum
  fonts-gfs-didot fonts-gfs-neohellenic fonts-gfs-olga fonts-gfs-solomos fonts-go fonts-junicode fonts-lato fonts-linuxlibertine
  fonts-lmodern fonts-lobster fonts-lobstertwo fonts-noto-core fonts-noto-hinted fonts-noto-mono fonts-noto-ui-core fonts-oflb-asana-math
  fonts-open-sans fonts-roboto-unhinted fonts-sil-gentium fonts-sil-gentium-basic fonts-sil-gentiumplus fonts-sil-gentiumplus-compact
  fonts-stix fonts-texgyre javascript-common libapparmor1 libavahi-client3 libavahi-common-data libavahi-common3 libbrotli1 libcairo2
  libclang1-6.0 libcups2 libcupsfilters1 libcupsimage2 libdbus-1-3 libdrm-amdgpu1 libdrm-intel1 libdrm-nouveau2 libdrm-radeon1 libelf1
  libfile-basedir-perl libfile-desktopentry-perl libfile-mimeinfo-perl libfontconfig1 libfontenc1 libfreetype6 libgl1 libgl1-mesa-dri
  libglapi-mesa libglvnd0 libglx-mesa0 libglx0 libgraphite2-3 libgs9 libgs9-common libharfbuzz-icu0 libharfbuzz0b libice6 libidn11
  libijs-0.35 libio-stringy-perl libipc-system-simple-perl libjbig0 libjbig2dec0 libjs-jquery libkpathsea6 liblcms2-2 libllvm6.0 libllvm7
  libnet-dbus-perl libopenjp2-7 libpaper-utils libpaper1 libpciaccess0 libpotrace0 libptexenc1 libruby2.5 libsensors-config libsensors5
  libsm6 libsynctex2 libteckit0 libtexlua52 libtexlua53 libtexluajit2 libtext-iconv-perl libtie-ixhash-perl libtiff5 libtk8.6 libutempter0
  libwebp6 libwoff1 libx11-protocol-perl libx11-xcb1 libxapian30 libxaw7 libxcb-dri2-0 libxcb-dri3-0 libxcb-glx0 libxcb-present0
  libxcb-render0 libxcb-shape0 libxcb-shm0 libxcb-sync1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxft2 libxi6
  libxinerama1 libxml-parser-perl libxml-twig-perl libxml-xpathengine-perl libxmu6 libxmuu1 libxpm4 libxrandr2 libxrender1 libxshmfence1
  libxss1 libxt6 libxtst6 libxv1 libxxf86dga1 libxxf86vm1 libxxhash0 libyaml-0-2 libzzip-0-13 lmodern poppler-data preview-latex-style rake
  ruby ruby-did-you-mean ruby-minitest ruby-net-telnet ruby-power-assert ruby-test-unit ruby-xmlrpc ruby2.5 rubygems-integration
  shared-mime-info t1utils tcl tex-common tex-gyre texlive-base texlive-binaries texlive-fonts-extra-links texlive-fonts-recommended
  texlive-latex-base texlive-latex-recommended texlive-pictures texlive-plain-generic tipa tk tk8.6 unzip x11-common x11-utils
  x11-xserver-utils xbitmaps xdg-utils xfonts-encodings xfonts-utils xterm zip
Suggested packages:
  default-dbus-session-bus | dbus-session-bus doxygen-latex doxygen-doc doxygen-gui graphviz fonts-noto fontforge apache2 | lighttpd
  | httpd cups-common liblcms2-utils pciutils lm-sensors xapian-tools libunicode-map8-perl libunicode-string-perl xml-twig-tools
  poppler-utils ghostscript fonts-japanese-mincho | fonts-ipafont-mincho fonts-japanese-gothic | fonts-ipafont-gothic fonts-arphic-ukai
  fonts-arphic-uming fonts-nanum ri ruby-dev bundler debhelper gv | postscript-viewer perl-tk xpdf-reader | pdf-viewer cm-super
  texlive-fonts-extra-doc texlive-fonts-recommended-doc texlive-latex-base-doc python-pygments icc-profiles libspreadsheet-parseexcel-perl
  texlive-latex-extra-doc texlive-latex-recommended-doc texlive-pstricks dot2tex prerex ruby-tcltk | libtcltk-ruby texlive-pictures-doc
  vprerex mesa-utils nickle cairo-5c xorg-docs-core xfonts-cyrillic
The following NEW packages will be installed:
  dbus doxygen fontconfig fontconfig-config fonts-adf-accanthis fonts-adf-berenis fonts-adf-gillius fonts-adf-universalis fonts-cabin
  fonts-comfortaa fonts-croscore fonts-crosextra-caladea fonts-crosextra-carlito fonts-dejavu-core fonts-dejavu-extra fonts-droid-fallback
  fonts-ebgaramond fonts-ebgaramond-extra fonts-font-awesome fonts-freefont-otf fonts-freefont-ttf fonts-gfs-artemisia fonts-gfs-complutum
  fonts-gfs-didot fonts-gfs-neohellenic fonts-gfs-olga fonts-gfs-solomos fonts-go fonts-junicode fonts-lato fonts-linuxlibertine
  fonts-lmodern fonts-lobster fonts-lobstertwo fonts-noto-core fonts-noto-hinted fonts-noto-mono fonts-noto-ui-core fonts-oflb-asana-math
  fonts-open-sans fonts-roboto-unhinted fonts-sil-gentium fonts-sil-gentium-basic fonts-sil-gentiumplus fonts-sil-gentiumplus-compact
  fonts-stix fonts-texgyre javascript-common libapparmor1 libavahi-client3 libavahi-common-data libavahi-common3 libbrotli1 libcairo2
  libclang1-6.0 libcups2 libcupsfilters1 libcupsimage2 libdbus-1-3 libdrm-amdgpu1 libdrm-intel1 libdrm-nouveau2 libdrm-radeon1 libelf1
  libfile-basedir-perl libfile-desktopentry-perl libfile-mimeinfo-perl libfontconfig1 libfontenc1 libfreetype6 libgl1 libgl1-mesa-dri
  libglapi-mesa libglvnd0 libglx-mesa0 libglx0 libgraphite2-3 libgs9 libgs9-common libharfbuzz-icu0 libharfbuzz0b libice6 libidn11
  libijs-0.35 libio-stringy-perl libipc-system-simple-perl libjbig0 libjbig2dec0 libjs-jquery libkpathsea6 liblcms2-2 libllvm6.0 libllvm7
  libnet-dbus-perl libopenjp2-7 libpaper-utils libpaper1 libpciaccess0 libpotrace0 libptexenc1 libruby2.5 libsensors-config libsensors5
  libsm6 libsynctex2 libteckit0 libtexlua52 libtexlua53 libtexluajit2 libtext-iconv-perl libtie-ixhash-perl libtiff5 libtk8.6 libutempter0
  libwebp6 libwoff1 libx11-protocol-perl libx11-xcb1 libxapian30 libxaw7 libxcb-dri2-0 libxcb-dri3-0 libxcb-glx0 libxcb-present0
  libxcb-render0 libxcb-shape0 libxcb-shm0 libxcb-sync1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxft2 libxi6
  libxinerama1 libxml-parser-perl libxml-twig-perl libxml-xpathengine-perl libxmu6 libxmuu1 libxpm4 libxrandr2 libxrender1 libxshmfence1
  libxss1 libxt6 libxtst6 libxv1 libxxf86dga1 libxxf86vm1 libxxhash0 libyaml-0-2 libzzip-0-13 lmodern poppler-data preview-latex-style rake
  ruby ruby-did-you-mean ruby-minitest ruby-net-telnet ruby-power-assert ruby-test-unit ruby-xmlrpc ruby2.5 rubygems-integration
  shared-mime-info t1utils tcl tex-common tex-gyre texlive texlive-base texlive-binaries texlive-fonts-extra texlive-fonts-extra-links
  texlive-fonts-recommended texlive-latex-base texlive-latex-extra texlive-latex-recommended texlive-pictures texlive-plain-generic tipa tk
  tk8.6 unzip x11-common x11-utils x11-xserver-utils xbitmaps xdg-utils xfonts-encodings xfonts-utils xterm zip
0 upgraded, 196 newly installed, 0 to remove and 140 not upgraded.
Need to get 665 MB of archives.
After this operation, 2,086 MB of additional disk space will be used.
Do you want to continue? [Y/n] 

Do we really want that in the default base container?

[lsf37]

(doxygen is cheap, the latex install is what draws in the rest of the world)

[axel-h]

I'm not sure if convenience is worth it. It there a way to strip the 2GB down?

[lsf37]

Not without major package hackery. I'm sure x11-xserver-utils is not really needed for the manual, but there seem to be no finer-grained package sets I can pick. I could only try to install deb files directly.

[lsf37]

Re-opening this to finish the sel4-docker-or-not discussion.

[axel-h]

I'd say put it in for now, the longer I think about this, the more I'd say the benefits win. It provides the grounds to build documentation now also as part of the build process.

[lsf37]

It is part of the l4v container already. So yes, I'm also starting to think it's better to just include it. It's not like these containers are small anyway.

Ok, will make a PR there.

[lsf37]

There is now a -tex variant for the seL4 docker containers that has the dependencies to build the docs.