Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 95 lines (61 sloc) 3.056 kB
c5adab2 Imported Upstream version 1.9.52
Stefan Naewe authored
1 ============================================================================
2 STLSoft - FAQ
3
4 ; Created: 29th March 2002
b3aebf0 Imported upstream 1.9.101
Stefan Naewe authored
5 ; Updated: 30th September 2010
c5adab2 Imported Upstream version 1.9.52
Stefan Naewe authored
6
7 ============================================================================
8
9
a5d722d Imported upstream version 1.9.66
Stefan Naewe authored
10
11 The FAQ list is under (constant) development. If you post a question on the
12 Tutorials forum (https://sourceforge.net/forum/forum.php?forum_id=903893)
13 it will be used to create one.
14
15 FAQs:
16 =====
17
a8d1000 Imported upstream 1.9.98
Stefan Naewe authored
18 Q1: "How do I build STLSoft?"
a5d722d Imported upstream version 1.9.66
Stefan Naewe authored
19
20 A1:
a8d1000 Imported upstream 1.9.98
Stefan Naewe authored
21 You don't: STLSoft is 100% header-only, so all you have to do is #include
22 it. We do recommend that you use an environment variable, e.g. STLSOFT, so
23 that you can use new versions of the library from your projects without
24 disruption.
25
26
27 Q2: "How do I install STLSoft?"
28
29 A2:
30 There are three steps:
31 1. Download the latest distribution of STLSoft, from http://stlsoft.org/
32 2. Unzip it to a directory of your choice, e.g /3pty/stlsoft-1.9.98
33 3. Define an environment variable STLSOFT, whose value is the directory
34 in which you unzipped it, e.g. STLSOFT=/3pty/stlsoft-1.9.98
35
36
37 Q3: "How do I use STLSoft?"
38
39 A3:
40 Assuming you've installed it (as per instructions A2):
41
42 In your IDE settings, add the include directory $(STLSOFT)/include, OR in
43 your makefiles, add the include directory:
44 * -I$STLSOFT/include (if you're on UNIX), OR
45 * -I%STLSOFT%/include (if you're on Windows)
46
47
48 Q4: "Does STLSoft have unit-tests?"
49
50 A4:
51 Yes, but for various reasons they're not available with the STLSoft 1.9
52 distribution. The STLSoft 1.10 alpha distributions come with an increasing
53 number of unit-/component-tests for both STLSoft 1.9 and STLSoft 1.10, and
54 when STLSoft 1.10 enters beta phase, it will ship with tests.
55
56
57 Q5: "What is STLSoft 1.10?"
58
59 A5:
60 STLSoft 1.10 is the next version of STLSoft. As well as containing several
61 new components, it also incorporates wholesale refactoring of code and of
62 the structural aspects (including packaging and directories). STLSoft 1.10
63 is still in alpha-delta stage (see A6).
64
65
66 Q6: "How do I use STLSoft 1.10?"
67
68 A6:
69 While it's still in alpha stage, the STLSoft 1.10 releases are in "delta"
70 form, i.e. they must be "added" to an up-to-date STLSoft 1.9 distribution.
71 This is achieved in one of two ways:
72
73 (1) Overwrite
74
75 You download and install STLSoft 1.9 as per A2. You then download the
76 STLSoft 1.10 alpha-delta archive and extract it directly over the STLSoft
77 1.9 directory.
78
b3aebf0 Imported upstream 1.9.101
Stefan Naewe authored
79 (2) Include Path Interposition
a8d1000 Imported upstream 1.9.98
Stefan Naewe authored
80
81 You download and install STLSoft 1.9 as per A2. You then download the
82 STLSoft 1.10 alpha-delta archive and extract it to a separate directory,
83 defining an environment variable STLSOFT_1_10 to that directory. You then
84 specify the include paths in your IDE project files and in makefiles in
85 reverse order, as in:
86
87 * -I$STLSOFT_1_10/include -I$STLSOFT/include (if you're on UNIX), OR
b3aebf0 Imported upstream 1.9.101
Stefan Naewe authored
88 * -I%STLSOFT_1_10%/include -I%STLSOFT%/include (if you're on Windows)
a8d1000 Imported upstream 1.9.98
Stefan Naewe authored
89
90
91 We strongly recommend using method (2).
c5adab2 Imported Upstream version 1.9.52
Stefan Naewe authored
92
93
94 =============================== End of file ================================
Something went wrong with that request. Please try again.