[Bug 2059107] [NEW] lto-disabled-list not documented in dpkg-buildflags man page

[Krzysztof Adamski]

Public bug reported:

When debugging some compilation issue I couldn't understand why the
buildflags would be changed depending in the source package name. I did
go through dpkg-buildflags man page but couldn't find an answer. It took
me quite some time to figure out what's going on and only after I found
out about lto-disabled-list file, I was able to find documentation on
https://wiki.ubuntu.com/ToolChain/LTO.

I understand this was considered temporary but it seems like it is to
stay for some time. Man page is one of the most important documentation
many people would be looking into in case of problems and it is quite
unexpected that multiple ways of configuring dpkg-buildflags are
mentioned but this one isn't. It is even adding to the confusion by
mentioning lto is disabled by default which is not the case on Ubuntu:

"lto This setting (since dpkg 1.21.0; disabled by default)"

Would you consider adding information about that feature also to the man
page?

I'm using Ubuntu 23.10 with 1.22.0ubuntu1.1 but as far as I can tell
that is also not documented in ubuntu/devel branch of
https://git.launchpad.net/ubuntu/+source/dpkg.

** Affects: dpkg (Ubuntu)
     Importance: Undecided
         Status: New

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to dpkg in Ubuntu.
https://bugs.launchpad.net/bugs/2059107

Title:
  lto-disabled-list not documented in dpkg-buildflags man page

Status in dpkg package in Ubuntu:
  New

Bug description:
  When debugging some compilation issue I couldn't understand why the
  buildflags would be changed depending in the source package name. I
  did go through dpkg-buildflags man page but couldn't find an answer.
  It took me quite some time to figure out what's going on and only
  after I found out about lto-disabled-list file, I was able to find
  documentation on https://wiki.ubuntu.com/ToolChain/LTO.

  I understand this was considered temporary but it seems like it is to
  stay for some time. Man page is one of the most important
  documentation many people would be looking into in case of problems
  and it is quite unexpected that multiple ways of configuring dpkg-
  buildflags are mentioned but this one isn't. It is even adding to the
  confusion by mentioning lto is disabled by default which is not the
  case on Ubuntu:

  "lto This setting (since dpkg 1.21.0; disabled by default)"

  Would you consider adding information about that feature also to the
  man page?

  I'm using Ubuntu 23.10 with 1.22.0ubuntu1.1 but as far as I can tell
  that is also not documented in ubuntu/devel branch of
  https://git.launchpad.net/ubuntu/+source/dpkg.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/dpkg/+bug/2059107/+subscriptions