Clean up offapi/type_reference/ documentation

Change-Id: I07d79291d161cf5c1ecc9db557d5025437ca2cc1

offapi/README

@@ -2,3 +2,10 @@ Contains all of the IDL files except those in [[udkapi]]
 
 i.e. the interfaces that are specific to the OppenOffice.org application.
 An artificial (?) separation.
+
+The reference offapi/type_reference/types.rdb, used to detect inadvertent
+incompatible changes, is maintained via offapi/type_reference/update-rdb.sh (see
+its usage message for details) for cases where we deliberately /do/ become
+incompatible.  Old such cases are listed in
+offapi/type_reference/typelibrary_history.txt, new such cases are recorded in
+the git log of offapi/type_reference/types.rdb.

offapi/type_reference/typelibrary_history.txt

@@ -16,26 +16,6 @@
 #   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 #
 
-Example of updating an incompatibly-changed type (com.sun.star.script.Converter,
-in this example) in the accompanying types.rdb (see also update-rdb.sh):
-
-.../core> mkdir tmp
-.../core> LD_LIBRARY_PATH=.../core/solver/unxlngx6/lib \
- solver/unxlngx6/bin/regmerge tmp/out1.rdb /UCR \
- workdir/unxlngx6/UnoApiPartTarget/udkapi/com/sun/star/script/Converter.urd
-.../core> LD_LIBRARY_PATH=.../core/solver/unxlngx6/lib \
- solver/unxlngx6/bin/regmerge tmp/out2.rdb / offapi/type_reference/types.rdb \
- tmp/out1.rdb
-.../core> diff <(LD_LIBRARY_PATH=.../core/solver/unxlngx6/lib \
- solver/unxlngx6/bin/regview offapi/type_reference/types.rdb) \
- <(LD_LIBRARY_PATH=.../core/solver/unxlngx6/lib solver/unxlngx6/bin/regview \
- tmp/out2.rdb) # sanity check
-.../core> mv tmp/out2.rdb offapi/type_reference/types.rdb
-.../core> rm -rf tmp
-
-
-
-
 07/07/2004 (SB): BugID=i29741
   Reference registries for the OOo 2.0 branch copied from the OOo 1.1 branch:
     OO_20/types.rdb <- OO_11/types.rdb 1.6