Tree [143799] v0.1.10 /
History



File Date Author Commit
build 2013-06-25 laurent alonso laurent alonso [143799] Add a parser for BeagleWorks v1 and WordPerfect...
docs 2013-06-06 laurent alonso laurent alonso [af9e42] Merge branch 'master' into PRE-0.2.0
inc 2013-06-25 laurent alonso laurent alonso [143799] Add a parser for BeagleWorks v1 and WordPerfect...
src 2013-06-25 laurent alonso laurent alonso [143799] Add a parser for BeagleWorks v1 and WordPerfect...
.gitignore 2013-03-08 Fridrich Štrba Fridrich Štrba [a41524] Gitignore some stuff and remove autopackage tha...
CHANGES 2013-06-25 laurent alonso laurent alonso [143799] Add a parser for BeagleWorks v1 and WordPerfect...
COPYING.LGPL 2012-07-30 laurent alonso laurent alonso [125b48] Add MPL License + change all header to reflect ...
COPYING.MPL 2012-07-30 laurent alonso laurent alonso [3ce90c] Remove Exhibit B in COPYING.MPL
CREDITS 2013-05-08 laurent alonso laurent alonso [23beeb] check stat returned value in tools/file/xattr.c...
HACKING 2011-12-19 osnola osnola [a001e5] The sources...
INSTALL 2011-12-19 osnola osnola [a001e5] The sources...
Makefile.am 2013-05-14 Fridrich Štrba Fridrich Štrba [ca5841] Move public headers to separate directory so th...
README 2013-06-14 laurent alonso laurent alonso [028b03] Merge branch 'PRE-0.2.0'
autogen.sh 2012-03-24 osnola osnola [0e33ee] - small changes to compile with flags -Wextra a...
configure.ac 2013-06-14 laurent alonso laurent alonso [028b03] Merge branch 'PRE-0.2.0'
libmwaw-zip.in 2011-12-19 osnola osnola [a001e5] The sources...
libmwaw.pc.in 2013-05-14 Fridrich Štrba Fridrich Štrba [ca5841] Move public headers to separate directory so th...
libmwaw.spec.in 2012-01-15 osnola osnola [0cf438] - standardization of the cell positions and ext...

Read Me

INSTALLATION

General
=======

Since libmwaw was based on libwpd code (for convenience), you need to install
libwpd in order to build libmwaw. You can get libwpd from:

- libwpd <http://libwpd.sourceforge.net/download.html>

Unix/Linux/Darwin
==========

Installation on Unix/Linux/Darwin should be simple.
Simply execute the following sequence of commands:

./configure [--with-sharedptr=boost|c++11|tr1]; make ; sudo make install

Myself, I build using following options: "./configure --with-sharedptr=tr1"

Extensive installation instructions can be found in the INSTALL file.

Windows
=========================================
Beta tester needed to test the compilation and report problems

Windows - Microsoft(tm) Visual Studio/C++
=========================================

A workspace for MSVC6 can be found in the ./build/win32/ directory.
This workspace contains a projects file to compile a release version or 
a debug version of libmwaw. 

NOTE: Using the MSVC build system will result in a static library only. 
No dll can be created yet using this build system. If you want to create 
a dll, please use the MingW build system (see below for details).


Windows - MinGW
===============

First of all, in order to use libwpd in your application, you do not need
to build it yourself. If you have access to a binary distribution, you
are encouraged to use it. If for whatever reason you still want to build
libwpd using MinGW, read following instructions.


* Build environment and dependencies

In order to build libwpd, you have to have installed MinGW distribution from
http://www.mingw.org. Because the build system of libmwaw uses autotools, you
must install also the MSys packages. It is advisable to install all recent
packages into a path that does not contain spaces. Besides the MinGW
distribution, you have to install the _runtime_ and _development_ packages of
libmwaw dependency libwpd from libwpd.sourceforge.net/download.html. The packages
you need are libwpd-{version}-MinGW.zip and libwpd-devel-{version}-MinGW.zip


* Build procedure

1. Unpack the source code by running:

  gunzip -dc libmwaw-{version}.tar.gz | tar xpf

You can also use WinZip or any other GUI compression tool.

2. Next, run:

  export ACLOCAL_FLAGS='-I <pkg-config installation prefix>/share/aclocal'; \
  ./autogen.sh

Some versions of libtool have bug that prevents MinGW from creating shared
libraries. The autogen.sh script "libtoolizes" the package using the libtool
included with MinGW distribution. Like that you are sure that your libtool is
able to create DLLs.
The ACLOCAL_FLAGS variable is there in order to allow the auto* scripts to find
the pkg.m4 macro that is part of the pkg-config distribution. If this macro is
not found, the generated configure script will be ending with an error.

3. Time to configure libmwaw; run:

  ./configure [--prefix=<target>] [--enable-static] [--disable-shared] [--with-sharedptr=boost|c++11|tr1]

By default, the configure script uses as prefix "/usr/local" and configures to
create only shared libraries.

4. Nearly done. Make sure you have a clean build by running:
 
  make clean all

5. And last but not least, compile and install libmwaw by running:

  make install [-i]

If you configure using "--enable-static --disable-shared" (pure static library
creation), the libtool import libraries are not created. Make will try to install
them and will stop with error. The "-i" option makes it to report the error, but
not to stop. Like that the installation will succeed.

Mwaw2odt
===============
If we want to compile mwaw2odt ( which is a part of writerperfect), you
must first download the last version of libwpg in http://sourceforge.net/projects/libwpg/
and then download the lastest git version of odfgen and writerperfect:
  git clone git://git.code.sf.net/p/libwpd/libodfgen libwpd-libodfgen
  git clone git://git.code.sf.net/p/libwpd/writerperfect libwpd-writerperfect
and finally, in each directories, execute autogen.sh and configure
with the options corresponding to you computer and launch make to
recompile.

That's all folks! While no mailing exists, for more information, ask
questions directly to osnola@users.sourceforge.net. Remember that Uncle Google can
also be of big help especially when the problem is not with libmwaw, but with one of its 
dependencies.