<type>documentation</type>
<domain>browser</domain>
<id>symbol-types</id>
<title>Symbol Types</title>
<date>$Date$</date>
<version>$Revision$</version>
<product>per+</product>

The following types of items may be displayed in the ``Source Browser``, each 
with its own icon:

  |package| **Packages**, which are directories that contain a file named ``__init__.py``.
  See the Python documentation for additional information on `packages
  <https://docs.python.org/reference/import.html#packages>`__.
    
  |directory| **Directories** that do not contain an ``__init__.py`` file.
    
  |python| **Modules** defined by Python files.

  |class| **Classes** found anywhere in Python source
  
  |method| **Methods** defined within classes
  
  |attribute| **Attributes** defined in a class or instance
  
  |function| **Functions** defined at the top-level of a module or within another 
  function or method
  
  |variable| **Variables** defined at the top-level of a module or within a function,
  class, or method

.. |package| image:: images/package.png
  :class: inline-image
.. |directory| image:: images/directory.png
  :class: inline-image
.. |python| image:: images/python.png
  :class: inline-image
.. |class| image:: images/class.png
  :class: inline-image
.. |method| image:: images/method.png
  :class: inline-image
.. |attribute| image:: images/attribute.png
  :class: inline-image
.. |function| image:: images/function.png
  :class: inline-image
.. |variable| image:: images/variable.png
  :class: inline-image

Symbols may be annotated to indicate their origin:

  ``←`` Symbols that were imported from another module are annotated with a leftward
  pointing arrow.
  
  ``↑`` Symbols inherited from a superclass are annotated with an upward pointing arrow.

The ``Source Browser`` does not include function or method arguments, but these may be
displayed in the `Source Assistant <script:show-panel-source-assistant>`__, along with
other information for the currently selected item in the ``Source Browser``.
