Test repository to check push and ssh key
Find a file
Caolán McNamara 53daeb9a7b Resolves: tdf#145297 assert on Docking3DEffects launch
(git show -w is your friend on commits like this)

Change-Id: Ie3a11986f98d196b6134fdc69e76a627e87d137b
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/124161
Tested-by: Jenkins
Reviewed-by: Caolán McNamara <caolanm@redhat.com>
2021-10-25 22:04:17 +02:00
.git-hooks
.github
.vscode
accessibility Simplify Sequence in accessibility 2021-10-17 22:05:27 +02:00
android LOK: maintain blocked command list per view 2021-10-22 17:49:20 +02:00
animations loplugin:moveparam in various 2021-10-12 09:50:31 +02:00
apple_remote
avmedia
basctl tdf#57308 - Basic IDE: Watching of a variable does not work 2021-10-25 13:22:09 +02:00
basegfx loplugin:moveparam in basegfx 2021-10-10 19:46:01 +02:00
basic tdf#57308 - Basic IDE: Watching of a variable does not work 2021-10-25 13:22:09 +02:00
bean
bin upgrade fontconfig to 2.13.94 2021-10-20 18:24:51 +02:00
binaryurp loplugin:moveparam in binaryurp 2021-10-08 17:10:07 +02:00
bridges Extend return values < 32-bit on macOS ARM64 2021-10-13 13:43:09 +02:00
canvas Simplify vector initialization in canvas 2021-10-15 18:39:21 +02:00
chart2 Simplify vector initialization in chart2 2021-10-15 18:12:36 +02:00
cli_ure drop 'using namespace std' in cli_ure 2021-10-07 13:38:06 +02:00
codemaker Use more appropriate type for OString-length related variable 2021-10-14 10:42:31 +02:00
comphelper LOK: maintain blocked command list per view 2021-10-22 17:49:20 +02:00
compilerplugins Adapt to Clang 14 trunk diagnostic output change 2021-10-25 13:05:40 +02:00
config_host
configmgr loplugin:stringview (clang-cl) 2021-10-15 14:08:53 +02:00
connectivity loplugin:indentation (macOS) 2021-10-25 15:58:24 +02:00
cppcanvas In O[U]StringBuffer, make string_view params replacements for OUString ones 2021-10-11 14:22:22 +02:00
cppu In O[U]StringBuffer, make string_view params replacements for OUString ones 2021-10-11 14:22:22 +02:00
cppuhelper Simplify vector initialization in cppuhelper 2021-10-15 20:27:38 +02:00
cpputools
cui loplugin:flatten 2021-10-21 14:58:51 +02:00
dbaccess Revert "Simplify vector initialization in dbaccess" 2021-10-22 18:05:12 +02:00
desktop use pull model also for LOK text selection 2021-10-25 19:30:34 +02:00
dictionaries@6c9f1f6c25
distro-configs --enable-lto for distro-configs/* that already use --enable-mergelibs 2021-10-14 15:58:07 +02:00
drawinglayer Use range based for loops 2021-10-19 22:33:11 +02:00
editeng Use MsLangId::getConfiguredSystemLanguage() 2021-10-19 00:20:36 +02:00
embeddedobj tdf#42982: improve UNO API error reporting 2021-10-24 16:46:07 +02:00
embedserv
emfio Replacing std::unique_ptr<char[]> 2021-10-25 09:08:37 +02:00
eventattacher
extensions return weld::Builder by unique_ptr 2021-10-22 12:05:19 +02:00
external Make external/breakpad/ubsan.patch apply again 2021-10-22 12:03:18 +02:00
extras
filter Converting pointer to reference in svgwriter 2021-10-25 11:22:47 +02:00
forms Remove non-const Sequence::begin()/end() in internal code 2021-10-15 10:36:36 +02:00
formula loplugin:moveparam in formula 2021-10-11 12:19:03 +02:00
fpicker Use NSModalResponseOK instead of deprecated NSFileHandlingPanelOKButton 2021-10-21 12:54:53 +02:00
framework return weld::Builder by unique_ptr 2021-10-22 12:05:19 +02:00
helpcompiler Revert "Simplify vector initialization in helpcompiler" 2021-10-22 19:30:32 +02:00
helpcontent2@56638af603 Update git submodules 2021-10-25 19:18:10 +02:00
hwpfilter loplugin:indentation check for indent inside block 2021-10-20 15:39:38 +02:00
i18nlangtag Introduce LanguageTag::convertToLanguageTypeWithFallback(Locale) 2021-10-25 13:07:50 +02:00
i18npool Missing static 2021-10-25 11:32:02 +02:00
i18nutil
icon-themes Breeze: tdf#144036 UNO Object Inspector icons 2021-10-20 11:52:18 +02:00
idl
idlc
include Fix toolbar button's currency list's number format for default locale 2021-10-25 18:15:40 +02:00
instsetoo_native tdf#143686 increase a radiobutton's area size 2021-10-13 08:41:29 +02:00
io
ios
javaunohelper
jurt
jvmaccess
jvmfwk Restrict macOS ARM64 to Java >= 17 2021-10-21 15:13:42 +02:00
l10ntools In O[U]StringBuffer, make string_view params replacements for OUString ones 2021-10-11 14:22:22 +02:00
librelogo
libreofficekit LOK: maintain blocked command list per view 2021-10-22 17:49:20 +02:00
lingucomponent
linguistic Ditch that CharClass constructing ToLower() nonsense 2021-10-19 11:35:40 +02:00
lotuswordpro just do one lookup for loop detection 2021-10-17 22:02:47 +02:00
m4
nlpsolver
o3tl
odk Cleanup DocumentLoader C++ SDK example 2021-10-25 09:05:23 +02:00
offapi tdf#129209 Doc't XInfobarProvider.idl 2021-10-20 08:21:54 +02:00
officecfg tdf#145132 SwNavigator: Add tracking option for all categories 2021-10-25 06:05:21 +02:00
onlineupdate
oovbaapi
oox Missing test dependency 2021-10-25 12:03:03 +02:00
opencl loplugin:indentation check for indent inside block 2021-10-20 15:39:38 +02:00
osx Add source files from fpicker/source/aqua 2021-10-21 10:04:17 +02:00
package Remove non-const Sequence::begin()/end() in internal code 2021-10-15 10:36:36 +02:00
pch
postprocess
pyuno loplugin:indentation check for indent inside block 2021-10-20 15:39:38 +02:00
qadevOOo cid#1492820 WMI: Inefficient Map Iterator 2021-10-11 11:37:40 +02:00
readlicense_oo
registry Repurpose regcompare test as unoidl-check test 2021-10-15 07:59:25 +02:00
remotebridges
reportbuilder
reportdesign Revert "Simplify vector initialization in reportdesign" 2021-10-22 19:17:27 +02:00
ridljar
sal move access inside mutex guard 2021-10-23 20:47:38 +02:00
salhelper loplugin:flatten 2021-10-21 14:58:51 +02:00
sax
sc expanding macro SCSTR 2021-10-25 11:02:55 +02:00
scaddins loplugin:indentation check for indent inside block 2021-10-20 15:39:38 +02:00
sccomp Remove non-const Sequence::begin()/end() in internal code 2021-10-15 10:36:36 +02:00
schema
scp2 ScriptForge - new SFWidgets library, new PopupMenu service 2021-10-15 16:39:48 +02:00
scripting Revert incompatible ScriptEditor change 2021-10-18 16:17:02 +02:00
sd loplugin:indentation (macOS) 2021-10-25 15:58:24 +02:00
sdext Revert part of "Simplify vector initialization in sdext" 2021-10-22 19:17:50 +02:00
setup_native
sfx2 change some LOK internal updates to be pull model instead of push 2021-10-24 01:40:45 +02:00
shell
slideshow Avoid usage of incomplete types in member functions defined in-class 2021-10-15 13:20:21 +02:00
smoketest
solenv bsd (as used by macOS) ar does not support '@' option 2021-10-25 20:13:32 +02:00
soltools loplugin:indentation check for indent inside block 2021-10-20 15:39:38 +02:00
sot
starmath Typo: aFontHeigt->aFontHeight (starmath/smediteng.cxx) 2021-10-22 20:25:16 +02:00
stoc Remove non-const Sequence::begin()/end() in internal code 2021-10-15 10:36:36 +02:00
store
svgio Use range based for loops 2021-10-17 17:04:00 +02:00
svl Restore behaviour SvNumberFormatterServiceObj keep LANGUAGE_SYSTEM unresolved 2021-10-25 14:46:35 +02:00
svtools Fix typo to complete commit 25278dc22f 2021-10-23 12:45:54 +02:00
svx Resolves: tdf#145297 assert on Docking3DEffects launch 2021-10-25 22:04:17 +02:00
sw tdf#138531: sw: Add UItest 2021-10-25 21:03:54 +02:00
swext
sysui uses of icon_filename are gone 2021-10-12 12:27:19 +02:00
test use pull model also for LOK text selection 2021-10-25 19:30:34 +02:00
testtools
toolkit loplugin:indentation check for indent inside block 2021-10-20 15:39:38 +02:00
tools use std::vector::insert instead of push_back 2021-10-14 21:28:40 +02:00
translations@41974fc7eb Update git submodules 2021-10-25 14:11:29 +02:00
ucb Related: tdf#145169 missing path separator in gio create folder 2021-10-19 15:28:08 +02:00
ucbhelper Remove non-const Sequence::begin()/end() in internal code 2021-10-15 10:36:36 +02:00
udkapi [API CHANGE] Remove unused css.resource.XLocale 2021-10-14 16:27:32 +02:00
uitest uitest: execute setActiveFrame in load_file first 2021-10-25 17:54:39 +02:00
UnoControls Remove non-const Sequence::begin()/end() in internal code 2021-10-15 10:36:36 +02:00
unodevtools
unoidl loplugin:flatten 2021-10-21 14:58:51 +02:00
unoil
unotest xmlsecurity: fix new tests on WNT 2021-10-18 08:28:25 +02:00
unotools loplugin:flatten 2021-10-21 14:58:51 +02:00
unoxml
ure
uui Directly initialize vectors in uui 2021-10-14 10:28:44 +02:00
vbahelper Remove non-const Sequence::begin()/end() in internal code 2021-10-15 10:36:36 +02:00
vcl replace friend access with functions 2021-10-25 16:55:02 +02:00
wasm-qt Move README.wasm -> wasm-qt/README.md 2021-10-12 15:04:08 +02:00
winaccessibility
wizards ScriptForge - (SF_Calc) new A1Style() method 2021-10-25 11:06:54 +02:00
writerfilter tdf#145215: docx: do not initialize prefix/suffix and include levels 2021-10-23 21:28:25 +02:00
writerperfect Avoid COW overhead using css::uno::Sequence 2021-10-14 06:00:49 +02:00
xmerge
xmlhelp Simplify Sequence in xmlhelp 2021-10-17 14:19:53 +02:00
xmloff Resolves: tdf#92015 Handle malused *:rfc-language-tag ODF violation 2021-10-22 04:02:12 +02:00
xmlreader
xmlscript loplugin:indentation check for indent inside block 2021-10-20 15:39:38 +02:00
xmlsecurity tdf#145312 xmlsecurity: prevent from crash when cannot receive pdfium annotation 2021-10-25 14:04:56 +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 remove unused variables 2021-10-11 11:30:45 +02:00
config_host_lang.mk.in
configure.ac show properly gcc version in configure output 2021-10-25 09:15:51 +02:00
COPYING
COPYING.LGPL
COPYING.MPL
download.lst upgrade fontconfig to 2.13.94 2021-10-20 18:24:51 +02:00
g
hardened_runtime.xcent.in
install-sh
install_deps.sh
leak-suppress.txt
Library_merged.mk
lo.xcent
logerrit
Makefile.fetch
Makefile.gbuild
Makefile.in Simplify VS IDE integration generation 2021-10-08 14:53:48 +02:00
README.cross
README.help.md
README.md
README.Solaris
Repository.mk ScriptForge - new SFWidgets library, new PopupMenu service 2021-10-15 16:39:48 +02:00
RepositoryExternal.mk xmlsecurity: fix --without-system-nss usage of NSS_SetAlgorithmPolicy 2021-10-19 19:28:54 +02:00
RepositoryFixes.mk
RepositoryModule_build.mk
RepositoryModule_host.mk
sanitize-ubsan-excludelist
setup.cfg
TEMPLATE.SOURCECODE.HEADER
tsan-suppress.txt

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.