Bug 89712 - Documentation contains unsupported options (-fdump-class-hierarchy and -fdump-translation-unit)
Summary: Documentation contains unsupported options (-fdump-class-hierarchy and -fdump...
Status: RESOLVED FIXED
Alias: None
Product: gcc
Classification: Unclassified
Component: other (show other bugs)
Version: 8.0
: P3 normal
Target Milestone: 8.4
Assignee: Martin Liška
URL:
Keywords: documentation
Depends on:
Blocks:
 
Reported: 2019-03-14 06:02 UTC by Maxim Zaitsev
Modified: 2019-03-15 08:38 UTC (History)
0 users

See Also:
Host:
Target:
Build:
Known to work: 7.4.0, 8.3.1, 9.0
Known to fail:
Last reconfirmed: 2019-03-14 00:00:00

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Maxim Zaitsev 2019-03-14 06:02:12 UTC 
Since GCC version 8.0 at least these two options were replaced:
-fdump-class-hierarchy ---> -fdump-lang-class
-fdump-translation-unit ---> -fdump-lang-raw

When I tried to use -fdump-class-hierarchy on GCC 8.2.1 and 8.3, I got the following error:

$ g++ -fdump-class-hierarchy source.cpp
cc1plus: error: unrecognized command line option ‘-fdump-class-hierarchy’

In the docs for 8.3 both class-hierarchy and translation-unit are still there. There is no way to figure out from documentation which options are replacements for these options.
Comment 1 Martin Liška 2019-03-14 13:53:00 UTC 
Confirmed, let me fix that.
Comment 2 Martin Liška 2019-03-14 14:10:23 UTC 
@Maxim: I see -fdump-class-hierarchy[-n] mentioned in PDF manual. Where do you see -fdump-class-hierarchy mentioned in GCC 8.x documentation?
Comment 3 Martin Liška 2019-03-14 14:11:30 UTC 
(In reply to Martin Liška from comment #2)
> @Maxim: I see -fdump-class-hierarchy[-n] mentioned in PDF manual. Where do
> you see -fdump-class-hierarchy mentioned in GCC 8.x documentation?

Sorry, I wanted to ask about '-fdump-translation-unit' ?
Comment 4 Martin Liška 2019-03-14 14:20:05 UTC 
Author: marxin
Date: Thu Mar 14 14:19:33 2019
New Revision: 269684

URL: https://gcc.gnu.org/viewcvs?rev=269684&root=gcc&view=rev
Log:
Remove dead option from manual (PR other/89712).

2019-03-14  Martin Liska  <mliska@suse.cz>

	PR other/89712
	* doc/invoke.texi: Remove -fdump-class-hierarchy option.

Modified:
    trunk/gcc/ChangeLog
    trunk/gcc/doc/invoke.texi
Comment 5 Martin Liška 2019-03-14 14:21:54 UTC 
Fixed on trunk.
Comment 6 Maxim Zaitsev 2019-03-15 08:10:50 UTC 
(In reply to Martin Liška from comment #2)
> @Maxim: I see -fdump-class-hierarchy[-n] mentioned in PDF manual. Where do
> you see -fdump-translation-unit mentioned in GCC 8.x documentation?

My apologies. Only `-fdump-class-hierarchy` was present in the docs, but `-fdump-translation-unit` doesn't work too since it was replaced. I thought that the change would be mentioned somewhere in the docs, but it's only my assumption.

Thanks for quick response and fixing the issue!
Comment 7 Martin Liška 2019-03-15 08:36:47 UTC 
Author: marxin
Date: Fri Mar 15 08:36:15 2019
New Revision: 269701

URL: https://gcc.gnu.org/viewcvs?rev=269701&root=gcc&view=rev
Log:
Subject: Backport r269684

2019-03-15  Martin Liska  <mliska@suse.cz>

	PR other/89712
	* doc/invoke.texi: Remove -fdump-class-hierarchy option.

Modified:
    branches/gcc-8-branch/gcc/ChangeLog
    branches/gcc-8-branch/gcc/doc/invoke.texi
Comment 8 Martin Liška 2019-03-15 08:38:48 UTC 
Usually we do not remove options, but leave them to be no-op. However, these options are designed for C++ FE developers, so Nathan decided to remove them.