summaryrefslogtreecommitdiffstats
path: root/extensions/README.md
blob: cc32c1f825cb81489a1f12454272acff652c0914 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# Miscellaneous Modules

This module contains a grab-bag of unrelated miscellaneous libraries, *none* of
which is an extension.

## Application Online Update Checking

When we start LO, first `InitUpdateCheckJobThread` is created, via
`UpdateCheckJob::execute()` (from `extensions/source/update/check/updatecheckjob.cxx`),
as a reaction to a `onFirstVisibleTask` event. It waits 25 seconds (so that it
does not interfere with the startup itself), and then calls
`UpdateCheck::initialize()` (from `extensions/source/update/check/updatecheck.cxx`).

This creates one more thread, `UpdateCheckThread`, that regularly checks whether
we have reached the time when we should ask for the update.  If yes, asks for
that, and shows the download button in the menu (if the new update is
available).

The update server will decide if there is an update available based on the user-agent
string created by UpdateInformationProvider::getUserAgent, the data used there is
extracted from instdir/program/versionrc and the update server takes the buildid into
account, so to experiment with the updates from a dev version getUserAgent needs
to return a recognized id.

## OLE Automation Bridge

A bridge between "OLE automation" and UNO, so you can use UNO services
from JScript, VBScript, etc.

<https://www.openoffice.org/udk/common/man/spec/ole_bridge.html>

See `udkapi/com/sun/star/bridge/oleautomation/ApplicationRegistration.idl`

This is initialized in `Desktop::Main()` in `Desktop::OpenClients_Impl()`
by creating the service `com.sun.star.bridge.OleApplicationRegistration`,
which is implemented by `OleServer_Impl`.

See `extensions/source/ole/`

## ActiveX Control

This allows embedding LO into a Win32 application as an ActiveX control.

See `extensions/source/activex/`

## Spotlight Provider

On macOS, this allows indexing ODF documents with Spotlight.

See `extensions/source/macosx/spotlight/`

## Scanner Support

You can scan from LibreOffice, using platform specific backends like TWAIN/SANE.

See `extensions/source/scanner/`