doc/README.FreeBSD

   1                             FreeBSD notes
   2
   3 The build tree  for Dolda Connect is not very  portable at the moment,
   4 but work is under way to fix that. For now, at least the daemon should
   5 be possible to  build on FreeBSD (though the ability to  run it is not
   6 guaranteed ;),  but even that requires some  special care. Eventually,
   7 all this should be fixed.
   8
   9                           For SVN/GIT users
  10
  11 First of  all, if you have  gotten this copy of  Dolda Connect through
  12 Subversion  or git,  you would  normally need  to run  the `bootstrap'
  13 script to create the `configure'  script. However, it does not work in
  14 FreeBSD, since the  FreeBSD configuration of aclocal is  a bit broken.
  15 Instead, you will need to run the following commands manually:
  16
  17 $ autopoint
  18 $ aclocal -I m4 -I /usr/local/share/aclocal
  19 $ autoheader
  20 $ libtoolize --copy --force
  21 $ automake --add-missing --copy
  22 $ autoconf
  23
  24 Note, also, that FreeBSD  does not install version-number free aliases
  25 of these commands, so the appropriate versions must be added, which is
  26 easily done with the help of tab completion.
  27
  28 Of course,  none of the  above is required  for the tarball  copies of
  29 Dolda Connect, which already have these steps completed for you.
  30
  31                              For everyone
  32
  33 When compiling  Dolda Connect, there are also  some caveats. FreeBSD's
  34 libc does  not have an  implementation of the iconv(3)  functions, and
  35 Dolda Connect's  `configure' script cannot  detect that automatically,
  36 yet.
  37
  38 Also,  Dolda Connect  uses  a lot  of  libraries that  are located  in
  39 /usr/local/lib, but by  default, the FreeBSD linker does  not look for
  40 libraries there.
  41
  42 Therefore, the  linker must be passed  the arguments `-L/usr/local/lib
  43 -liconv' to  compile Dolda Connect. The  easiest way to do  that is to
  44 pass it via the `configure' script, like this:
  45
  46 $ ./configure other_args... "LDFLAGS=-L/usr/local/lib -liconv"
  47
  48 You may or may not also want  to pass `CFLAGS=-g' as well, to ease any
  49 debugging.