mirror of
https://forge.sourceware.org/marek/gcc.git
synced 2026-02-22 20:01:31 -05:00
544be2beb1
The Profile Mode extension is not used by anybody, nor maintained by anybody. The containers do not support the full API specified in recent standards, and so enabling Profile Mode is not source compatible with much modern C++ code. The heuristics that would check the profile information and make useful suggestions never materialized, so it isn't useful. It should be removed. Remove Profile Mode, deprecated since 7.1.0 * doc/Makefile.am: Remove XML file for profile mode docs. * doc/Makefile.in: Regenerate. * doc/xml/authors.xml: Remove authors of profile mode docs. * doc/xml/manual/appendix_contributing.xml: Remove mention of profile mode. * doc/xml/manual/debug.xml: Likewise. * doc/xml/manual/evolution.xml: Document removal of profile mode. * doc/xml/manual/profile_mode.xml: Remove profile mode docs. * doc/xml/manual/spine.xml: Remove profile mode author credit. * doc/xml/manual/test.xml: Remove docs for dg-require-profile-mode directive. * doc/xml/manual/using.xml: Remove docs for profile mode headers and macro. * doc/html/*: Regenerate. * include/Makefile.am: Remove profile mode headers. * include/Makefile.in: Regenerate. * include/bits/c++config (std::__profile): Remove namespace. [_GLIBCXX_PROFILE]: Remove checks for macro. * include/profile/array: Remove. * include/profile/base.h: Remove. * include/profile/bitset: Remove. * include/profile/deque: Remove. * include/profile/forward_list: Remove. * include/profile/impl/profiler.h: Remove. * include/profile/impl/profiler_algos.h: Remove. * include/profile/impl/profiler_container_size.h: Remove. * include/profile/impl/profiler_hash_func.h: Remove. * include/profile/impl/profiler_hashtable_size.h: Remove. * include/profile/impl/profiler_list_to_slist.h: Remove. * include/profile/impl/profiler_list_to_vector.h: Remove. * include/profile/impl/profiler_map_to_unordered_map.h: Remove. * include/profile/impl/profiler_node.h: Remove. * include/profile/impl/profiler_state.h: Remove. * include/profile/impl/profiler_trace.h: Remove. * include/profile/impl/profiler_vector_size.h: Remove. * include/profile/impl/profiler_vector_to_list.h: Remove. * include/profile/iterator_tracker.h: Remove. * include/profile/list: Remove. * include/profile/map: Remove. * include/profile/map.h: Remove. * include/profile/multimap.h: Remove. * include/profile/multiset.h: Remove. * include/profile/ordered_base.h: Remove. * include/profile/set: Remove. * include/profile/set.h: Remove. * include/profile/unordered_base.h: Remove. * include/profile/unordered_map: Remove. * include/profile/unordered_set: Remove. * include/profile/vector: Remove. * scripts/run_doxygen: Do not process profile mode headers. * testsuite/23_containers/array/element_access/60497.cc: Don't use profile mode type. * testsuite/23_containers/array/specialized_algorithms/swap_cxx17.cc: Remove dg-skip-if for profile mode. * testsuite/23_containers/forward_list/capacity/1.cc: Remove preprocessor check for profile mode. * testsuite/23_containers/list/capacity/29134.cc: Likewise. * testsuite/23_containers/map/modifiers/extract.cc: Remove dg-skip-if for profile mode. * testsuite/23_containers/map/modifiers/insert_or_assign/1.cc: Likewise. * testsuite/23_containers/map/modifiers/try_emplace/1.cc: Likewise. * testsuite/23_containers/multimap/modifiers/extract.cc: Likewise. * testsuite/23_containers/multiset/modifiers/extract.cc: Likewise. * testsuite/23_containers/set/modifiers/extract.cc: Likewise. * testsuite/23_containers/unordered_map/modifiers/extract.cc: Likewise. * testsuite/23_containers/unordered_multimap/modifiers/extract.cc: Likewise. * testsuite/23_containers/unordered_multiset/modifiers/extract.cc: Likewise. * testsuite/23_containers/unordered_set/modifiers/extract.cc: Likewise. * testsuite/23_containers/vector/bool/capacity/29134.cc: Remove preprocessor check for profile mode. * testsuite/23_containers/vector/bool/modifiers/insert/31370.cc: Likewise. * testsuite/23_containers/vector/modifiers/insert_vs_emplace.cc: Remove dg-skip-if for profile mode. * testsuite/25_algorithms/binary_search/partitioned.cc: Likewise. * testsuite/25_algorithms/equal_range/partitioned.cc: Likewise. * testsuite/25_algorithms/lexicographical_compare/71545.cc: Likewise. * testsuite/25_algorithms/lower_bound/partitioned.cc: Likewise. * testsuite/25_algorithms/upper_bound/partitioned.cc: Likewise. * testsuite/Makefile.am: Remove profile_flags variable and * testsuite/Makefile.am: Remove profile_flags variable and check-profile target. * testsuite/Makefile.in: Regenerate. * testsuite/ext/profile/all.cc: Remove. * testsuite/ext/profile/mutex_extensions_neg.cc: Remove. * testsuite/ext/profile/profiler_algos.cc: Remove. * testsuite/ext/profile/replace_new.cc: Remove. * testsuite/ext/throw_allocator/deallocate_global.cc: Remove preprocessor check for profile mode. * testsuite/ext/throw_allocator/deallocate_local.cc: Likewise. * testsuite/lib/libstdc++.exp (check_v3_target_profile_mode): Remove. (check_v3_target_normal_mode): Do not check for profile mode macro. * testsuite/libstdc++-prettyprinters/80276.cc: Remove dg-skip-if for profile mode. * testsuite/libstdc++-prettyprinters/compat.cc: Likewise. * testsuite/libstdc++-prettyprinters/cxx11.cc: Likewise. * testsuite/libstdc++-prettyprinters/cxx17.cc: Likewise. * testsuite/libstdc++-prettyprinters/debug.cc: Likewise. * testsuite/libstdc++-prettyprinters/debug_cxx11.cc: Likewise. * testsuite/libstdc++-prettyprinters/libfundts.cc: Likewise. * testsuite/libstdc++-prettyprinters/simple.cc: Likewise. * testsuite/libstdc++-prettyprinters/simple11.cc: Likewise. * testsuite/libstdc++-prettyprinters/whatis.cc: Likewise. * testsuite/libstdc++-prettyprinters/whatis2.cc: Likewise. From-SVN: r271120
106 lines
8.0 KiB
HTML
106 lines
8.0 KiB
HTML
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Directory Layout and Source Conventions</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><meta name="keywords" content="ISO C++, library" /><meta name="keywords" content="ISO C++, runtime, library" /><link rel="home" href="../index.html" title="The GNU C++ Library" /><link rel="up" href="appendix_contributing.html" title="Appendix A. Contributing" /><link rel="prev" href="appendix_contributing.html" title="Appendix A. Contributing" /><link rel="next" href="source_code_style.html" title="Coding Style" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Directory Layout and Source Conventions</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="appendix_contributing.html">Prev</a> </td><th width="60%" align="center">Appendix A.
|
||
Contributing
|
||
|
||
</th><td width="20%" align="right"> <a accesskey="n" href="source_code_style.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="contrib.organization"></a>Directory Layout and Source Conventions</h2></div></div></div><p>
|
||
The <code class="filename">libstdc++-v3</code> directory in the
|
||
GCC sources contains the files needed to create the GNU C++ Library.
|
||
</p><p>
|
||
It has subdirectories:
|
||
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="filename">doc</code></span></dt><dd>
|
||
Files in HTML and text format that document usage, quirks of the
|
||
implementation, and contributor checklists.
|
||
</dd><dt><span class="term"><code class="filename">include</code></span></dt><dd>
|
||
All header files for the C++ library are within this directory,
|
||
modulo specific runtime-related files that are in the libsupc++
|
||
directory.
|
||
|
||
<div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="filename">include/std</code></span></dt><dd>
|
||
Files meant to be found by <code class="code">#include <name></code> directives
|
||
in standard-conforming user programs.
|
||
</dd><dt><span class="term"><code class="filename">include/c</code></span></dt><dd>
|
||
Headers intended to directly include standard C headers.
|
||
[NB: this can be enabled via <code class="option">--enable-cheaders=c</code>]
|
||
</dd><dt><span class="term"><code class="filename">include/c_global</code></span></dt><dd>
|
||
Headers intended to include standard C headers in
|
||
the global namespace, and put select names into the <code class="code">std::</code>
|
||
namespace. [NB: this is the default, and is the same as
|
||
<code class="option">--enable-cheaders=c_global</code>]
|
||
</dd><dt><span class="term"><code class="filename">include/c_std</code></span></dt><dd>
|
||
Headers intended to include standard C headers
|
||
already in namespace std, and put select names into the <code class="code">std::</code>
|
||
namespace. [NB: this is the same as
|
||
<code class="option">--enable-cheaders=c_std</code>]
|
||
</dd><dt><span class="term"><code class="filename">include/bits</code></span></dt><dd>
|
||
Files included by standard headers and by other files in
|
||
the bits directory.
|
||
</dd><dt><span class="term"><code class="filename">include/backward</code></span></dt><dd>
|
||
Headers provided for backward compatibility, such as
|
||
<code class="filename"><backward/hash_map></code>.
|
||
They are not used in this library.
|
||
</dd><dt><span class="term"><code class="filename">include/ext</code></span></dt><dd>
|
||
Headers that define extensions to the standard library. No
|
||
standard header refers to any of them, in theory (there are some
|
||
exceptions).
|
||
</dd><dt><span class="term">
|
||
<code class="filename">include/debug</code>,
|
||
<code class="filename">include/parallel</code>, and
|
||
</span></dt><dd>
|
||
Headers that implement the Debug Mode and Parallel Mode extensions.
|
||
</dd></dl></div></dd><dt><span class="term"><code class="filename">scripts</code></span></dt><dd>
|
||
Scripts that are used during the configure, build, make, or test
|
||
process.
|
||
</dd><dt><span class="term"><code class="filename">src</code></span></dt><dd>
|
||
Files that are used in constructing the library, but are not
|
||
installed.
|
||
|
||
<div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="filename">src/c++98</code></span></dt><dd>
|
||
Source files compiled using <code class="option">-std=gnu++98</code>.
|
||
</dd><dt><span class="term"><code class="filename">src/c++11</code></span></dt><dd>
|
||
Source files compiled using <code class="option">-std=gnu++11</code>.
|
||
</dd><dt><span class="term"><code class="filename">src/filesystem</code></span></dt><dd>
|
||
Source files for the Filesystem TS.
|
||
</dd><dt><span class="term"><code class="filename">src/shared</code></span></dt><dd>
|
||
Source code included by other files under both
|
||
<code class="filename">src/c++98</code> and
|
||
<code class="filename">src/c++11</code></dd></dl></div></dd><dt><span class="term"><code class="filename">testsuites/[backward, demangle, ext, performance, thread, 17_* to 30_*]</code></span></dt><dd>
|
||
Test programs are here, and may be used to begin to exercise the
|
||
library. Support for "make check" and "make check-install" is
|
||
complete, and runs through all the subdirectories here when this
|
||
command is issued from the build directory. Please note that
|
||
"make check" requires DejaGnu 1.4 or later to be installed,
|
||
or for extra <a class="link" href="test.html#test.run.permutations" title="Permutations">permutations</a>
|
||
DejaGnu 1.5.3 or later.
|
||
</dd></dl></div><p>
|
||
Other subdirectories contain variant versions of certain files
|
||
that are meant to be copied or linked by the configure script.
|
||
Currently these are:
|
||
</p><div class="literallayout"><p><code class="filename">config/abi</code><br />
|
||
<code class="filename">config/allocator</code><br />
|
||
<code class="filename">config/cpu</code><br />
|
||
<code class="filename">config/io</code><br />
|
||
<code class="filename">config/locale</code><br />
|
||
<code class="filename">config/os</code><br />
|
||
</p></div><p>
|
||
</p><p>
|
||
In addition, a subdirectory holds the convenience library libsupc++.
|
||
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="filename">libsupc++</code></span></dt><dd>
|
||
Contains the runtime library for C++, including exception
|
||
handling and memory allocation and deallocation, RTTI, terminate
|
||
handlers, etc.
|
||
</dd></dl></div><p>
|
||
Note that glibc also has a <code class="filename">bits/</code>
|
||
subdirectory. We need to be careful not to collide with names in its
|
||
<code class="filename">bits/</code> directory. For example
|
||
<code class="filename"><bits/std_mutex.h></code> has to be
|
||
renamed from <code class="filename"><bits/mutex.h></code>.
|
||
Another solution would be to rename <code class="filename">bits</code>
|
||
to (e.g.) <code class="filename">cppbits</code>.
|
||
</p><p>
|
||
In files throughout the system, lines marked with an "XXX" indicate
|
||
a bug or incompletely-implemented feature. Lines marked "XXX MT"
|
||
indicate a place that may require attention for multi-thread safety.
|
||
</p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="appendix_contributing.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="appendix_contributing.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="source_code_style.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Appendix A.
|
||
Contributing
|
||
|
||
</td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> Coding Style</td></tr></table></div></body></html> |