Test repository to check push and ssh key
Find a file
Noel Grandin 6f07012a34 use officecfg to retrieve AutoSave
Change-Id: I613ca68123cfd316cd4e6384f743aa6756d9291d
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/119459
Tested-by: Jenkins
Reviewed-by: Noel Grandin <noel.grandin@collabora.co.uk>
2021-07-24 22:52:27 +02:00
.git-hooks
.github
.vscode
accessibility
android
animations
apple_remote
avmedia tdf#126665 Remember last used file picker directory 2021-07-12 14:31:20 +02:00
basctl Move svl::Items to include/svl/whichranges.hxx, and unify its usage 2021-07-19 16:33:01 +02:00
basegfx
basic tdf#143332 - Use utl::TextSearch to implement the InStrRev function 2021-07-19 13:03:22 +02:00
bean
bin find-unneeded-includes: Add --headers option 2021-07-15 11:59:52 +02:00
binaryurp binaryurp : use std::mutex in outgoingrequests 2021-07-18 11:37:21 +02:00
bridges flatten RTTI code 2021-07-19 17:52:15 +02:00
canvas
chart2 use officecfg to retrieve PrettyPrinting 2021-07-24 09:57:08 +02:00
cli_ure
codemaker
comphelper osl::Mutex->std::mutex in AsyncEventNotifier 2021-07-23 09:59:13 +02:00
compilerplugins no need to allocate these static vars on demand 2021-07-23 11:22:59 +02:00
config_host
configmgr Revert "simplify locking in configmgr" 2021-07-22 21:17:15 +02:00
connectivity
cppcanvas
cppu osl::Mutex->std::mutex in MappingsData 2021-07-19 08:54:19 +02:00
cppuhelper better to use a std::vector here 2021-07-18 11:34:39 +02:00
cpputools
cui use officecfg to retrieve AutoSave 2021-07-24 22:52:27 +02:00
dbaccess use officecfg to retrieve SaveRelFSys 2021-07-24 16:52:52 +02:00
desktop flatten vcl::LazyDelete 2021-07-22 10:15:49 +02:00
dictionaries@01bb1d2c47
distro-configs
drawinglayer flatten vcl::LazyDelete 2021-07-22 10:15:49 +02:00
editeng Make static_casting to the only derived class less verbose 2021-07-22 17:25:12 +02:00
embeddedobj sfx2: handle OnMainThread=true in SfxOfficeDispatch::dispatch() 2021-07-14 11:52:00 +02:00
embedserv
emfio Enable automatic code style formatting for EmfImportTest.cxx 2021-07-13 22:49:04 +02:00
eventattacher osl::Mutex->std::mutex in EventAttacherImpl 2021-07-18 14:54:35 +02:00
extensions do not use "using namespace std" in headers 2021-07-23 10:32:08 +02:00
external curl: upgrade to release 7.78.0 2021-07-22 09:09:30 +02:00
extras Addition of OpenSymbol2 2021-07-24 15:21:11 +02:00
filter IsVertical->IsEffectivelyVertical, GetDirectVertical->GetVertical 2021-07-21 14:03:49 +02:00
forms IsVertical->IsEffectivelyVertical, GetDirectVertical->GetVertical 2021-07-21 14:03:49 +02:00
formula
fpicker
framework use officecfg to retrieve DisableUICustomization 2021-07-23 14:01:23 +02:00
helpcompiler
helpcontent2@36052eea4f Update git submodules 2021-07-24 22:05:43 +02:00
hwpfilter Fix typo 2021-07-19 19:49:09 +02:00
i18nlangtag Resolves: tdf#123466 Add Microsoft ill-used {x-none} to known language tags 2021-07-12 22:00:10 +02:00
i18npool do not use "using namespace std" in headers 2021-07-23 10:32:08 +02:00
i18nutil Add PowerPoint compatible screen size for Impress 2021-07-13 13:05:34 +02:00
icon-themes elementary tdf#143300 add diagonal border line icons 2021-07-22 20:33:08 +02:00
idl
idlc no need to allocate these static vars on demand 2021-07-23 11:22:59 +02:00
include use officecfg to retrieve AutoSave 2021-07-24 22:52:27 +02:00
instsetoo_native
io
ios
javaunohelper
jurt
jvmaccess
jvmfwk loplugin:indentation (clang-cl) 2021-07-09 09:15:52 +02:00
l10ntools
librelogo
libreofficekit
lingucomponent do not use "using namespace std" in headers 2021-07-23 10:32:08 +02:00
linguistic osl::Mutex->std::mutex in linguistic 2021-07-18 20:47:06 +02:00
lotuswordpro Fix typo 2021-07-19 19:49:09 +02:00
m4
nlpsolver AbsGTBehavior should implement ILibEngine 2021-07-19 18:01:24 +02:00
o3tl
odk Fix typos 2021-07-18 12:14:16 +02:00
offapi sw bibliography, local copy: add document model & UNO API 2021-07-21 16:42:48 +02:00
officecfg tdf#140107 Remove all collect usage data code. 2021-07-23 13:29:22 +02:00
onlineupdate
oovbaapi
oox tdf#143528 Use triple backquotes+xml to markdown xml part in oox/README.md 2021-07-24 20:09:27 +02:00
opencl
osx
package pass ZipEnumeration around by value 2021-07-21 12:20:23 +02:00
pch
postprocess tdf#133368: update extensions website URLs and use https 2021-07-07 12:45:35 +02:00
pyuno
qadevOOo
readlicense_oo update credits 2021-07-16 23:09:42 +02:00
registry -Werror=maybe-uninitialized 2021-07-22 08:15:30 +02:00
remotebridges
reportbuilder
reportdesign use officecfg to retrieve SaveRelFSys 2021-07-24 16:52:52 +02:00
ridljar
sal no need to allocate these static vars on demand 2021-07-23 11:22:59 +02:00
salhelper
sax Use existing rtl_math_stringToDouble 2021-07-21 15:38:03 +02:00
sc use officecfg to retrieve SaveRelInet 2021-07-24 18:04:26 +02:00
scaddins
sccomp
schema sw bibliography, local copy: add ODF filter 2021-07-23 14:34:35 +02:00
scp2
scripting
sd use officecfg to retrieve AutoSave 2021-07-24 22:52:27 +02:00
sdext poppler 0.73 doesn't have GooString::append(const std::string&) 2021-07-18 16:47:29 +02:00
setup_native
sfx2 use officecfg to retrieve AutoSave 2021-07-24 22:52:27 +02:00
shell do not use "using namespace std" in headers 2021-07-23 10:32:08 +02:00
slideshow workaround accumulate() ambiguity on Mac with PCH 2021-07-23 10:31:51 +02:00
smoketest
solenv do not use "using namespace std" in headers 2021-07-23 10:32:08 +02:00
soltools
sot
starmath use officecfg to retrieve PrettyPrinting 2021-07-24 09:57:08 +02:00
stoc osl::Mutex->std::mutex in ImplementationEnumeration_Impl 2021-07-19 08:54:03 +02:00
store
svgio
svl expand out contractions in PasswordContainer 2021-07-23 12:36:15 +02:00
svtools use officecfg to retrieve offlinehelppopup 2021-07-24 13:17:39 +02:00
svx tdf#143514: Avoid double-free in dbgutil code 2021-07-23 20:06:49 +02:00
sw Fix typo 2021-07-24 19:35:41 +02:00
swext
sysui tdf#133368: update extensions website URLs and use https 2021-07-07 12:45:35 +02:00
test Avoid external processes picking up instdir/program/libnspr4.so 2021-07-21 15:27:02 +02:00
testtools
toolkit remove pimpl in AnimatedImagesControlModel 2021-07-22 08:58:31 +02:00
tools tdf#143148 Use pragma once instead of include guards 2021-07-15 08:06:11 +02:00
translations@299af21d9c Update git submodules 2021-07-09 16:19:07 +02:00
ucb no need for a pimpl in ResultSetDataSupplier 2021-07-20 11:55:49 +02:00
ucbhelper no need to allocate Sequence separately in CommandProcessorInfo 2021-07-20 14:52:04 +02:00
udkapi
uitest
UnoControls fix the mutex locking in impl_searchTopic 2021-07-22 18:50:49 +02:00
unodevtools
unoidl
unoil
unotest Avoid external processes picking up instdir/program/libnspr4.so 2021-07-21 15:27:02 +02:00
unotools use officecfg to retrieve AutoSave 2021-07-24 22:52:27 +02:00
unoxml
ure
uui
vbahelper
vcl no need to allocate these static vars on demand 2021-07-23 11:22:59 +02:00
wasm-qt
winaccessibility wina11y: Deduplicate mapping for IA2TextBoundaryType 2021-07-21 14:35:49 +02:00
wizards ScriptForge - Change copyright dates and names 2021-07-23 18:36:58 +02:00
writerfilter Fix typo 2021-07-24 19:35:05 +02:00
writerperfect
xmerge
xmlhelp Avoid strtol on non-NUL-terminated input 2021-07-23 14:03:11 +02:00
xmloff sw bibliography, local copy: add ODF filter 2021-07-23 14:34:35 +02:00
xmlreader
xmlscript
xmlsecurity pass SvXMLNamespaceMap around by value 2021-07-22 10:16:20 +02:00
.buckconfig
.buckversion
.clang-format
.editorconfig
.git-blame-ignore-revs
.gitattributes
.gitignore
.gitmodules
.gitpod.dockerfile
.gitpod.yml
.gitreview
antivirusDetection.vbs
autogen.sh
BUCK
config.guess
config.sub
config_host.mk.in
config_host_lang.mk.in
configure.ac
COPYING
COPYING.LGPL
COPYING.MPL
download.lst curl: upgrade to release 7.78.0 2021-07-22 09:09:30 +02:00
g Add "--progress" agument to the ./g command 2021-07-12 10:55:05 +02:00
hardened_runtime.xcent.in
install-sh
install_deps.sh
leak-suppress.txt
Library_merged.mk
lo.xcent
logerrit Make logerrit more portable 2021-07-13 10:28:36 +02:00
Makefile.fetch
Makefile.gbuild
Makefile.in Avoid bash'ism (comment in line continuation) 2021-07-19 23:55:58 +02:00
README.cross
README.help.md
README.md
README.Solaris
README.wasm
Repository.mk
RepositoryExternal.mk curl: upgrade to release 7.78.0 2021-07-22 09:09:30 +02:00
RepositoryFixes.mk
RepositoryModule_build.mk
RepositoryModule_host.mk
sanitize-ubsan-excludelist
setup.cfg
TEMPLATE.SOURCECODE.HEADER

LibreOffice

Coverity Scan Build Status CII Best Practices Translation status

LibreOffice is an integrated office suite based on copyleft licenses and compatible with most document formats and standards. Libreoffice is backed by The Document Foundation, which represents a large independent community of enterprises, developers and other volunteers moved by the common goal of bringing to the market the best software for personal productivity. LibreOffice is open source, and free to download, use and distribute.

A quick overview of the LibreOffice code structure.

Overview

You can develop for LibreOffice in one of two ways, one recommended and one much less so. First the somewhat less recommended way: it is possible to use the SDK to develop an extension, for which you can read the API docs here and here. This re-uses the (extremely generic) UNO APIs that are also used by macro scripting in StarBasic.

The best way to add a generally useful feature to LibreOffice is to work on the code base however. Overall this way makes it easier to compile and build your code, it avoids any arbitrary limitations of our scripting APIs, and in general is far more simple and intuitive - if you are a reasonably able C++ programmer.

The Build Chain and Runtime Baselines

These are the current minimal operating system and compiler versions to run and compile LibreOffice, also used by the TDF builds:

  • Windows:
    • Runtime: Windows 7
    • Build: Cygwin + Visual Studio 2019 version 16.5
  • macOS:
    • Runtime: 10.10
    • Build: 10.14.4 + Xcode 11.3
  • Linux:
    • Runtime: RHEL 7 or CentOS 7
    • Build: either GCC 7.0.0; or Clang 5.0.2 with libstdc++ 7.3.0
  • iOS (only for LibreOfficeKit):
    • Runtime: 11.4 (only support for newer i devices == 64 bit)
    • Build: Xcode 9.3 and iPhone SDK 11.4
  • Android:
    • Build: NDK r19c and SDK 22.6.2
  • Emscripten / WASM:
    • Runtime: a browser with SharedMemory support (threads + atomics)
    • Build: Qt 5.15 with Qt supported Emscripten 1.39.8
    • See README.wasm

If you want to use Clang with the LibreOffice compiler plugins, the minimal version of Clang is 5.0.2. Since Xcode doesn't provide the compiler plugin headers, you have to compile your own Clang to use them on macOS.

You can find the TDF configure switches in the distro-configs/ directory.

To setup your initial build environment on Windows and macOS, we provide the LibreOffice Development Environment (LODE) scripts.

For more information see the build instructions for your platform in the TDF wiki.

The Important Bits of Code

Each module should have a README.md file inside it which has some degree of documentation for that module; patches are most welcome to improve those. We have those turned into a web page here:

https://docs.libreoffice.org/

However, there are two hundred modules, many of them of only peripheral interest for a specialist audience. So - where is the good stuff, the code that is most useful. Here is a quick overview of the most important ones:

Module Description
sal/ this provides a simple System Abstraction Layer
tools/ this provides basic internal types: Rectangle, Color etc.
vcl/ this is the widget toolkit library and one rendering abstraction
framework/ UNO framework, responsible for building toolbars, menus, status bars, and the chrome around the document using widgets from VCL, and XML descriptions from /uiconfig/ files
sfx2/ legacy core framework used by Writer/Calc/Draw: document model / load/save / signals for actions etc.
svx/ drawing model related helper code, including much of Draw/Impress

Then applications

Module Description
desktop/ this is where the main() for the application lives, init / bootstrap. the name dates back to an ancient StarOffice that also drew a desktop
sw/ Writer
sc/ Calc
sd/ Draw / Impress

There are several other libraries that are helpful from a graphical perspective:

Module Description
basegfx/ algorithms and data-types for graphics as used in the canvas
canvas/ new (UNO) canvas rendering model with various backends
cppcanvas/ C++ helper classes for using the UNO canvas
drawinglayer/ View code to render drawable objects and break them down into primitives we can render more easily.

Rules for #include Directives (C/C++)

Use the "..." form if and only if the included file is found next to the including file. Otherwise, use the <...> form. (For further details, see the mail Re: C[++]: Normalizing include syntax ("" vs <>).)

The UNO API include files should consistently use double quotes, for the benefit of external users of this API.

loplugin:includeform (compilerplugins/clang/includeform.cxx) enforces these rules.

Finding Out More

Beyond this, you can read the README.md files, send us patches, ask on the mailing list libreoffice@lists.freedesktop.org (no subscription required) or poke people on IRC #libreoffice-dev on irc.libera.chat - we're a friendly and generally helpful mob. We know the code can be hard to get into at first, and so there are no silly questions.