From 674e31ee8d12d188b07b3312028f077a9d9f99c5 Mon Sep 17 00:00:00 2001
From: Davis King
Date: Mon, 26 Mar 2018 16:48:48 -0400
Subject: [PATCH] Updated docs
---
docs/docs/compile.xml | 31 ++-----------------------------
1 file changed, 2 insertions(+), 29 deletions(-)
diff --git a/docs/docs/compile.xml b/docs/docs/compile.xml
index bb21b3fa9..4f41cf6a1 100644
--- a/docs/docs/compile.xml
+++ b/docs/docs/compile.xml
@@ -68,15 +68,7 @@ tell CMake which one you want it to use via the -G option.
In most cases, to use this library all you have to do is extract it somewhere, make
sure the folder containing the dlib folder is in your include path, and
finally add dlib/all/source.cpp to your
- project. It is worth noting that most of dlib is "header-only" which means that, in
- many cases, you don't actually have to build dlib/all/source.cpp into your
- application. So if you don't get linker errors when you exclude dlib/all/source.cpp
- from your project then you don't need it.
-
-
- An example makefile that uses this library can be found here: dlib/test/makefile. It is the makefile used to build
- the regression test suite for this library.
+ project.
Again, note that you should not add the dlib folder itself to your compiler's include path.
@@ -112,11 +104,6 @@ tell CMake which one you want it to use via the -G option.
From within the examples folder, you can compile nearly all of the examples with a single command like so:
g++ -std=c++11 -O3 -I.. ../dlib/all/source.cpp -lpthread -lX11 example_program_name.cpp
-
- Note that not all examples require this much work. For example, the svm_ex.cpp example
- can be compiled with just:
-
-g++ -std=c++11 -O3 -I.. svm_ex.cpp
On non-Linux systems like Solaris, you might have to link to other libraries. For example, I have seen systems
@@ -184,21 +171,7 @@ sudo apt-get install libx11-dev
An example of when you might want to use this would be if you don't need GUI support and you are building
on a UNIX platform that doesn't have the X11 headers installed.
- NO_MAKEFILE
- #define NO_MAKEFILE
-
- This preprocessor directive causes the dlib headers to pull in all the
- code that would normally be built in dlib/all/source.cpp. Thus if you #define NO_MAKEFILE you won't
- have to add dlib/all/source.cpp to your project. The only time this is useful is when your
- project consists of a single translation unit (i.e. a single cpp file). In this instance NO_MAKEFILE
- allows you to easily build your project on the command line by saying something like g++ -DNO_MAKEFILE
- project.cpp. But again, this is only for single cpp file projects. If you use NO_MAKEFILE with projects
- that contain more than one cpp file you will get linker errors about multiply defined symbols.
-
-
- Also note that if you use this macro then the stack trace
- functionality in the library will be disabled.
-
+
DLIB_THREAD_POOL_TIMEOUT
#define DLIB_THREAD_POOL_TIMEOUT <time-in-milliseconds>