index.html (5.4): Recommend against -I options for finding the ext headers.

2002-05-20  Phil Edwards  <pme@gcc.gnu.org>

	* docs/html/faq/index.html (5.4):  Recommend against -I options for
	finding the ext headers.
	* docs/html/faq/index.txt:  Regenerate.

From-SVN: r53669
This commit is contained in:
Phil Edwards 2002-05-20 17:55:14 +00:00
parent 5715ca64e9
commit fe1cc883cd
3 changed files with 21 additions and 10 deletions

View file

@ -1,3 +1,9 @@
2002-05-20 Phil Edwards <pme@gcc.gnu.org>
* docs/html/faq/index.html (5.4): Recommend against -I options for
finding the ext headers.
* docs/html/faq/index.txt: Regenerate.
2002-05-19 Paolo Carlini <pcarlini@unitus.it>
* testsuite/23_containers/deque_operators.cc (test01):

View file

@ -845,14 +845,16 @@ http://clisp.cons.org/~haible/gccinclude-glibc-2.2-compat.diff
<hr>
<h2><a name="5_4">5.4 Extensions and Backward Compatibility</a></h2>
<p>Although you can specify <code>-I</code> options to make the
preprocessor search the g++-v3/ext and /backward directories,
it is better to refer to files there by their path, as in:
<p>Headers in the <code>ext</code> and <code>backward</code>
subdirectories should be referred to by their relative paths:
<!-- Careful, the leading spaces in PRE show up directly. -->
</p>
<pre>
#include &lt;ext/hash_map&gt;
</pre>
#include &lt;ext/hash_map&gt; </pre>
rather than using <code>-I</code> or other options. This is more
portable and forward-compatible. (The situation is the same as
that of other headers whose directories are not searched directly,
e.g., <code>&lt;sys/stat.h&gt;</code>, <code>&lt;X11/Xlib.h&gt;</code>.
</p>
<p>Extensions to the library have
<a href="../ext/howto.html">their own page</a>.
</p>

View file

@ -691,11 +691,14 @@ http://clisp.cons.org/~haible/gccinclude-glibc-2.2-compat.diff
5.4 Extensions and Backward Compatibility
Although you can specify -I options to make the preprocessor search
the g++-v3/ext and /backward directories, it is better to refer to
files there by their path, as in:
#include <ext/hash_map>
Headers in the ext and backward subdirectories should be referred to
by their relative paths:
#include <ext/hash_map>
rather than using -I or other options. This is more portable and
forward-compatible. (The situation is the same as that of other
headers whose directories are not searched directly, e.g.,
<sys/stat.h>, <X11/Xlib.h>.
Extensions to the library have [92]their own page.
_________________________________________________________________