* [PATCH v3]: gcc/doc/extend.texi: Update builtin descriptions for __builtin_FILE, __builtin_LINE __builtin_FUNCTION
@ 2024-02-07 14:58 Jonny Grant
0 siblings, 0 replies; only message in thread
From: Jonny Grant @ 2024-02-07 14:58 UTC (permalink / raw)
To: gcc-patches, Sandra Loosemore
2024-02-07 Jonathan Grant <jg@jguk.org>
gcc/ChangeLog:
* doc/extend.texi: Update builtin descriptions for __builtin_FILE
__builtin_LINE __builtin_FUNCTION.
From 9e0b662b5b036f37d7ca90db607bacbb0012e8b3 Mon Sep 17 00:00:00 2001
From: Jonathan Grant <jg@jguk.org>
Date: Wed, 7 Feb 2024 14:51:34 +0000
Subject: [PATCH] gcc/doc/extend.texi: Update builtin descriptions for
__builtin_FILE, __builtin_LINE __builtin_FUNCTION
Signed-off-by: Jonathan Grant <jg@jguk.org>
---
gcc/doc/extend.texi | 25 ++++++++++---------------
1 file changed, 10 insertions(+), 15 deletions(-)
diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi
index 2b8ba1949bf..124cca1e208 100644
--- a/gcc/doc/extend.texi
+++ b/gcc/doc/extend.texi
@@ -15202,34 +15202,29 @@ and returns an address constant pointing to the name of the function
from which the built-in was invoked, or the empty string if
the invocation is not at function scope. When used as a C++ default
argument for a function @var{F}, it returns the name of @var{F}'s
-caller or the empty string if the call was not made at function
-scope.
+caller.
@enddefbuiltin
@defbuiltin{{const char *} __builtin_FILE ()}
This function is the equivalent of the preprocessor @code{__FILE__}
macro and returns an address constant pointing to the file name
-containing the invocation of the built-in, or the empty string if
-the invocation is not at function scope. When used as a C++ default
+containing the invocation of the built-in, or an empty string if
+the invocation is not at file scope. When used as a C++ default
argument for a function @var{F}, it returns the file name of the call
-to @var{F} or the empty string if the call was not made at function
-scope.
+to @var{F}.
-For example, in the following, each call to function @code{foo} will
-print a line similar to @code{"file.c:123: foo: message"} with the name
-of the file and the line number of the @code{printf} call, the name of
+In the following example, each call to function @code{foo}
+prints a line similar to @code{"file.c:123: foo: message"} with the
+file and line number of the @code{printf} call, the name of
the function @code{foo}, followed by the word @code{message}.
@smallexample
-const char*
-function (const char *func = __builtin_FUNCTION ())
-@{
- return func;
-@}
+#include <stdio.h>
void foo (void)
@{
- printf ("%s:%i: %s: message\n", file (), line (), function ());
+ printf ("%s:%i: %s: message\n", __builtin_FILE (), __builtin_LINE (),
+ __builtin_FUNCTION ());
@}
@end smallexample
--
2.40.1
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2024-02-07 14:58 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-02-07 14:58 [PATCH v3]: gcc/doc/extend.texi: Update builtin descriptions for __builtin_FILE, __builtin_LINE __builtin_FUNCTION Jonny Grant
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).