From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1930) id D1B9039AE416; Thu, 19 Aug 2021 18:51:03 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org D1B9039AE416 MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="utf-8" From: Martin Sebor To: gcc-cvs@gcc.gnu.org Subject: [gcc r12-3032] Document enable_ranger and disable_ranger. X-Act-Checkin: gcc X-Git-Author: Martin Sebor X-Git-Refname: refs/heads/master X-Git-Oldrev: 81501087758cb0c32e555858cf367e449a09246e X-Git-Newrev: 77bf9f83b8e388de8bedb259991f588a7b8a7f57 Message-Id: <20210819185103.D1B9039AE416@sourceware.org> Date: Thu, 19 Aug 2021 18:51:03 +0000 (GMT) X-BeenThere: gcc-cvs@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 19 Aug 2021 18:51:03 -0000 https://gcc.gnu.org/g:77bf9f83b8e388de8bedb259991f588a7b8a7f57 commit r12-3032-g77bf9f83b8e388de8bedb259991f588a7b8a7f57 Author: Martin Sebor Date: Thu Aug 19 12:49:40 2021 -0600 Document enable_ranger and disable_ranger. gcc: * gimple-range.cc: Add comments. * gimple-range.h: Same. Diff: --- gcc/gimple-range.cc | 7 +++++++ gcc/gimple-range.h | 3 +++ 2 files changed, 10 insertions(+) diff --git a/gcc/gimple-range.cc b/gcc/gimple-range.cc index 60b7d3a59cd..ef3afeacc90 100644 --- a/gcc/gimple-range.cc +++ b/gcc/gimple-range.cc @@ -381,6 +381,10 @@ gimple_ranger::dump (FILE *f) m_cache.dump (f); } +/* Create a new ranger instance and associate it with function FUN. + Each call must be paired with a call to disable_ranger to release + resources. */ + gimple_ranger * enable_ranger (struct function *fun) { @@ -392,6 +396,9 @@ enable_ranger (struct function *fun) return r; } +/* Destroy and release the ranger instance associated with function FUN + and replace it the global ranger. */ + void disable_ranger (struct function *fun) { diff --git a/gcc/gimple-range.h b/gcc/gimple-range.h index 41845b14fd6..eaebb9c5833 100644 --- a/gcc/gimple-range.h +++ b/gcc/gimple-range.h @@ -62,6 +62,9 @@ protected: range_tracer tracer; }; +/* Create a new ranger instance and associate it with a function. + Each call must be paired with a call to disable_ranger to release + resources. */ extern gimple_ranger *enable_ranger (struct function *); extern void disable_ranger (struct function *);