File: INSTALL

package info (click to toggle)
libcrcutil 1.0-5.4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 3,212 kB
  • sloc: cpp: 4,237; sh: 1,112; ansic: 191; makefile: 54; awk: 17
file content (65 lines) | stat: -rw-r--r-- 1,700 bytes parent folder | download | duplicates (11)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
Since crcutil is a library, and rather small, template library,
it is better to compile it directly into your code. Or you could
build a library for interface.cc and use it.


Building and running the tests (Linux/GCC, MacOSX/GCC)
------------------------------------------------------

Run
  ./autogen.sh <target> <compiler_flags>
or
  ./autogen.sh <target> "-m32 -march=i686 <compiler_flags>"
to build and run 64-bit and 32-bit <target> with GCC.

Typically, <compiler_flags> is not required.

Useful values for <target> are:
  clean
  configure
  check

E.g.
  ./autogen.sh check
will build and run 64-bit unittest, whilst
  ./autogen.sh clean
will clean everything up.


Why ./autogen.sh? Two reasons:

1. Automake is well beyond my comprehension, and I am unable to create
   "Makefile.am" consistently. So autogen.sh has that piece of black magic.

2. autogen.sh detects version of GCC and provides different compile options
   to work around differences between compiler versions that cannot
   be detected at compile time.

You still can do
  ./configure CXXFLAGS="-O3" CFLAGS="-O3"
(if you use GCC before 4.5.0) or
  ./configure CXXFLAGS="-O3 -mcrc32" CFLAGS="-O3"
and then run
  make check
but the use of "./autogen.sh" is the preferred way to go.


Building and running the tests (Windows, CL or ICL compiler)
------------------------------------------------------------

Run
  nmake -f Makefile.win cl64
or
  nmake -f Makefile.win cl32
or
  nmake -f Makefile.win icl64
or
  nmake -f Makefile.win icl32
to build and 64-bit and 32-bit unit test using
Microsoft CL and Intel's ICL compilers respectively.

Run
  nmake -f Makefile.win clean
to clean everything up.

[The end of the document]