Bug 1467390 - GNU coding standards info documentation missing
Summary: GNU coding standards info documentation missing
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 7
Classification: Red Hat
Component: binutils
Version: 7.5
Hardware: x86_64
OS: Linux
unspecified
low
Target Milestone: rc
: ---
Assignee: Nick Clifton
QA Contact: Miloš Prchlík
Vladimír Slávik
URL:
Whiteboard:
Depends On:
Blocks: 1473718
TreeView+ depends on / blocked
 
Reported: 2017-07-03 15:41 UTC by Don Pellegrino
Modified: 2018-04-10 10:00 UTC (History)
8 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Cause: The standards.info documentation file has gone missing from recent distributions. Consequence: The info system is now missing a node that describes the GNU Coding Standard. This can lead to confusion and frustration with the users of the info system. Fix: Add the standards.info file to the binutils package so that it will be installed when the binutils are installed. Result: The info system is no longer missing a node.
Clone Of:
Environment:
Last Closed: 2018-04-10 09:59:05 UTC
Target Upstream Version:

Attachments (Terms of Use)
Proposed patch (7.95 KB, patch)
2017-08-15 07:22 UTC, Nick Clifton 		no flags Details | Diff
Compressed standards.info file (69.84 KB, application/octet-stream)
2017-08-15 07:23 UTC, Nick Clifton 		no flags Details
View All


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2018:0686 0 None None None 2018-04-10 10:00:54 UTC

Description Don Pellegrino 2017-07-03 15:41:12 UTC 
Description of problem:

The info documentation index includes an entry under section "GNU organization" for "Standards" with description "GNU coding standards." However, when this entry is selected the error "Info file standards does not exist" is reported.

How reproducible:

Always

Steps to Reproduce:
1. Open emacs
2. M-x info
3. Observe info index entry for "Standards" and error on selection

Actual results:

Documentation is missing

Expected results:

Documentation should be shown on selection

Additional info:

yum provides "*standards.info" does not return any hits. This file should be in the distribution somewhere. Upstream for the file can be found at https://www.gnu.org/prep/standards/
Comment 2 Don Pellegrino 2017-07-03 15:47:34 UTC 
It looks like the file was in previous versions of binutils:

yum provides "*standards.info*"
Loaded plugins: langpacks, product-id, search-disabled-repos, subscription-
              : manager
binutils-2.23.52.0.1-16.el7.x86_64 : A GNU collection of binary utilities
Repo        : rhel-7-server-eus-rpms
Matched from:
Filename    : /usr/share/info/standards.info.gz



binutils-2.23.52.0.1-16.el7.x86_64 : A GNU collection of binary utilities
Repo        : rhel-7-server-rpms
Matched from:
Filename    : /usr/share/info/standards.info.gz



binutils-2.23.52.0.1-30.el7.x86_64 : A GNU collection of binary utilities
Repo        : rhel-7-server-eus-rpms
Matched from:
Filename    : /usr/share/info/standards.info.gz



binutils-2.23.52.0.1-30.el7.x86_64 : A GNU collection of binary utilities
Repo        : rhel-7-server-rpms
Matched from:
Filename    : /usr/share/info/standards.info.gz



binutils-2.23.52.0.1-30.el7_1.1.x86_64 : A GNU collection of binary utilities
Repo        : rhel-7-server-eus-rpms
Matched from:
Filename    : /usr/share/info/standards.info.gz



binutils-2.23.52.0.1-30.el7_1.1.x86_64 : A GNU collection of binary utilities
Repo        : rhel-7-server-rpms
Matched from:
Filename    : /usr/share/info/standards.info.gz



binutils-2.23.52.0.1-30.el7_1.2.x86_64 : A GNU collection of binary utilities
Repo        : rhel-7-server-eus-rpms
Matched from:
Filename    : /usr/share/info/standards.info.gz



binutils-2.23.52.0.1-30.el7_1.2.x86_64 : A GNU collection of binary utilities
Repo        : rhel-7-server-rpms
Matched from:
Filename    : /usr/share/info/standards.info.gz



