From: David Malcolm <dmalcolm@redhat.com>
Date: Thu, 8 Jan 2015 22:08:41 +0000 (+0000)
Subject: libgccjit.h: Fix description of struct gcc_jit_context
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=7c8db13ee3b66cac87319944ed87957a96e1bd6e;p=gcc.git

libgccjit.h: Fix description of struct gcc_jit_context

gcc/jit/ChangeLog:
	* libgccjit.h (struct gcc_jit_context): Rewrite the descriptive
	comment.

From-SVN: r219366
---

diff --git a/gcc/jit/ChangeLog b/gcc/jit/ChangeLog
index b1af4f53deb..796c8a1c8ce 100644
--- a/gcc/jit/ChangeLog
+++ b/gcc/jit/ChangeLog
@@ -1,3 +1,8 @@
+2015-01-08  David Malcolm  <dmalcolm@redhat.com>
+
+	* libgccjit.h (struct gcc_jit_context): Rewrite the descriptive
+	comment.
+
 2015-01-08  David Malcolm  <dmalcolm@redhat.com>
 
 	* docs/topics/contexts.rst (Error-handling): Document new
diff --git a/gcc/jit/libgccjit.h b/gcc/jit/libgccjit.h
index 953c665388b..70f26ba5bb5 100644
--- a/gcc/jit/libgccjit.h
+++ b/gcc/jit/libgccjit.h
@@ -31,16 +31,19 @@ extern "C" {
  **********************************************************************/
 /* All structs within the API are opaque. */
 
-/* A gcc_jit_context encapsulates the state of a compilation.  It goes
-   through two states:
+/* A gcc_jit_context encapsulates the state of a compilation.
+   You can set up options on it, and add types, functions and code, using
+   the API below.
 
-   (1) "initial", during which you can set up options on it, and add
-       types, functions and code, using the API below.
-       Invoking gcc_jit_context_compile on it transitions it to the
-       "after compilation" state.
+   Invoking gcc_jit_context_compile on it gives you a gcc_jit_result *
+   (or NULL).
 
-   (2) "after compilation", when you can call gcc_jit_context_release to
-       clean up.  */
+   You can call gcc_jit_context_compile repeatedly on one context, giving
+   multiple independent results.
+
+   Eventually you can call gcc_jit_context_release to clean up the
+   context; any results created from it are still usable, and should be
+   cleaned up via gcc_jit_result_release.  */
 typedef struct gcc_jit_context gcc_jit_context;
 
 /* A gcc_jit_result encapsulates the result of a compilation.  */