################################################################################
# PCHGenerator...
################################################################################

The PCHGenerator is a tool for helping precompiled header generation. It scans all source files in project and selects the most often used headers for putting them into precompiled header.



################################################################################
# Project Homepage...
################################################################################

http://lukaszczerwinski.pl/pch_generator.en.html



################################################################################
# License...
################################################################################

PCHGenerator tool is developed under the BSD license. It is allowed to distribute source, use it and modify without any limitations either for personal or commercial goal. Whilst distributing source code using PCHGenerator it is obligate to mark the author

There is absolutely no guarantee that PCHGenerator tool will work without any errors and that is free of any bugs. PCHGenerator author is not responsible for any damages, mind and financial loses related with PCHGenerator using.



################################################################################
# How to use it...
################################################################################

1) Create precompiled.h file
pch.py -c YourCurrentCompilationOption YourSourceFiles

  lukasz@KOMPUTEREK ~/pchGenerator (master)
  $ pch.py -c="-I d:\boost" main.cpp test.cpp

  $ cat precompiled.h
  // File generated by : pch.py
  // Compilation options: -I d:\boost
  // Project path       : /home/project*
  // Threshold          : 1
  // Exclude pattern    :
  // Exclude but pattern:
  #include "d:/MinGW/bin/../ ... /include/c++/3.4.5/iostream"
  #include "d:/MinGW/bin/../ ... /include/c++/3.4.5/vector"

2) Compile precompiled.h into precompiled.gch
g++ YourCurrentCompilationOption precompiled.h

  $ g++ -I d:\boost precompiled.h

3) Compile your project with prcompiled.gch according to the g++ manual
In every source code at the beginning put '#include "precompiled.h"' line.
For details click here (http://gcc.gnu.org/onlinedocs/gcc-4.1.2/gcc/Precompiled-Headers.html) (gnu g++) or here (http://stackoverflow.com/questions/58841/precompiled-headers-with-gcc) (stackoverflow).



################################################################################
# Requirements...
################################################################################

PCHGenerator depends on following externals:
• python



################################################################################
#Bugs...
################################################################################
There are no bugs. There are "features".



################################################################################
# Support and further development...
################################################################################

Maybe some day in the future I will do
- add some support for CLang
- add some support for Microsoft Visual C++



################################################################################
# GitHub...
################################################################################
https://github.com/wo3kie/pchGenerator