#*************************************************************************#
#*                                                                        #
#*  This file is part of Frama-C.                                         #
#*                                                                        #
#*  Copyright (C) 2007-2020                                               #
#*    CEA (Commissariat à l'énergie atomique et aux énergies              #
#*         alternatives)                                                  #
#*                                                                        #
#*  you can redistribute it and/or modify it under the terms of the GNU   #
#*  Lesser General Public License as published by the Free Software       #
#*  Foundation, version 2.1.                                              #
#*                                                                        #
#*  It is distributed in the hope that it will be useful,                 #
#*  but WITHOUT ANY WARRANTY; without even the implied warranty of        #
#*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         #
#*  GNU Lesser General Public License for more details.                   #
#*                                                                        #
#*  See the GNU Lesser General Public License version 2.1                 #
#*  for more details (enclosed in the file licenses/LGPLv2.1).            #
#*                                                                        #
#*************************************************************************#

{2 Overview}

The Occurrence module aims at highlighting the occurrence of any variable in
the Frama-C GUI. Details about the use of this plugin may be found in
{{:http://frama-c.cea.fr/occurrence.html}the user documentation}.

{2 Inside the plug-in}

The code of this plug-in is quite simple. It is splitted into the analysis
itself and the extension to the GUI. 

The code of this plug-in is quite short but uses most advanced Frama-C
features (visitor, projects, journalisation, log, gui). So it is a good
complete not-toy example of a (kernel-integrated) Frama-C plug-in.