binutils-2.23.52.0.1-55.el7.x86_64 : A GNU collection of binary utilities
Repo        : rhel-7-server-eus-rpms
Matched from:
Filename    : /usr/share/info/standards.info.gz



binutils-2.23.52.0.1-55.el7.x86_64 : A GNU collection of binary utilities
Repo        : rhel-7-server-rpms
Matched from:
Filename    : /usr/share/info/standards.info.gz



devtoolset-3-binutils-2.24-18.el7.x86_64 : A GNU collection of binary utilities
Repo        : rhel-server-rhscl-7-rpms
Matched from:
Filename    : /opt/rh/devtoolset-3/root/usr/share/info/standards.info.gz



xemacs-packages-extra-info-20140715-1.el7.noarch : XEmacs packages documentation
                                                 : in GNU texinfo format
Repo        : epel
Matched from:
Filename    : /usr/share/xemacs/mule-packages/info/latin-euro-standards.info.gz

However, it is missing from 2.25.1:

$ sudo yum info binutils
Loaded plugins: langpacks, product-id, search-disabled-repos, subscription-
              : manager
Installed Packages
Name        : binutils
Arch        : x86_64
Version     : 2.25.1
Release     : 22.base.el7
Size        : 22 M
Repo        : installed
From repo   : rhel-7-server-rpms
Summary     : A GNU collection of binary utilities
URL         : http://sources.redhat.com/binutils
License     : GPLv3+
Description : Binutils is a collection of binary utilities, including ar (for
            : creating, modifying and extracting from archives), as (a family of
            : GNU assemblers), gprof (for displaying call graph profile data),
            : ld (the GNU linker), nm (for listing symbols from object files),
            : objcopy (for copying and translating object files), objdump (for
            : displaying information from object files), ranlib (for generating
            : an index for the contents of an archive), readelf (for displaying
            : detailed information about binary files), size (for listing the
            : section sizes of an object or archive file), strings (for listing
            : printable strings from files), strip (for discarding symbols), and
            : addr2line (for converting addresses to file and line).

