Test repository to check push and ssh key
Find a file
Stephan Bergmann 9c431f4d3a Don't use Library_tl in URE libraries
This partly reverts 8b5e23eac3 "log nice exception
messages whereever possible", e1eb7cb04a
"loplugin:logexceptionnicely in starmath..svgio",
d6d80c4e17 "OSL_FAIL.*exception ->
TOOLS_WARN_EXCEPTION", and 877f40ac3f "tdf#42949
Fix new IWYU warnings in directories [h-r]*", and adapts
loplugin:logexceptionnicely accordingly.

Change-Id: I792b853b988c7c5f77179ca0672c30cb4223b5a6
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/130502
Tested-by: Jenkins
Reviewed-by: Stephan Bergmann <sbergman@redhat.com>
2022-02-25 08:20:55 +01:00
.git-hooks
.github
.vscode vscode-ide-integration: use gdb from $PATH by default 2022-01-17 15:06:32 +01:00
accessibility a11y: Simplify AccessibleGridControlTable::getAccessibleCellAt 2022-02-24 07:21:12 +01:00
android Convert example document from cz to en-us 2021-12-09 15:42:36 +01:00
animations animations : use cppuhelper::BaseMutex 2022-01-30 07:32:41 +01:00
apple_remote Add support for macOS SDK 12.0 2021-10-27 16:32:04 +02:00
avmedia gtk4: get getPreferredPlayerWindowSize working 2022-02-21 09:37:49 +01:00
basctl cid#1500494 Explicit null dereferenced 2022-02-23 13:51:20 +01:00
basegfx tdf#145759 Use symbolic constants instead of magic numerical constants 2022-02-15 21:00:18 +01:00
basic tdf#147132: Flatten Basic function implementations 2022-02-22 09:34:20 +01:00
bean
bin Adapt CustomTarget_postprocess/check_dynamic_objects to --enable-gtk4 2022-02-22 07:56:24 +01:00
binaryurp tdf#147021 Use std::size() instead of SAL_N_ELEMENTS() macro 2022-02-06 21:38:32 +01:00
bridges WASM UNO: add a minimal dummy bridge 2022-01-19 14:26:09 +01:00
canvas adjust gradient drawing in vclcanvas (tdf#144073) 2022-02-01 23:44:28 +01:00
chart2 use more TypedWhichId 2022-02-24 19:31:38 +01:00
cli_ure drop 'using namespace std' in cli_ure 2021-10-07 13:38:06 +02:00
codemaker Extend loplugin:stringview to O[U]StringBuffer::toString 2022-02-08 09:09:32 +01:00
comphelper tdf#147086 OOXML export: don't save the empty editing password 2022-02-17 10:25:24 +01:00
compilerplugins Don't use Library_tl in URE libraries 2022-02-25 08:20:55 +01:00
config_host upgrade to box2d 2.4.1 2022-01-24 09:58:45 +01:00
configmgr Extend loplugin:stringview to O[U]StringBuffer::toString 2022-02-08 09:09:32 +01:00
connectivity Fix a ODatabaseMetaDataResultSet type in evoab2 2022-02-22 23:23:10 +01:00
cppcanvas Recheck modules [a-c]* with IWYU 2022-01-13 08:26:15 +01:00
cppu WASM UNO: add a minimal dummy bridge 2022-01-19 14:26:09 +01:00
cppuhelper Add XWeak constructor and operator= to uno::WeakReference 2022-02-22 12:27:55 +01:00
cpputools Recheck modules [a-c]* with IWYU 2022-01-13 08:26:15 +01:00
cui use more TypedWhichId 2022-02-24 19:31:38 +01:00
dbaccess Add XWeak constructor and operator= to uno::WeakReference 2022-02-22 12:27:55 +01:00
desktop lok: sc: unit test drag & drop 2022-02-18 19:42:38 +01:00
dictionaries@5314824424 Update git submodules 2022-02-15 16:16:36 +01:00
distro-configs Remove COMPILER_PLUGINS_CXX from distro-configs/Jenkins/linux_clang_dbgutil_64 2022-02-08 23:55:50 +01:00
drawinglayer tdf#145759 Use symbolic constants instead of magic numerical constants 2022-02-15 21:00:18 +01:00
editeng use more TypedWhichId 2022-02-24 19:31:38 +01:00
embeddedobj Recheck modules [e-f]* with IWYU 2022-01-17 01:33:35 +01:00
embedserv Use GetModuleHandleExW instead of GetModuleHandleW 2022-01-05 16:20:36 +01:00
emfio drop checksum assert that is platform dependent 2022-02-08 12:44:56 +01:00
eventattacher Generally determine Rdb content from gb_*_set_componentfile calls 2021-12-10 08:14:24 +01:00
extensions Simplify sequence of PropertyValue in cui/editeng/extensions 2022-02-06 19:35:34 +01:00
external external/python3: Explicitly check that all extension modules got built 2022-02-23 11:12:10 +01:00
extras Fix typo 2022-02-15 20:06:33 +01:00
filter SdrLayerID must be based on sal_Int16 2022-02-23 16:00:28 +01:00
forms use more TypedWhichId 2022-02-24 19:31:38 +01:00
formula add toId/fromId to tidy up some ugly casting 2022-02-04 15:02:03 +01:00
fpicker expand out IMPLEMENT_FORWARD_XTYPEPROVIDER3 2022-02-09 14:16:17 +01:00
framework CppunitTest_framework_dispatch: remove duplicated dispatchCommand 2022-02-23 09:06:59 +01:00
helpcompiler Recheck modules [i-l]* with IWYU 2022-01-27 18:52:16 +01:00
helpcontent2@4ac52bffa0 Update git submodules 2022-02-23 22:49:00 +01:00
hwpfilter ofz#44997 Use-of-uninitialized-value 2022-02-24 14:55:33 +01:00
i18nlangtag tdf#146602 Add Pennsylvania Dutch {pdc-US} 0x06AF to language list 2022-01-26 17:03:52 +01:00
i18npool tdf#147343: Wrong typo for AM/PM indicator in Spanish locales 2022-02-13 09:49:30 +01:00
i18nutil Recheck modules [i-l]* with IWYU 2022-01-27 18:52:16 +01:00
icon-themes Sifr: tdf#144303 Calc's cross cursor 2022-02-23 14:52:06 +01:00
idl Recheck modules [i-l]* with IWYU 2022-01-27 18:52:16 +01:00
idlc Unify condition names and fix "else" paths 2022-01-08 12:26:30 +01:00
include use more TypedWhichId 2022-02-24 19:31:38 +01:00
instsetoo_native Make installer compression tool configurable 2022-01-22 10:14:23 +01:00
io Don't use Library_tl in URE libraries 2022-02-25 08:20:55 +01:00
ios
javaunohelper Don't use Library_tl in URE libraries 2022-02-25 08:20:55 +01:00
jurt Adapt Library_jpipe__staticsalhack 2022-02-20 14:24:52 +01:00
jvmaccess drop 'using namespace std' in h* i* j* 2021-10-05 22:22:55 +02:00
jvmfwk Replace some fprintf with SAL_WARN 2022-02-22 13:53:44 +01:00
l10ntools Fail Executable_ulfex upon duplicate keys in malformed input 2022-02-21 09:23:40 +01:00
librelogo Resolves: tdf#97046 ensure build system variables start with gb_ 2021-11-04 10:48:24 +01:00
libreofficekit Recheck modules [i-l]* with IWYU 2022-01-27 18:52:16 +01:00
lingucomponent Recheck modules [i-l]* with IWYU 2022-01-27 18:52:16 +01:00
linguistic Extend loplugin:stringview to OUStringBuffer::copy 2022-02-16 22:45:42 +01:00
lotuswordpro Fix typo 2022-02-02 08:57:44 +01:00
m4 Drop remnants of --with-webdav=neon 2022-01-05 17:50:41 +01:00
nlpsolver
o3tl Recheck modules [o-r]* with IWYU 2022-01-30 16:10:57 +01:00
odk tdf#145759 Using M_PI from cmath instead of magic constants. 2022-02-15 12:17:50 +01:00
offapi Removed executable bits on idl file 2022-02-19 11:52:48 +01:00
officecfg tdf#145745 Create uno:DuplicateSheet command 2022-02-15 13:37:31 +01:00
onlineupdate drop 'using namespace std' in o* r* x* 2021-10-05 23:09:56 +02:00
oovbaapi vba: add support for Application.WindowState + test 2022-01-27 07:38:09 +01:00
oox tdf#147609 and ofz#44965 Indirect-leak 2022-02-24 10:12:59 +01:00
opencl Recheck modules [o-r]* with IWYU 2022-01-30 16:10:57 +01:00
osx Add some source files for debugging convenience 2022-02-02 15:53:04 +01:00
package cid#1500664 Dereference before null check 2022-02-23 12:16:00 +01:00
pch
postprocess WASM open links in new browser tabs 2022-01-20 10:26:04 +01:00
pyuno Recheck modules [o-r]* with IWYU 2022-01-30 16:10:57 +01:00
qadevOOo Fix typos 2022-02-09 19:17:29 +01:00
readlicense_oo update credits 2022-02-23 13:43:25 +01:00
registry Unify condition names and fix "else" paths 2022-01-08 12:26:30 +01:00
remotebridges Recheck modules [o-r]* with IWYU 2022-01-30 16:10:57 +01:00
reportbuilder Generally determine Rdb content from gb_*_set_componentfile calls 2021-12-10 08:14:24 +01:00
reportdesign SdrLayerID must be based on sal_Int16 2022-02-23 16:00:28 +01:00
ridljar
sal Deduplicate rtl_*String_newConcat*L 2022-02-24 17:57:14 +01:00
salhelper Recheck modules s[a-c]* with IWYU 2022-02-14 15:25:30 +01:00
sax Recheck modules s[a-c]* with IWYU 2022-02-14 15:25:30 +01:00
sc uitest: check the value and not the text 2022-02-24 19:48:26 +01:00
scaddins tdf#145759 Using M_PI from cmath instead of magic constants. 2022-02-15 12:17:50 +01:00
sccomp Recheck modules s[a-c]* with IWYU 2022-02-14 15:25:30 +01:00
schema tdf#147580 use valid values for extrusion-specularity 2022-02-24 11:43:51 +01:00
scp2 Fix "Adding Central Kurdish(ckb) Spell Checker & Dictionary" 2022-02-19 10:00:00 +01:00
scripting Recheck modules s[a-c]* with IWYU 2022-02-14 15:25:30 +01:00
sd uitest: check the value and not the text 2022-02-24 19:48:26 +01:00
sdext Recheck modules sd* with IWYU 2022-02-21 14:04:45 +01:00
setup_native Adding Central Kurdish(ckb) Spell Checker & Dictionary 2022-02-14 18:40:14 +01:00
sfx2 CppunitTest_sfx2_classification: remove duplicated dispatchCommand 2022-02-23 09:08:05 +01:00
shell add to suffix denylist 2022-02-24 08:54:18 +01:00
slideshow cid#1500712 silence Explicit null dereferenced 2022-02-24 15:33:16 +01:00
smoketest oss-fuzz: convert to static cross-build 2021-12-25 17:05:08 +01:00
solenv Keep URE libraries out of Library_merged 2022-02-24 13:44:50 +01:00
soltools loplugin:indentation check for indent inside block 2021-10-20 15:39:38 +02:00
sot use less SvStream::Flush() 2022-01-10 17:59:45 +01:00
starmath tdf#145759 Using M_PI from cmath instead of magic constants. 2022-02-15 12:17:50 +01:00
static Fix typos 2022-01-21 12:51:49 +01:00
stoc Don't use Library_tl in URE libraries 2022-02-25 08:20:55 +01:00
store Let loplugin:nullptr look into template instantiations 2022-01-15 15:58:07 +01:00
svgio Fix Test::testTdf97663 2021-12-24 04:57:06 +01:00
svl merge poolio.cxx into itempool.cxx 2022-02-22 10:37:56 +01:00
svtools svtools: fix lost replacement non-rendered graphic when updating it fails 2022-02-17 19:07:32 +01:00
svx tdf#72776 Allow text removal in the shapes 2022-02-24 11:36:56 +01:00
sw uitest: check the value and not the text 2022-02-24 19:48:26 +01:00
swext
sysui change rpm compression algorithm to multi threaded xz 2022-01-23 15:13:03 +01:00
test Separate core drawinglayer func. into drawinglayercore library 2021-12-22 12:10:10 +01:00
testtools tdf#145759 Use symbolic constants instead of magic numerical constants 2022-02-15 21:00:18 +01:00
toolkit Add XWeak constructor and operator= to uno::WeakReference 2022-02-22 12:27:55 +01:00
tools cid#1500555 try -taint_source function annotation tag on function body 2022-02-24 13:06:40 +01:00
translations@149fb7cb5f Update git submodules 2022-02-21 16:22:06 +01:00
ucb loplugin:unusedmethods 2022-02-17 14:51:23 +01:00
ucbhelper No need to call makeStringAndClear to pass a string view 2022-02-06 17:40:51 +01:00
udkapi Update reference links for ISO 639 and 3166 2021-12-11 21:40:00 +01:00
uitest uitest: try harder to close the dialog when it fails ... 2022-02-24 19:47:47 +01:00
UnoControls tdf#145614 Convert #define to enum or constexpr 2022-01-19 06:55:12 +01:00
unodevtools Extend loplugin:stringview to O[U]StringBuffer::toString 2022-02-08 09:09:32 +01:00
unoidl Fix clang-cl -Zc:dllexportInlines- build 2021-12-02 07:39:52 +01:00
unoil
unotest Fix --disable-scripting for DESKTOP build 2021-12-03 06:46:24 +01:00
unotools Avoid signed-integer-overflow 2022-02-06 15:09:23 +01:00
unoxml osl::Mutex->std::mutex in CEvent 2021-12-25 07:15:33 +01:00
ure Update README lists of URE dynamic libraries 2022-02-24 14:12:53 +01:00
uui Generally determine Rdb content from gb_*_set_componentfile calls 2021-12-10 08:14:24 +01:00
vbahelper Generally determine Rdb content from gb_*_set_componentfile calls 2021-12-10 08:14:24 +01:00
vcl cid#1500677 Dereference after null check 2022-02-24 15:20:41 +01:00
winaccessibility loplugin:nullptr 2022-02-08 15:21:26 +01:00
wizards ScriptForge - (L10N): add new arguments to the service creation 2022-02-17 16:18:49 +01:00
writerfilter Remove some unused includes 2022-02-18 08:13:13 +01:00
writerperfect WASM --enable-wasm-strip now skips lots of LO code 2022-01-20 12:28:54 +01:00
xmerge Generally determine Rdb content from gb_*_set_componentfile calls 2021-12-10 08:14:24 +01:00
xmlhelp Generally determine Rdb content from gb_*_set_componentfile calls 2021-12-10 08:14:24 +01:00
xmloff ODT import: fix MSO-style <text:list text:continue-numbering="true"> 2022-02-24 17:37:59 +01:00
xmlreader Fix clang-cl -Zc:dllexportInlines- build 2021-12-02 07:39:52 +01:00
xmlscript Generally determine Rdb content from gb_*_set_componentfile calls 2021-12-10 08:14:24 +01:00
xmlsecurity Cleanup x509certificate_nssimpl.cxx 2022-02-21 20:55:45 +01:00
.buckconfig
.buckversion
.clang-format
.editorconfig
.git-blame-ignore-revs
.gitattributes
.gitignore updated gitignore for Android builds 2022-02-14 16:05:49 +01:00
.gitmodules
.gitpod.dockerfile
.gitpod.yml
.gitreview
antivirusDetection.vbs
autogen.sh
BUCK
config.guess
config.sub
config_host.mk.in add system-dragonbox 2022-02-22 15:53:59 +01:00
config_host_lang.mk.in
configure.ac Bump macOS build baseline to Xcode 12.5 and macOS 11.0 2022-02-24 17:25:10 +01:00
COPYING
COPYING.LGPL
COPYING.MPL
download.lst upgrade to expat 2.4.6 2022-02-21 17:20:30 +01:00
g Allow g to run git gc command 2022-01-15 15:42:34 +01:00
hardened_runtime.xcent.in
install-sh
install_deps.sh
leak-suppress.txt
Library_merged.mk
lo.xcent
logerrit Use ed25519 as default for ssh key pair generation 2021-09-29 09:34:21 +02:00
Makefile.fetch add system-dragonbox 2022-02-22 15:53:59 +01:00
Makefile.gbuild gbuild: build static LO / link static executables 2022-01-12 11:12:46 +01:00
Makefile.in Use relative path to the script, to please python3 on Windows 2022-02-15 16:34:54 +01:00
README.cross
README.help.md
README.md Bump macOS build baseline to Xcode 12.5 and macOS 11.0 2022-02-24 17:25:10 +01:00
README.Solaris
Repository.mk first cut at using Gtk4 built in video playback 2022-02-18 20:40:01 +01:00
RepositoryExternal.mk Sync the two definitions of python_arch_subdir 2022-02-23 10:17:22 +01:00
RepositoryFixes.mk WASM more initial bits and pieces 2022-01-19 10:49:40 +01:00
RepositoryModule_build.mk add drawinglayercore to merged libs 2021-12-23 11:38:24 +09:00
RepositoryModule_host.mk WASM --enable-wasm-strip now skips lots of LO code 2022-01-20 12:28:54 +01:00
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.13
    • Build: 11.0 + Xcode 12.5
  • Linux:
    • Runtime: RHEL 7 or CentOS 7
    • Build: either GCC 7.0.0; or Clang 8.0.1 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 12.0.1. 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.