Admonitions (FAQ, NOTE, TODO, BUG)
##################################

Automated index of all admonitions (in this manual as well as in
python code documentation). For simplicity, we only use four
admonitions: *error, attention, note, tip*.


.. error:: **(BUG) Ongoing issues: No fix yet**


.. attention:: **(TODO) Ongoing issues: Minor or has workaround**

  * `administrator <administrator.html>`_: **Manual Setup Section**: Has not been revised since ``1.0.x``
  * `administrator <administrator.html>`_: When adding a **Remote**, be sure to use the **exact same hostname** (in the ``http`` field) the instance uses
  * `python/mini_buildd.api <python/mini_buildd.api.html>`_: Call **debmirror** (external workarounds): ``apt update`` fails on ``experimental`` suites (contents not mirrored) (:debbug:`819925`)
  * `python/mini_buildd.api <python/mini_buildd.api.html>`_: Call **handshake**: In production, we occasionally see ``W: Remote handshake failed for ...: 'tuple' object has no attribute 'signatures'``. Reproduce?
  * `python/mini_buildd.models <python/mini_buildd.models.html>`_: **AptKeys**: Duplicates possible (will break API call ``setup``)
  * `python/mini_buildd.models <python/mini_buildd.models.html>`_: **Chroot**: LVM chroots fail running lvcreate with 'not found: device not cleared' (:debbug:`705238`)
  * `python/mini_buildd.models <python/mini_buildd.models.html>`_: **Daemon**: When changing ftp network settings, then PCA: Still not active, needs explicit restart?
  * `python/mini_buildd.models <python/mini_buildd.models.html>`_: **Distribution** (``workaround in __str__``): Not unique for base source (historic fluke)
  * `python/mini_buildd.models <python/mini_buildd.models.html>`_: **Distribution**: When adding Architecture: No indication that we need to re-index (run check on repository)
  * `python/mini_buildd.reprepro <python/mini_buildd.reprepro.html>`_: **reprepro** (``dist.py`` setup workaround): Can't handle Ubuntu's ``ddeb`` (:debbug:`730572`)
  * `python/mini_buildd.reprepro <python/mini_buildd.reprepro.html>`_: **reprepro**: Don't switch to ``reprepro 5.4`` yet (:debbug:`1017983`)
  * `python/mini_buildd.reprepro <python/mini_buildd.reprepro.html>`_: **reprepro**: Fails with ``debian/`` being a symlink in Debian native packages (:debbug:`768046`)
  * `python/mini_buildd.sbuild <python/mini_buildd.sbuild.html>`_: **sbuild** (retry-workaround in ``gnupg.py``): Spurious build failures ``can't connect to the agent: IPC connect call failed`` (:debbug:`849551`)
  * `python/mini_buildd.sbuild <python/mini_buildd.sbuild.html>`_: **sbuild** (workaround in ``apt-update`` snippet): ``apt-get update`` "File has unexpected size ... Mirror sync in progress?" failures
  * `python/mini_buildd.sbuild <python/mini_buildd.sbuild.html>`_: **sbuild**: Fails to build "all" packages with "build archall" flag set to arch "x" in case DSP has >= 1 arch "all" and >=1 arch "y" binary package (:debbug:`706086`)
  * `python/mini_buildd.sbuild <python/mini_buildd.sbuild.html>`_: **sbuild+apt-cacher-ng** (workaround in ``apt-update`` snippet): ``apt-get update`` stalls on parallel access
  * `python/mini_buildd.schroot <python/mini_buildd.schroot.html>`_: **schroot**: 'target is busy' on session close (stale schroot sessions)
  * `python/mini_buildd.schroot <python/mini_buildd.schroot.html>`_: **wheezy or older builds on amd64**: Re-enable linux' vsyscall
  * `roadmap <roadmap.html>`_: **buster-based install**: 500 Internal Error: ``[Errno 2] No such file or directory: 'S.gpg-agent.extra'``

