tempest/resources/3rdparty/pantheios-1.0.1-beta214/HOW_YOU_CAN_HELP.txt

Pantheios - How You Can Help
============================

Updated:    26th November 2010



There are several ways in which you can help the Pantheios project:

 1. Defect reports
 2. Feature requests
 3. Submit your own extensions: inserters, back-ends, front-ends
 4. Sponsor development
 5. Write articles, blog-posts about your experiences
 6. Help flesh out the Wikipedia page for Pantheios


1. Defect reports
-----------------

A diagnostic logging library exists to help locate and identify defects in
applications/components. An obvious consequence of this principle is that a
diagnostic logging library should not itself be the source of faults.

Consequently, we're very keen to hear of any problems you have in building
and, especially, in using the library.

If you're unsure whether your issue is a genuine defect in the library, we
ask that you post a description of your problem on the project Help Forum,
located at:

  http://sourceforge.net/projects/pantheios/forums/forum/475314

If you're sure that your issue is a genuine defect, please feel free to
submit an item in the project Bug Tracker, located at:

  http://sourceforge.net/tracker/?group_id=141831&atid=750757

In either case, please help us to help you by submitting as much information
about the problem as you think is relevant, including:

 * the compiler you're using
 * the architecture and operating system you're targeting
 * the version of Pantheios
 * the version of STLSoft
 * the version of other 3rd-party libraries, such as Boost, Loki, ...
 * whether you're building using the makefiles or via an IDE
 * a section of the build output, including the warnings/errors involved


2. Feature requests
-------------------

Pantheios is a living library, and we are not so foolish as to think that
we've thought of all the ways in which C++ diagnostic logging can be
improved.

If there are features that you think would enhance the library, please feel
free to share your ideas.

If you're precisely sure what you need, please feel free to start a
conversation on the Open Discussion Forum, located at:

  http://sourceforge.net/projects/pantheios/forums/forum/475313

If you're clear of what you need, please feel free to submit an item in the
project Feature Request Tracker, located at:

  http://sourceforge.net/tracker/?group_id=141831&atid=750760

NOTE: Synesis Software provides commercial customisations of Pantheios,
 including custom front-ends and back-ends, custom severity levels, and much
 more. For such advanced uses, contact Synesis Software via their website
 at http://www.synesis.com.au/contact.html


3. Submit your own extensions: inserters, back-ends, front-ends
---------------------------------------------------------------

If you have developed your own inserters, back-ends, front-ends, and wish to
contribute them back to the project so others can benefit from your work,
please get in contact at via the Open Discussion Forum, located at:

  http://sourceforge.net/projects/pantheios/forums/forum/475313


4. Sponsor development
----------------------

If you value the diligence and effort that's gone into bringing you this
production-quality software, please make a donation to the project, via:

  http://sourceforge.net/project/project_donations.php?group_id=141831


5. Write articles, blog-posts about your experiences
----------------------------------------------------

If you've written articles or blogged about Pantheios, let us know and we'll
list them on the website, at:

  http://www.pantheios.org/tutorials.html

If you haven't, please consider doing so.


6. Help flesh out the Wikipedia page for Pantheios
--------------------------------------------------

Pantheios is a very popular logging library. Despite that, the powers that
be at Wikipedia have deemed that it is not notable. If you disagree with
that, please update the Pantheios Wikipedia page at:

  http://en.wikipedia.org/wiki/Pantheios


=============================== End of file ================================