Ceylan troubleshooting

Overview

This section tries to help the Ceylan users with all the issues they can encounter when building or installing the Ceylan library. More precisely, this section focuses on Ceylan internal issues. To deal with errors lying on the user code specifically (when the Ceylan library is misused), then refer to the Ceylan user's guide troubleshooting section.

Issues and solutions

While building Ceylan or a related application or library, I get: libtool: unrecognized option `--tag=CXX' Try `libtool --help' for more information.

The libtool version found in your PATH is too old. If the checktools make target is evaluated, then the most ancient supported version for libtool will be displayed with the found one, in yellow. Just check that yours is more recent than the requested version. For example, libtool found, using [version 1.4.3, must be 1.5.2 or higher] will probably lead to build failures.

Compile error in CeylanTypes.h: size of array CEYLAN_stop_wrong_size_for_XXX is negative

This error has been triggered by the Ceylan build system because one of the basic data types which have been defined by Ceylan is not of the expected size.

For example, Sint16 should be a signed integer on 16 bits. If ever, on a specific platform and with a specific compiler, Ceylan assumption was wrong about the size in memory of a data type, the previous error is fired.

You therefore have found a bug in Ceylan, please click here to send us a bug report (it should take you less than half a minute to do so), telling us what is your compiler (name and version), what is your platform (CPU and OS) and which data type failed (the XXX in CEYLAN_stop_wrong_size_for_XXX). Thank you !

While building Ceylan or a related application or library, I get: Creating executable XXX on YYY: libtool: link: warning: library `ZZZ' was moved.

This is a libtool joke, this build system detects a library was moved and complains. To the best of our knowledge, this message does not matter at all. We did not manage yet to get rid of it for the prerequesite libraries we use (ex: libSDL_image.la).

I changed a test (ex: tests/testTime.cc), it was built but it does not seem to be taken into account on my installation

Be sure to run make all from the root directory (ex: $CEYLAN_ROOT/src): only the main makefile has for purpose to install the examples. Executing a make from test directory will build it, not install it. To check, just look at the dates of the executable to be found under $CEYLAN_ROOT/bin.

How to view correctly the Ceylan (and OSDL) source files ?

To get rid of annoying issues with tabulation length and window sizes, we recommend using nedit (or its counterpart nc) as source code editor, with following settings:

• tabulations (Preferences->Tabs) : Tab spacing (for hardware tab characters): 4, with no tabs emulated, with use of tab characters in padding and emulated tabs
• window size (Preferences->Default Settings->Initial Window Size->Custom): enter 60x100, and remember to select afterwards Preferences->Save Defaults

I want to add a new module or sub-module to Ceylan

Please refer to the relevant section of the OSDL User's Guide.