• goal
  • sources / generate C++ standard's drafts
    • ❌!= ISO publication❌

• install
  • MacTeX distribution
  • if you are | slow network,
    • get BasicTeX package
  • sudo tlmgr install latexmk isodate substr relsize ulem fixme rsfs extract layouts enumitem l3packages l3kernel imakeidx splitindex xstring
    • Problems:
      • Problem1: "sudo: tlmgr: command not found"
        • Solution: Add TeX Live to PATH:

          export PATH="/usr/local/texlive/2023/bin/universal-darwin:$PATH"
          # Add to ~/.zshrc or ~/.bash_profile for permanent fix
          echo 'export PATH="/usr/local/texlive/2023/bin/universal-darwin:$PATH"' >> ~/.zshrc

Install the following packages::

sudo apt-get install latexmk texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended lmodern

Install the following packages::

dnf install latexmk texlive texlive-isodate texlive-relsize texlive-ulem texlive-fixme texlive-extract texlive-l3kernel texlive-l3packages texlive-splitindex texlive-imakeidx

Install the following packages::

pacman -S make texlive-latexextra texlive-binextra texlive-plaingeneric texlive-fontsrecommended

Install Perl (for example, using a Cygwin installation <https://cygwin.com/install.html>_ and adding perl. See sample instructions <https://bennierobinson.com/programming/2016/01/24/perl-windows-2016.html>_ for more details)

Install MiKTeX <https://miktex.org/download>_

Alternatively, you can install WSL <https://learn.microsoft.com/en-us/windows/wsl/install>_ and a Linux distribution, and follow the instructions for Linux above.

• | source,
  • make
    • generate a "std.pdf"

To regenerate figures from .dot files, run::

make

For example::

make figvirt.pdf

While in the source directory, you can check for common mistakes such as misaligned comments with::

../tools/check-source.sh

After typesetting the document, you can also check the output for further problems with::

../tools/check-output.sh

GitHub Actions will also run these checks when you create a pull request, but it's often faster if you run them locally first.

• ways
  • attempt1: pandoc containers.tex -o containers.md
  • attempt2: pandoc source/containers.tex -o source/containers_improved.md --from=latex --to=markdown --wrap=none --preserve-tabs --markdown-headings=atx
  • attempt3: pandoc source/containers_clean.tex -o source/containers_clean.md --from=latex --to=markdown --wrap=none
• Problems:
  • Problem1: NOT pretty clear .md
    • Temporary solution: study cppreference.com
    • Solution: TODO: