libtabula

Check-in [e8696effde]
Login

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Fixed references to README-Mac-OS-X.md
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1:e8696effdefd053176b45b2075916a7290a3a521
User & Date: tangent 2018-10-27 07:30:13
Context
2018-10-28
10:47
Updated the Doxyfile.in files for Doxygen 1.8.14. check-in: f3a0657c56 user: tangent tags: trunk
2018-10-27
07:30
Fixed references to README-Mac-OS-X.md check-in: e8696effde user: tangent tags: trunk
07:27
Renamed README-Mac-OS-X.md to README-macOS.md. check-in: 5b39c725dd user: tangent tags: trunk
Changes
Hide Diffs Unified Diffs Ignore Whitespace Patch

Changes to INSTALL.md.

3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

The installation procedure depends on the compiler you use to build
libtabula and on the OS you build it on.  There are platform-specific
instructions for all popular platforms:

* [Cygwin](README-Cygwin.md)
* [Linux](README-Linux.md)
* [Mac OS X](README-Mac-OS-X.md)
* [MinGW](README-MinGW.md)
* [Solaris](README-Solaris.md)
* [Visual C++](README-Visual-C%2b%2b.md)

If you're on some Unix variant (Linux, OS X, \*BSD, Solaris,
Cygwin...)  there are additional general instructions in [the Unix
README](README-Unix.md).

See [the main README file](README.md) for high-level instructions
that apply to all platforms libtabula works on.







|










3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

The installation procedure depends on the compiler you use to build
libtabula and on the OS you build it on.  There are platform-specific
instructions for all popular platforms:

* [Cygwin](README-Cygwin.md)
* [Linux](README-Linux.md)
* [macOS](README-macOS.md)
* [MinGW](README-MinGW.md)
* [Solaris](README-Solaris.md)
* [Visual C++](README-Visual-C%2b%2b.md)

If you're on some Unix variant (Linux, OS X, \*BSD, Solaris,
Cygwin...)  there are additional general instructions in [the Unix
README](README-Unix.md).

See [the main README file](README.md) for high-level instructions
that apply to all platforms libtabula works on.

Changes to README-Unix.md.

6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

This file only covers details common to all Unix variants supported by
libtabula  For platform-specific details, see the file appropriate to
your OS:

*   [Cygwin](README-Cygwin.md)
*   [Linux](README-Linux.md)
*   [Mac OS X](README-Mac-OS-X.md)
*   [Solaris](README-Solaris.md)

There are no special instructions for any other Unix flavors.


Building the Library and Example Programs
----







|







6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

This file only covers details common to all Unix variants supported by
libtabula  For platform-specific details, see the file appropriate to
your OS:

*   [Cygwin](README-Cygwin.md)
*   [Linux](README-Linux.md)
*   [macOS](README-macOS.md)
*   [Solaris](README-Solaris.md)

There are no special instructions for any other Unix flavors.


Building the Library and Example Programs
----

Changes to README.md.

34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
..
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
..
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
----

Each major platform we support has a dedicated `README-*.md` file for
it containing information specific to that platform.  Please read it:

*   [Cygwin](README-Cygwin.md)
*   [Linux](README-Linux.md)
*   [Mac OS X](README-Mac-OS-X.md)
*   [MinGW](README-MinGW.md)
*   [Solaris](README-Solaris.md)
*   [Unix (generic)](README-Unix.md)
*   [Visual C++](README-Visual-C%2b%2b.md)

For authorship information, see [the CREDITS file](CREDITS.md).

................................................................................
Building the Library
----

libtabula uses [CMake][4] to generate platform-specific build files
from a platform-independent set of build rules.  We have successfully
used it to build libtabula under these native build system types:

*   **Makefiles**: For Unixy platforms, including Linux, Mac OS X,
    Cygwin, and MinGW, in addition to the "real" Unices.
    
    See [the Unix README](README-Unix.md) for general instructions.

    There are supplementary platform-specific `README` files for most
    popular Unixy platforms:

    -   [Cygwin](README-Cygwin.md)
    -   [Linux](README-Linux.md)
    -   [Mac OS X](README-Mac-OS-X.md)
    -   [MinGW](README-MinGW.md)
    -   [Solaris](README-Solaris.md)

    TODO: Write README-Free/Net/OpenBSD.md, if only to mention the
    location for C API files.

    If your platform of choice doesn't have a `README` dedicated
................................................................................
    
    See [the Visual C++ README](README-Visual-C%2b%2b.md) for more
    details.