.. note:: **(NOTE) Something not obvious you should be aware of**

  * `python/mini_buildd.api <python/mini_buildd.api.html>`_: Call **keyring-packages**: No compat for urold <= squeeze (``apt-key add``)
  * `python/mini_buildd.api <python/mini_buildd.api.html>`_: Call **keyring-packages**: squeeze or older only: apt secure problems after initial (unauthorized) install of the archive-key package (:debbug:`657561`)
  * `python/mini_buildd.api <python/mini_buildd.api.html>`_: Call **stop**: *Ongoing* ``PACKAGING`` or ``BUILDING`` are lost on restart
  * `python/mini_buildd.builtins <python/mini_buildd.builtins.html>`_: http://tools.ietf.org/html/rfc5147: This, in theory, could be some way to create a TOC for text/plain (buildlogs and such). However
  * `python/mini_buildd.models <python/mini_buildd.models.html>`_: **Chroot** (``mbd_workaround_debmirror_script``): Be able to strap 'newer Ubuntus' with Debian's ``debootstrap``
  * `python/mini_buildd.models <python/mini_buildd.models.html>`_: **Chroot** (setup workaround in ``dist.py``): debootstrap fails for <=lenny chroots on >=jessie host kernel (uname) (:debbug:`642031`)
  * `python/mini_buildd.models <python/mini_buildd.models.html>`_: **Daemon**: Instance does not touch the GPG setup once it's created -- *unless you do an explicit remove* on the instance.
  * `python/mini_buildd.models <python/mini_buildd.models.html>`_: **Uploader**: Don't add or delete instances manually!
  * `python/mini_buildd.reprepro <python/mini_buildd.reprepro.html>`_: **reprepro**: Multiple versions of packages in one distribution
  * `python/mini_buildd.sbuild <python/mini_buildd.sbuild.html>`_: This will iterate all lines of the build log,
  * `python/mini_buildd.schroot <python/mini_buildd.schroot.html>`_: **schroot**: Verbosely logs commands ("Running command ...") explicitly via syslog (journalctl)

.. tip:: **(FAQ) Free tip**

  * `abstract <abstract.html>`_: Some links do not work in this manual?
  * `administrator <administrator.html>`_: Can I manually instantiate a build chroot to repeat/debug a failed build?
  * `administrator <administrator.html>`_: How much disk space do I need to run mini-buildd?
  * `administrator <administrator.html>`_: How to enable encrypted uploads (FTPS)?
  * `administrator <administrator.html>`_: How to manually fix a failing check in a ``Source`` due to wrong/missing APT key(s)?
  * `administrator <administrator.html>`_: How to run mini-buildd in a systemd container (nspawn)?
  * `administrator <administrator.html>`_: In the web configurator, you may use the ``PCA`` shortcut (``prepare``, ``check`` and ``activate``).
  * `administrator <administrator.html>`_: My chroot creation fails due to missing arch in archive (partial mirror)?
  * `administrator <administrator.html>`_: What's ``eatmydata`` and ``ccache``?
  * `administrator <administrator.html>`_: sudo fails with "sudo: no tty present and no askpass program specified"?
  * `consumer <consumer.html>`_: How can I upgrade after Debian main release version fix?
  * `consumer <consumer.html>`_: How do I verify mini-buildd's APT key?
  * `consumer <consumer.html>`_: How to save credentials when working from the shell?
  * `consumer <consumer.html>`_: What's the ``hotfix`` suite good for?
  * `consumer <consumer.html>`_: ``firefox``: How can I reset (table) searches (like in webkit browsers)?
  * `developer <developer.html>`_: Can I access built packages that have not been installed into the repository?
  * `developer <developer.html>`_: Do mini-buildd commands support bash autocompletion?
  * `developer <developer.html>`_: Is package building parallel? (a.k.a. Where is the 'sbuild_jobs' settings?)
  * `developer <developer.html>`_: Is there support for ``emacs``?
  * `python/mini_buildd.dist <python/mini_buildd.dist.html>`_: What does ``LTS`` (mini-buildd speak) include for Debian?
  * `python/mini_buildd.dist <python/mini_buildd.dist.html>`_: What does ``LTS`` (mini-buildd speak) include for Ubuntu?
  * `python/mini_buildd.models <python/mini_buildd.models.html>`_: **Chroot**: Install :debpkg:`qemu-user-static` for seamless access to foreign archs (albeit with a speed penalty)
  * `roadmap <roadmap.html>`_: Can I skip migrating from 0.8.x?
