<type>documentation</type>
<domain>proj</domain>
<id>view-optionsw</id>
<title>Display Options</title>
<date>$Date$</date>
<version>$Revision$</version>
<product>per+</product>

All the directories and files that have been added to your Wing project are displayed in
the `Project <script:show_panel#panel_type="project">`__ tool in the ``Tools`` menu. Each
item is paired with an icon indicating its type, if a file type can be determined for it.
When a revision control system such as Git or Mercurial is active, a red pencil |changed|
icon is superimposed on the file type icons on any file that has been changed since last
update or commit.

.. |changed| image:: icon:wingide-versioncontrol-modified
  :class: inline-image

The project can be set to organize your files in one of several ways,
using the ``Options`` menu in the top right of the ``Project`` tool:

* **View As Tree** -- This displays the project files in tree form.  The
  tree structure is based on the relative path from the project file
  to the files and directories added to the project.
  
* **View As Flattened Tree** -- This view shows files organized
  according to their location on disk. Each directory is shown at the top
  level with path names shown as relative paths based on the
  location of the project file.

The ``Options`` menu also contains items that control the sorting of files
within their directory:

* **Sort by Name** -- Show files in alphabetical order
* **Sort by Mime Type** -- Show files grouped by mime type
* **Sort by Extension** -- Show files grouped by their extension

The ``List Files Before Directories`` option controls whether files or directories are 
shown first in the tree view.
