.. _FAQ:

==========================
Frequently Asked Questions
==========================

* :ref:`What does FileTags Library do?<faq1>`
* :ref:`What do I need to do to install FileTags Library?<faq2>`
* :ref:`How do I add to the FileTags Library documentation?<faq3>`
* :ref:`How do I report a bug?<faq4>`



.. _faq1:

What does FileTags Library do?
--------------------------------

FileTags Library consists of functions that wrap the COM implementation of the IPropertyStore object, for accessing the PKEY_Keywords property metadata of a file.
 
The IPropertyStore object and PKEY_Keywords property is used for the 'Tags' feature in Windows Explorer, when viewing the properties of a file, or when the Details Pane of Windows Explorer is open and a file is selected.
 
Thus the FileTags Library functions hide the complexities of interacting with the IPropertyStore COM object, allowing the user to read, write and clear the keywords / tags for a file.


.. _faq2:

What do I need to do to install FileTags Library?
---------------------------------------------------

Please follow the :ref:`Installation & Setup<Installation & Setup>` guide for details on how to install the FileTags Library.


.. _faq3:

How do I add to the FileTags Library documentation?
-----------------------------------------------------

Please follow the :ref:`Contributing<Contributing>` guide for details on how to add to, or edit, the FileTags Library documentation.


.. _faq4:

How do I report a bug?
----------------------

If you should encounter any bugs, please open a new issue on the `FileTags Library <https://github.com/mrfearless/FileTags-Library>`_ Github repository.