$ rpm -ql binutils
/usr/bin/addr2line
/usr/bin/ar
/usr/bin/as
/usr/bin/c++filt
/usr/bin/dwp
/usr/bin/elfedit
/usr/bin/gprof
/usr/bin/ld
/usr/bin/ld.bfd
/usr/bin/ld.gold
/usr/bin/nm
/usr/bin/objcopy
/usr/bin/objdump
/usr/bin/ranlib
/usr/bin/readelf
/usr/bin/size
/usr/bin/strings
/usr/bin/strip
/usr/lib64/libbfd-2.25.1-22.base.el7.so
/usr/lib64/libopcodes-2.25.1-22.base.el7.so
/usr/share/doc/binutils-2.25.1
/usr/share/doc/binutils-2.25.1/README
/usr/share/info/as.info.gz
/usr/share/info/binutils.info.gz
/usr/share/info/gprof.info.gz
/usr/share/info/ld.info.gz
/usr/share/locale/bg/LC_MESSAGES/binutils.mo
/usr/share/locale/bg/LC_MESSAGES/gprof.mo
/usr/share/locale/bg/LC_MESSAGES/ld.mo
/usr/share/locale/da/LC_MESSAGES/bfd.mo
/usr/share/locale/da/LC_MESSAGES/binutils.mo
/usr/share/locale/da/LC_MESSAGES/gprof.mo
/usr/share/locale/da/LC_MESSAGES/ld.mo
/usr/share/locale/da/LC_MESSAGES/opcodes.mo
/usr/share/locale/de/LC_MESSAGES/gprof.mo
/usr/share/locale/de/LC_MESSAGES/opcodes.mo
/usr/share/locale/eo/LC_MESSAGES/gprof.mo
/usr/share/locale/es/LC_MESSAGES/bfd.mo
/usr/share/locale/es/LC_MESSAGES/binutils.mo
/usr/share/locale/es/LC_MESSAGES/gas.mo
/usr/share/locale/es/LC_MESSAGES/gold.mo
/usr/share/locale/es/LC_MESSAGES/gprof.mo
/usr/share/locale/es/LC_MESSAGES/ld.mo
/usr/share/locale/es/LC_MESSAGES/opcodes.mo
/usr/share/locale/fi/LC_MESSAGES/bfd.mo
/usr/share/locale/fi/LC_MESSAGES/binutils.mo
/usr/share/locale/fi/LC_MESSAGES/gas.mo
/usr/share/locale/fi/LC_MESSAGES/gold.mo
/usr/share/locale/fi/LC_MESSAGES/gprof.mo
/usr/share/locale/fi/LC_MESSAGES/ld.mo
/usr/share/locale/fi/LC_MESSAGES/opcodes.mo
/usr/share/locale/fr/LC_MESSAGES/bfd.mo
/usr/share/locale/fr/LC_MESSAGES/binutils.mo
/usr/share/locale/fr/LC_MESSAGES/gas.mo
/usr/share/locale/fr/LC_MESSAGES/gprof.mo
/usr/share/locale/fr/LC_MESSAGES/ld.mo
/usr/share/locale/fr/LC_MESSAGES/opcodes.mo
/usr/share/locale/ga/LC_MESSAGES/gprof.mo
/usr/share/locale/ga/LC_MESSAGES/ld.mo
/usr/share/locale/ga/LC_MESSAGES/opcodes.mo
/usr/share/locale/hr/LC_MESSAGES/binutils.mo
/usr/share/locale/hu/LC_MESSAGES/gprof.mo
/usr/share/locale/id/LC_MESSAGES/bfd.mo
/usr/share/locale/id/LC_MESSAGES/binutils.mo
/usr/share/locale/id/LC_MESSAGES/gas.mo
/usr/share/locale/id/LC_MESSAGES/gold.mo
/usr/share/locale/id/LC_MESSAGES/gprof.mo
/usr/share/locale/id/LC_MESSAGES/ld.mo
/usr/share/locale/id/LC_MESSAGES/opcodes.mo
/usr/share/locale/it/LC_MESSAGES/binutils.mo
/usr/share/locale/it/LC_MESSAGES/gold.mo
/usr/share/locale/it/LC_MESSAGES/gprof.mo
/usr/share/locale/it/LC_MESSAGES/ld.mo
/usr/share/locale/it/LC_MESSAGES/opcodes.mo
/usr/share/locale/ja/LC_MESSAGES/bfd.mo
/usr/share/locale/ja/LC_MESSAGES/binutils.mo
/usr/share/locale/ja/LC_MESSAGES/gas.mo
/usr/share/locale/ja/LC_MESSAGES/gprof.mo
/usr/share/locale/ja/LC_MESSAGES/ld.mo
/usr/share/locale/ms/LC_MESSAGES/gprof.mo
/usr/share/locale/nl/LC_MESSAGES/gprof.mo
/usr/share/locale/nl/LC_MESSAGES/opcodes.mo
/usr/share/locale/pt_BR/LC_MESSAGES/gprof.mo
/usr/share/locale/pt_BR/LC_MESSAGES/opcodes.mo
/usr/share/locale/ro/LC_MESSAGES/bfd.mo
/usr/share/locale/ro/LC_MESSAGES/binutils.mo
/usr/share/locale/ro/LC_MESSAGES/gprof.mo
/usr/share/locale/ro/LC_MESSAGES/opcodes.mo
/usr/share/locale/ru/LC_MESSAGES/bfd.mo
/usr/share/locale/ru/LC_MESSAGES/binutils.mo
/usr/share/locale/ru/LC_MESSAGES/gas.mo
/usr/share/locale/ru/LC_MESSAGES/gprof.mo
/usr/share/locale/rw/LC_MESSAGES/bfd.mo
/usr/share/locale/rw/LC_MESSAGES/binutils.mo
/usr/share/locale/rw/LC_MESSAGES/gas.mo
/usr/share/locale/rw/LC_MESSAGES/gprof.mo
/usr/share/locale/sk/LC_MESSAGES/binutils.mo
/usr/share/locale/sr/LC_MESSAGES/binutils.mo
/usr/share/locale/sr/LC_MESSAGES/gprof.mo
/usr/share/locale/sv/LC_MESSAGES/bfd.mo
/usr/share/locale/sv/LC_MESSAGES/binutils.mo
/usr/share/locale/sv/LC_MESSAGES/gprof.mo
/usr/share/locale/sv/LC_MESSAGES/ld.mo
/usr/share/locale/sv/LC_MESSAGES/opcodes.mo
/usr/share/locale/tr/LC_MESSAGES/bfd.mo
/usr/share/locale/tr/LC_MESSAGES/binutils.mo
/usr/share/locale/tr/LC_MESSAGES/gas.mo
/usr/share/locale/tr/LC_MESSAGES/gprof.mo
/usr/share/locale/tr/LC_MESSAGES/ld.mo
/usr/share/locale/tr/LC_MESSAGES/opcodes.mo
/usr/share/locale/uk/LC_MESSAGES/bfd.mo
/usr/share/locale/uk/LC_MESSAGES/binutils.mo
/usr/share/locale/uk/LC_MESSAGES/gas.mo
/usr/share/locale/uk/LC_MESSAGES/gprof.mo
/usr/share/locale/uk/LC_MESSAGES/ld.mo
/usr/share/locale/uk/LC_MESSAGES/opcodes.mo
/usr/share/locale/vi/LC_MESSAGES/bfd.mo
/usr/share/locale/vi/LC_MESSAGES/binutils.mo
/usr/share/locale/vi/LC_MESSAGES/gold.mo
/usr/share/locale/vi/LC_MESSAGES/gprof.mo
/usr/share/locale/vi/LC_MESSAGES/ld.mo
/usr/share/locale/vi/LC_MESSAGES/opcodes.mo
/usr/share/locale/zh_CN/LC_MESSAGES/bfd.mo
/usr/share/locale/zh_CN/LC_MESSAGES/binutils.mo
/usr/share/locale/zh_CN/LC_MESSAGES/ld.mo
/usr/share/locale/zh_CN/LC_MESSAGES/opcodes.mo
/usr/share/locale/zh_TW/LC_MESSAGES/binutils.mo
/usr/share/locale/zh_TW/LC_MESSAGES/ld.mo
/usr/share/man/man1/addr2line.1.gz
/usr/share/man/man1/ar.1.gz
/usr/share/man/man1/as.1.gz
/usr/share/man/man1/c++filt.1.gz
/usr/share/man/man1/elfedit.1.gz
/usr/share/man/man1/gprof.1.gz
/usr/share/man/man1/ld.1.gz
/usr/share/man/man1/nm.1.gz
/usr/share/man/man1/objcopy.1.gz
/usr/share/man/man1/objdump.1.gz
/usr/share/man/man1/ranlib.1.gz
/usr/share/man/man1/readelf.1.gz
/usr/share/man/man1/size.1.gz
/usr/share/man/man1/strings.1.gz
/usr/share/man/man1/strip.1.gz
Comment 4 Nick Clifton 2017-08-10 16:01:08 UTC 
The GNU Coding Standards documentation is not part of the binutils package.  It may have been in the past, but that was a mistake.  The information is part of the FSF gnulib project (https://www.gnu.org/software/gnulib/) so I am changing the component to match that.
Comment 6 Nick Clifton 2017-08-15 07:22:22 UTC 
Created attachment 1313494 [details]
Proposed patch

There is currently no suitable RHEL package to provide the standards.info file,
so this patch adds it back into the binutils rpm.
Comment 7 Nick Clifton 2017-08-15 07:23:08 UTC 
Created attachment 1313495 [details]
Compressed standards.info file
Comment 8 Nick Clifton 2017-08-15 07:24:27 UTC 
I have created a patch to add the required functionality.  Should this BZ prove to acceptable for the RHEL 7.5 release it can go in when ready.
Comment 9 Nick Clifton 2017-08-30 08:11:41 UTC 
The patch has been added to the 7.5 binutils.
Comment 11 Miloš Prchlík 2018-01-31 11:11:03 UTC 
Verified with build binutils-2.27-27.base.el7.
Comment 14 errata-xmlrpc 2018-04-10 09:59:05 UTC 
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2018:0686
Note You need to log in before you can comment on or make changes to this bug.