extensions/README.md

   1 # Miscellaneous Modules
   2
   3 This module contains a grab-bag of unrelated miscellaneous libraries, *none* of
   4 which is an extension.
   5
   6 ## Application Online Update Checking
   7
   8 When we start LO, first `InitUpdateCheckJobThread` is created, via
   9 `UpdateCheckJob::execute()` (from `extensions/source/update/check/updatecheckjob.cxx`),
  10 as a reaction to a `onFirstVisibleTask` event. It waits 25 seconds (so that it
  11 does not interfere with the startup itself), and then calls
  12 `UpdateCheck::initialize()` (from `extensions/source/update/check/updatecheck.cxx`).
  13
  14 This creates one more thread, `UpdateCheckThread`, that regularly checks whether
  15 we have reached the time when we should ask for the update.  If yes, asks for
  16 that, and shows the download button in the menu (if the new update is
  17 available).
  18
  19 ## OLE Automation Bridge
  20
  21 A bridge between "OLE automation" and UNO, so you can use UNO services
  22 from JScript, VBScript, etc.
  23
  24 <https://www.openoffice.org/udk/common/man/spec/ole_bridge.html>
  25
  26 See `udkapi/com/sun/star/bridge/oleautomation/ApplicationRegistration.idl`
  27
  28 This is initialized in `Desktop::Main()` in `Desktop::OpenClients_Impl()`
  29 by creating the service `com.sun.star.bridge.OleApplicationRegistration`,
  30 which is implemented by `OleServer_Impl`.
  31
  32 See `extensions/source/ole/`
  33
  34 ## ActiveX Control
  35
  36 This allows embedding LO into a Win32 application as an ActiveX control.
  37
  38 See `extensions/source/activex/`
  39
  40 ## Spotlight Provider
  41
  42 On macOS, this allows indexing ODF documents with Spotlight.
  43
  44 See `extensions/source/macosx/spotlight/`
  45
  46 ## Scanner Support
  47
  48 You can scan from LibreOffice, using platform specific backends like TWAIN/SANE.
  49
  50 See `extensions/source/scanner/`
  51