Report on Operations Rehersal #1

DMTN-119

Short report on the ops rehearsal held in Feb 2019.

Links

• Live drafts: https://dmtn-119.lsst.io
• GitHub: https://github.com/lsst-dm/dmtn-119

Build

This repository includes lsst-texmf as a Git submodule. Clone this repository:

git clone --recurse-submodules https://github.com/lsst-dm/dmtn-119

Compile the PDF:

make

Clean built files:

make clean

Updating glossary

A table of the technote's acronyms and their definitions are maintained in the aglossary.tex file, which is committed as part of this repository. To update the acronyms table in aglossary.tex:

make aglossary.tex

Note: this command requires that this repository was cloned as a submodule.

The acronyms discovery code scans the LaTeX source for probable acronyms. You can ensure that certain strings aren't treated as acronyms by adding them to the skipacronyms.txt file.

The lsst-texmf repository centrally maintains definitions for LSST acronyms. You can also add new acronym definitions, or override the definitions of acronyms, by editing the myacronyms.txt file.

Updating lsst-texmf

lsst-texmf includes BibTeX files, the lsstdoc class file, and acronym definitions, among other essential tooling for LSST's LaTeX documentation projects. To update to a newer version of lsst-texmf, you can update the submodule in this repository:

git submodule update --init --recursive

Commit, then push, the updated submodule.