Skip to content

Commit d28af7c

Browse files
committed
remove -fpch-codegen and -fpch-debuginfo from Clang 12.0 release notes
These were new in 11.0. The commit adding the options landed after 11.x branch had already been branched off from master, and only then backported to 11.x, so the release notes change stayed for 12.0.
1 parent 04ba60c commit d28af7c

File tree

1 file changed

+0
-25
lines changed

1 file changed

+0
-25
lines changed

Diff for: clang/docs/ReleaseNotes.rst

-25
Original file line numberDiff line numberDiff line change
@@ -82,31 +82,6 @@ New Compiler Flags
8282
in that case. The option's behaviour mirrors GCC, the helpers are implemented
8383
both in compiler-rt and libgcc.
8484

85-
- -fpch-codegen and -fpch-debuginfo generate shared code and/or debuginfo
86-
for contents of a precompiled header in a separate object file. This object
87-
file needs to be linked in, but its contents do not need to be generated
88-
for other objects using the precompiled header. This should usually save
89-
compile time. If not using clang-cl, the separate object file needs to
90-
be created explicitly from the precompiled header.
91-
Example of use:
92-
93-
.. code-block:: console
94-
95-
$ clang++ -x c++-header header.h -o header.pch -fpch-codegen -fpch-debuginfo
96-
$ clang++ -c header.pch -o shared.o
97-
$ clang++ -c source.cpp -o source.o -include-pch header.pch
98-
$ clang++ -o binary source.o shared.o
99-
100-
- Using -fpch-instantiate-templates when generating the precompiled header
101-
usually increases the amount of code/debuginfo that can be shared.
102-
- In some cases, especially when building with optimizations enabled, using
103-
-fpch-codegen may generate so much code in the shared object that compiling
104-
it may be a net loss in build time.
105-
- Since headers may bring in private symbols of other libraries, it may be
106-
sometimes necessary to discard unused symbols (such as by adding
107-
-Wl,--gc-sections on ELF platforms to the linking command, and possibly
108-
adding -fdata-sections -ffunction-sections to the command generating
109-
the shared object).
11085
- New option ``-fbinutils-version=`` specifies the targeted binutils version.
11186
For example, ``-fbinutils-version=2.35`` means compatibility with GNU as/ld
11287
before 2.35 is not needed: new features can be used and there is no need to

0 commit comments

Comments
 (0)