diff gcc/jit/docs/_build/texinfo/libgccjit.texi @ 131:84e7813d76e9

gcc-8.2
author mir3636
date Thu, 25 Oct 2018 07:37:49 +0900
parents 04ced10e8804
children 1830386684a0
line wrap: on
line diff
--- a/gcc/jit/docs/_build/texinfo/libgccjit.texi	Fri Oct 27 22:46:09 2017 +0900
+++ b/gcc/jit/docs/_build/texinfo/libgccjit.texi	Thu Oct 25 07:37:49 2018 +0900
@@ -19,11 +19,11 @@
 
 @copying
 @quotation
-libgccjit 8.0.0 (experimental 20171004), October 04, 2017
+libgccjit 8.0.0 (experimental 20171031), October 31, 2017
 
 David Malcolm
 
-Copyright @copyright{} 2014-2017 Free Software Foundation, Inc.
+Copyright @copyright{} 2014-2018 Free Software Foundation, Inc.
 @end quotation
 
 @end copying
@@ -46,7 +46,7 @@
 
 @c %**start of body
 @anchor{index doc}@anchor{0}
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -85,7 +85,7 @@
 
 Contents:
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -388,7 +388,7 @@
 @chapter Tutorial
 
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -432,7 +432,7 @@
 
 @example
 /* Smoketest example for libgccjit.so
-   Copyright (C) 2014-2017 Free Software Foundation, Inc.
+   Copyright (C) 2014-2018 Free Software Foundation, Inc.
 
 This file is part of GCC.
 
@@ -583,7 +583,7 @@
 
 @noindent
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -1037,7 +1037,7 @@
 
 @example
 /* Usage example for libgccjit.so
-   Copyright (C) 2014-2017 Free Software Foundation, Inc.
+   Copyright (C) 2014-2018 Free Software Foundation, Inc.
 
 This file is part of GCC.
 
@@ -1170,7 +1170,7 @@
 
 @noindent
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -1651,7 +1651,7 @@
 
 @example
 /* Usage example for libgccjit.so
-   Copyright (C) 2014-2017 Free Software Foundation, Inc.
+   Copyright (C) 2014-2018 Free Software Foundation, Inc.
 
 This file is part of GCC.
 
@@ -1843,7 +1843,7 @@
 
 @noindent
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -3992,7 +3992,7 @@
 
 @noindent
 
-@c Copyright (C) 2015-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2015-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -4824,7 +4824,7 @@
 and to a dynamic library.  See the documentation of
 @pxref{4a,,gcc_jit_context_compile_to_file()} for more information.
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -4846,7 +4846,7 @@
 @chapter Topic Reference
 
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -5623,7 +5623,7 @@
 @noindent
 @end deffn
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -5740,7 +5740,7 @@
 @end cartouche
 @end deffn
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -6378,7 +6378,7 @@
 Function pointer types can be created using
 @pxref{91,,gcc_jit_context_new_function_ptr_type()}.
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -7464,7 +7464,7 @@
 in C (or, indeed, to @code{PTR + INDEX}).
 @end deffn
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -8090,7 +8090,7 @@
 @end quotation
 @end deffn
 
-@c Copyright (C) 2017 Free Software Foundation, Inc.
+@c Copyright (C) 2017-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -8173,7 +8173,7 @@
 given return type and parameters.
 @end deffn
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -8261,7 +8261,7 @@
 throughout the context, pointing at the dump file as if it were a source
 file, giving you @emph{something} you can step through in the debugger.
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -8538,7 +8538,7 @@
 against.
 @end deffn
 
-@c Copyright (C) 2015-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2015-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -8789,7 +8789,7 @@
 @code{LIBGCCJIT_ABI_10} covers the addition of
 @pxref{85,,gcc_jit_context_new_rvalue_from_vector()}
 
-@c Copyright (C) 2015-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2015-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -9100,7 +9100,7 @@
 @noindent
 @end deffn
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -9138,7 +9138,7 @@
 
 Contents:
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -9273,7 +9273,7 @@
 @section Tutorial
 
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -9316,7 +9316,7 @@
 
 @example
 /* Smoketest example for libgccjit.so C++ API
-   Copyright (C) 2014-2017 Free Software Foundation, Inc.
+   Copyright (C) 2014-2018 Free Software Foundation, Inc.
 
 This file is part of GCC.
 
@@ -9451,7 +9451,7 @@
 
 @noindent
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -9847,7 +9847,7 @@
 
 @example
 /* Usage example for libgccjit.so's C++ API
-   Copyright (C) 2014-2017 Free Software Foundation, Inc.
+   Copyright (C) 2014-2018 Free Software Foundation, Inc.
 
 This file is part of GCC.
 
@@ -9962,7 +9962,7 @@
 
 @noindent
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -10466,7 +10466,7 @@
 
 @example
 /* Usage example for libgccjit.so's C++ API
-   Copyright (C) 2014-2017 Free Software Foundation, Inc.
+   Copyright (C) 2014-2018 Free Software Foundation, Inc.
 
 This file is part of GCC.
 
@@ -10623,7 +10623,7 @@
 
 @noindent
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -12549,7 +12549,7 @@
 
 @noindent
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -12571,7 +12571,7 @@
 @section Topic Reference
 
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -12965,7 +12965,7 @@
 @noindent
 @end deffn
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -13063,7 +13063,7 @@
 @noindent
 @end deffn
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -13351,7 +13351,7 @@
 @pxref{8d,,gcc_jit_struct_set_fields()}.
 @end deffn
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -14253,7 +14253,7 @@
 @noindent
 @end quotation
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -14716,7 +14716,7 @@
 @end quotation
 @end deffn
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -14797,7 +14797,7 @@
 throughout the context, pointing at the dump file as if it were a source
 file, giving you @emph{something} you can step through in the debugger.
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -14869,7 +14869,7 @@
 @pxref{4a,,gcc_jit_context_compile_to_file()} API entrypoint.
 @end deffn
 
-@c Copyright (C) 2014-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2014-2018 Free Software Foundation, Inc.
 @c Originally contributed by David Malcolm <dmalcolm@redhat.com>
 @c 
 @c This is free software: you can redistribute it and/or modify it
@@ -15016,7 +15016,12 @@
 
 @noindent
 
-The test executables can be seen as:
+The test executables are normally deleted after each test is run.  For
+debugging, they can be preserved by setting 
+@geindex PRESERVE_EXECUTABLES
+@geindex environment variable; PRESERVE_EXECUTABLES
+@code{PRESERVE_EXECUTABLES}
+in the environment.  If so, they can then be seen as:
 
 @example
 jit/build/gcc/testsuite/jit/*.exe
@@ -15029,7 +15034,9 @@
 You can compile and run individual tests by passing "jit.exp=TESTNAME" to RUNTESTFLAGS e.g.:
 
 @example
-[gcc] $ make check-jit RUNTESTFLAGS="-v -v -v jit.exp=test-factorial.c"
+[gcc] $ PRESERVE_EXECUTABLES= \
+          make check-jit \
+            RUNTESTFLAGS="-v -v -v jit.exp=test-factorial.c"
 @end example
 
 @noindent
@@ -15056,7 +15063,10 @@
 @subsection Running under valgrind
 
 
-The jit testsuite detects if RUN_UNDER_VALGRIND is present in the
+The jit testsuite detects if 
+@geindex RUN_UNDER_VALGRIND
+@geindex environment variable; RUN_UNDER_VALGRIND
+@code{RUN_UNDER_VALGRIND} is present in the
 environment (with any value).  If it is present, it runs the test client
 code under valgrind@footnote{http://valgrind.org},
 specifcally, the default