binfilters are input/output filters for the old binary file formats that were
used by StarOffice 5.x and older versions for saving documents. They have been
made optional since OOo-2.0. It is a very huge, old, and horrible piece of code.
The filters are diabled in ooo-build by default because:

	* these old formats are not used widely
	* it makes the build much faster
	* it makes the maintenace much easier


How to build OOo with the binfilters?

1. Download the binfilter source tarball from http://go-ooo.org. They are next
   to the core source tarball, for example:

	http://go-ooo.org/packages/SRC680/src680-m100-binfilter.tar.bz2
	http://go-ooo.org/packages/SRC680/src680-m100-core.tar.bz2

   , and put the source tarball into the ooo-build/src directory

2. Enable the binfilters:

	./configure --enable-binfilter

   Note that there is used --disable-binfilter in
   ooo-build/distro-configs/Common.conf.in, so you must use this even if
   the binfilters are enabled by default in the OOo-native configure script


How to create an optional package with binfilters?

It is not an easy task and ooo-build has not support it yet.

1. The following files belong to the optional package (checked with m104):

program/legacy_binfilters.rdb
program/libbf_frm680li.so
program/libbf_lng680li.so
program/libbf_migratefilter680li.so
program/libbf_ofa680li.so
program/libbf_sc680li.so
program/libbf_sd680li.so
program/libbf_sch680li.so
program/libbf_sm680li.so
program/libbf_svx680li.so
program/libbf_sw680li.so
program/libbf_wrapper680li.so
program/libbf_xo680li.so
program/libbindet680li.so
program/liblegacy_binfilters680li.so
program/resource/bf_frm680en-US.res
program/resource/bf_ofa680en-US.res
program/resource/bf_sc680en-US.res
program/resource/bf_sd680en-US.res
program/resource/bf_sfx680en-US.res
program/resource/bf_sch680en-US.res
program/resource/bf_sm680en-US.res
program/resource/bf_svx680en-US.res
program/resource/bf_sw680en-US.res

2. The filters has to be be registered/unregistered dependind on if they are
installed or not. It is really important because OOo crashes if the filters
are registered, the related plugins and resources are not installed, and
the user tries to open an old StarOffice document. The registration is done
in OOo registry.

For example, the following snippet has to be added into
registry/modules/org/openoffice/TypeDetection/Filter/fcfg_writer_filters.xcu
to enable the StarWriter 1.0 input/output filter:

       <node oor:name="StarWriter 1.0" oor:op="replace" oor:finalized="true" oor:mandatory="true"> 
               <prop oor:name="Flags"><value>IMPORT ALIEN</value></prop> 
               <prop oor:name="UIComponent"/> 
               <prop oor:name="FilterService"/> 
               <prop oor:name="UserData"><value>SWG1</value></prop> 
               <prop oor:name="UIName"> 
                       <value xml:lang="x-default">StarWriter 1.0</value> 
               </prop> 
               <prop oor:name="FileFormatVersion"><value>0</value></prop> 
               <prop oor:name="Type"><value>writer_StarWriter_10</value></prop> 
               <prop oor:name="TemplateName"/> 
               <prop oor:name="DocumentService"><value>com.sun.star.text.TextDocument</value></prop> 
       </node> 

And it has to be removed if you remove the module and resources related to the
filter.19;5~