*   **Xcode**: CMake will generate an Xcode project file instead of
    Makefiles on OS X if you ask nicely.

    See [the Mac OS X README](README-Mac-OS-X.md) for more the proper
    incantation.

CMake can generate many other kinds of IDE project files, but we have
either not tried it, or have not succeeded with it.  Success reports
and patches are welcome on the mailing list.[3]









|







 







|









|







 







|







34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
..
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
..
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
----

Each major platform we support has a dedicated `README-*.md` file for
it containing information specific to that platform.  Please read it:

*   [Cygwin](README-Cygwin.md)
*   [Linux](README-Linux.md)
*   [macOS](README-macOS.md)
*   [MinGW](README-MinGW.md)
*   [Solaris](README-Solaris.md)
*   [Unix (generic)](README-Unix.md)
*   [Visual C++](README-Visual-C%2b%2b.md)

For authorship information, see [the CREDITS file](CREDITS.md).

................................................................................
Building the Library
----

libtabula uses [CMake][4] to generate platform-specific build files
from a platform-independent set of build rules.  We have successfully
used it to build libtabula under these native build system types:

*   **Makefiles**: For Unixy platforms, including Linux, macOS,
    Cygwin, and MinGW, in addition to the "real" Unices.
    
    See [the Unix README](README-Unix.md) for general instructions.

    There are supplementary platform-specific `README` files for most
    popular Unixy platforms:

    -   [Cygwin](README-Cygwin.md)
    -   [Linux](README-Linux.md)
    -   [macOS](README-macOS.md)
    -   [MinGW](README-MinGW.md)
    -   [Solaris](README-Solaris.md)

    TODO: Write README-Free/Net/OpenBSD.md, if only to mention the
    location for C API files.

    If your platform of choice doesn't have a `README` dedicated
................................................................................
    
    See [the Visual C++ README](README-Visual-C%2b%2b.md) for more
    details.

*   **Xcode**: CMake will generate an Xcode project file instead of
    Makefiles on OS X if you ask nicely.

    See [the macOS README](README-macOS.md) for more the proper
    incantation.

CMake can generate many other kinds of IDE project files, but we have
either not tried it, or have not succeeded with it.  Success reports
and patches are welcome on the mailing list.[3]


Changes to doc/userman/configuration.dbx.

42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
    <computeroutput>--with-mysql-lib</computeroutput> flags. See
    <filename>README-Unix.md</filename> for details.</para>

    <para>If you need to modify the build system files, per-platform
    instructions are in
    <filename>README-Visual-Studio.md</filename>,
    <filename>README-MinGW.md</filename>, and
    <filename>README-Mac-OS-X.md</filename>.</para>
  </sect2>


  <sect2 id="max-fields">
    <title>The Maximum Number of Fields Allowed</title>

    <para>libtabula offers two ways to automatically build







|







42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
    <computeroutput>--with-mysql-lib</computeroutput> flags. See
    <filename>README-Unix.md</filename> for details.</para>

    <para>If you need to modify the build system files, per-platform
    instructions are in
    <filename>README-Visual-Studio.md</filename>,
    <filename>README-MinGW.md</filename>, and
    <filename>README-macOS.md</filename>.</para>
  </sect2>


  <sect2 id="max-fields">
    <title>The Maximum Number of Fields Allowed</title>

    <para>libtabula offers two ways to automatically build

Changes to doc/userman/incorporating.dbx.

257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
      OS X.</para>

      <para>One thing that may trip you up on OS X is that it uses an
      uncommon dynamic linkage system. The easiest way to cope with
      this is to link your executables with the compiler, rather than
      call <filename>ld</filename> directly.</para>

      <para>Another tricky bit on OS X is the concept of Universal
      binaries. See <filename>README-Mac-OS-X.md</filename> for
      details on building a Universal version of the libtabula library,
      if you need one. By default, you only get a version tuned for
      the system type you build it on.</para>
    </sect3>

    <sect3 id="inc-osx-xcode">
      <title>Xcode</title>







|
|







257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
      OS X.</para>

      <para>One thing that may trip you up on OS X is that it uses an
      uncommon dynamic linkage system. The easiest way to cope with
      this is to link your executables with the compiler, rather than
      call <filename>ld</filename> directly.</para>

      <para>Another tricky bit on macOS is the concept of Universal
      binaries. See <filename>README-macOS.md</filename> for
      details on building a Universal version of the libtabula library,
      if you need one. By default, you only get a version tuned for
      the system type you build it on.</para>
    </sect3>

    <sect3 id="inc-osx-xcode">
      <title>Xcode</title>