Dependencies needed, by example of a debian system:

apt-get install \
  make \
  asciidoc \
  asciidoc-dblatex \
  xsltproc \
  dblatex \
  mscgen \
  graphviz \
  python-pychart \
  python-nwdiag

(Note that asciidoc-dblatex is required from debian 9 on and did not exist before.)

Build PDFs, run:
  make
or for a parallel build using more CPU cores:
  make -j 5

To update the VTY reference for a given program, use 'osmo_interact_vty.py -X',
available from git.osmocom.org/python/osmo-python-tests:

  cd ~/osmo-python-tests
  python3 setup.py install

  osmo_interact_vty.py -X -p $VTY_PORT > vty/*_vty_reference.xml

Find the VTY port number at
https://osmocom.org/projects/cellular-infrastructure/wiki/Port_Numbers

For example, for osmo-msc, which has VTY port 4254:

a) with an osmo-msc already running:

  osmo_interact_vty.py -X -p 4254 > OsmoMSC/vty/msc_vty_reference.xml

b) launching an osmo-msc along:

  osmo_interact_vty.py -r "osmo-msc -c ~/src/osmo-msc/doc/examples/osmo-msc/osmo-msc.cfg" \
    -X -p 4254 > OsmoMSC/vty/msc_vty_reference.xml