Go to file
Davis King d81641cd8e These templates ostensibly allowed a user to supply their own version of the
test_box_overlap object.  However, one place in the code assumed the
test_box_overlap object was used and so this feature has actually been broken
for some time.  Moreover, it's probably just confusing and excessively complex
to have this level of user modifiability so I removed the option and hard coded
everything to use the test_box_overlap object.  This makes the code
significantly clearer.
2013-03-23 18:08:17 -04:00
dlib These templates ostensibly allowed a user to supply their own version of the 2013-03-23 18:08:17 -04:00
docs updated docs 2013-03-19 23:04:07 -04:00
examples Removed unneeded #include 2013-03-17 14:00:50 -04:00
tools A minor change to avoid a compiler warning in visual studio 2012 2013-02-11 18:02:26 -05:00
.hgignore Added build_clang folders to the ignore list. 2012-04-13 19:37:38 -04:00
.hgtags Added tag v18.1 for changeset 8d0762ab49b9 2013-03-03 18:59:57 -05:00
README.txt fixed grammar 2012-05-20 13:14:04 -04:00


If you are reading this file then you must have downloaded dlib via the 
mercurial repository.  If you are new to dlib then go read the introduction
and how to compile pages at http://dlib.net/intro.html and http://dlib.net/compile.html.
If you are planning on contributing code then also read the contribution
instructions at http://dlib.net/howto_contribute.html.


COMPILING DLIB EXAMPLE PROGRAMS
   Go into the examples folder and type:
   mkdir build; cd build; cmake .. ; cmake --build .

   That will build all the examples.  Note that there is nothing to install
   when using dlib.  It's just a folder of source files.  Sometimes people
   tell me dlib should be compiled and installed as some kind of shared
   library, however, they are wrong. Please read this http://dlib.net/howto_contribute.html#9 
   before starting this argument again.  


RUNNING THE UNIT TEST SUITE
   Type the following to compile and run the dlib unit test suite (it takes a while):
   cd dlib/test; mkdir build; cd build; cmake ..; cmake --build . --config Release; ./test --runall

   Note that on windows your compiler might put the test executable in a subfolder called
   Release.  If that's the case then you have to go to that folder before running the test.


DOCUMENTATION
   The mercurial repository doesn't contain finished documentation.  The stuff in
   the docs folder is just a bunch of scripts and xml files used to generate the 
   documentation.  There is a readme in docs/README.txt which discusses how to do
   this.  However, unless you are trying to modify the documentation, you should
   just download a copy from http://dlib.net.  That would probably be easier than
   setting up your environment to generate the documentation yourself.