Test repository to check push and ssh key
Find a file
Stephan Bergmann dc96de7c62 Extend loplugin:cppunitassertequals to more argument types
Change-Id: Ic2990ebc2e4a9a36dcd3f90c5f634ca7dd225d52
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/147491
Tested-by: Jenkins
Reviewed-by: Stephan Bergmann <sbergman@redhat.com>
2023-02-23 07:04:09 +00:00
.git-hooks git pre-commit hook: check .mm files 2022-12-27 12:10:02 +00:00
.github
.vscode create compile_commands.json in builddir 2022-12-05 13:54:00 +00:00
accessibility Use ImplInheritanceHelper in VCLXAccessibleToolBoxItem 2023-01-27 11:48:19 +00:00
android android: Update com.google.android.material to 1.8.0 2023-02-17 12:06:49 +00:00
animations Remove duplicated include 2023-02-01 05:46:46 +00:00
apple_remote
avmedia drop internal support for 1-bit images 2023-01-12 06:52:42 +00:00
basctl tdf#153572 Implement .uno:ZoomPlus and .uno:ZoomMinus in the Basic IDE 2023-02-22 13:36:30 +00:00
basegfx Fix typo 2023-02-22 14:03:12 +00:00
basic Extend loplugin:cppunitassertequals to more argument types 2023-02-23 07:04:09 +00:00
bean
bin Adapt to renamed libcairo-lo.so.2 2023-02-13 17:41:06 +00:00
binaryurp cid#1500596 silence Resource leak 2022-08-27 13:13:29 +02:00
bridges android: Switch from GNU binutils to support NDK 23.x, require 21.x 2023-02-16 20:31:39 +00:00
canvas BaseMutex->std::mutex in canvas::CachedPrimitiveBase 2023-02-22 10:15:29 +00:00
chart2 Extend loplugin:cppunitassertequals to more argument types 2023-02-23 07:04:09 +00:00
cli_ure
codemaker Make check for complete type more explicit 2022-12-05 21:59:45 +00:00
comphelper create new OPropertyChangeListener2 and use it in FmFieldWin 2023-02-22 12:43:55 +00:00
compilerplugins Extend loplugin:cppunitassertequals to more argument types 2023-02-23 07:04:09 +00:00
config_host improve comment about SKIA_DEBUG 2023-01-26 11:09:12 +00:00
configmgr fix locking in configmgr::configuration_provider::Service 2023-02-21 11:58:51 +00:00
connectivity osl::Mutex->std::mutex in OSQLParseNodesContainer 2023-02-22 09:16:10 +00:00
cppcanvas improve readability of VirtualDevice constructor 2023-02-07 10:19:32 +00:00
cppu Drop 'using namespace ::std' in dirs b* c* 2023-02-15 18:37:59 +00:00
cppuhelper OFactoryComponentHelper's XAggregation is apparently unused 2023-01-13 09:37:49 +00:00
cpputools Remove support for AIX 2023-01-27 07:28:16 +00:00
cui (related tdf#153417) rename "Back" to "Reset" 2023-02-22 22:20:49 +00:00
dbaccess osl::Mutex->std::mutex in FmXGridPeer 2023-02-21 10:39:38 +00:00
desktop Extend LOKit API with functionality to extract a request and paint thumbnails 2023-02-22 08:14:30 +00:00
dictionaries@bcf7f04931 Update git submodules 2023-02-13 07:08:50 +00:00
distro-configs vcl: Avoid the need to patch HarfBuzz 2023-02-22 09:02:40 +00:00
docmodel sd: use XTheme to transport the theme to xmloff import/export 2023-01-31 08:59:09 +00:00
drawinglayer Fix typo 2023-02-22 14:04:03 +00:00
editeng downgrade assert to warning 2023-02-19 20:11:33 +00:00
embeddedobj Revert all the recent loplugin:unocast changes 2023-01-05 11:45:51 +00:00
embedserv Drop redundant -Wnon-virtual-dtor 2022-11-24 10:38:28 +01:00
emfio ofz: Use-of-uninitialized-value 2023-02-15 12:28:27 +00:00
eventattacher clang-tidy modernize-pass-by-value in various 2022-08-13 19:11:49 +02:00
extensions cid#1521188 Uninitialized scalar variable 2023-02-20 12:51:34 +00:00
external vcl: Avoid the need to patch HarfBuzz 2023-02-22 09:02:40 +00:00
extras Related: tdf#150687 check autocorr DocumentList.xml at build time 2023-01-05 09:56:48 +00:00
filter BaseMutex->std::mutex in ConfigFlush 2023-02-22 13:44:11 +00:00
forms BaseMutex->std::mutex in ListenerMultiplexerBase 2023-02-22 11:47:11 +00:00
formula Obtain actual 0-parameter count for OR(), AND() and 1-parameter functions 2023-02-17 02:24:08 +00:00
fpicker use more string_view in svtools 2022-09-21 14:21:28 +02:00
framework BaseMutex->std::mutex in PopupMenuControllerBase 2023-02-22 13:24:47 +00:00
helpcompiler Remove support for AIX 2023-01-27 07:28:16 +00:00
helpcontent2@ac82657672 Update git submodules 2023-02-23 00:22:55 +00:00
hwpfilter ofz: Use-of-uninitialized-value 2023-02-11 00:10:51 +00:00
i18nlangtag Add Saraiki {skr-PK} [0x06B0] to language list, CTL, RTL 2023-02-17 22:52:15 +00:00
i18npool Drop 'using namespace ::std' in dirs [e-p]* 2023-02-15 18:39:38 +00:00
i18nutil tdf#104597 related: restore the mirroring of Bidi_Mirrored characters 2022-11-30 13:40:24 +01:00
icon-themes Resolves tdf#152947 - Accessibility for save status icon 2023-01-25 16:42:17 +00:00
idl Fix bogus uses of OUString::createFromAscii 2023-02-08 16:03:33 +00:00
idlc/test/parser
include Resolves: tdf#153767 Try harder to import OOXML bool shared formula result 2023-02-23 01:33:48 +00:00
instsetoo_native Remove support for AIX 2023-01-27 07:28:16 +00:00
io Drop 'using namespace ::std' in dirs [e-p]* 2023-02-15 18:39:38 +00:00
ios merge duplicate CairoTextRender impls 2023-01-12 11:33:24 +00:00
javaunohelper
jurt
jvmaccess
jvmfwk Remove support for 32-bit S390 2023-01-27 07:29:14 +00:00
l10ntools Work around system(3) dropping DYLD_LIBRARY_PATH on macOS 2022-11-23 08:47:26 +01:00
librelogo gb_var2file: remove now unused chunk-size parameter 2022-12-13 15:04:01 +00:00
libreofficekit Missing include 2023-01-09 08:26:19 +00:00
lingucomponent Drop 'using namespace ::std' in dirs [e-p]* 2023-02-15 18:39:38 +00:00
linguistic Make a few warning messages a bit more useful 2023-02-15 14:45:33 +00:00
lotuswordpro Merge SvXMLAttributeList to comphelper::AttributeList 2023-01-15 12:32:29 +00:00
m4 Add riscv64 support 2022-11-10 13:47:06 +01:00
nlpsolver Fix title for nlpsolver/README.md 2022-12-19 09:42:02 +00:00
o3tl Only specialize CppUnit::assetion_traits<T>::toString member functions 2023-02-16 21:16:12 +00:00
odk Quote some Windows shell settings 2023-02-17 15:18:07 +00:00
offapi Remove css.xml.xslt.XSLT2Transformer not implemented by LO 2023-02-15 08:44:21 +00:00
officecfg tdf#143660 Make color scheme names translatable 2023-02-21 16:30:38 +00:00
onlineupdate NSS initialization guard 2023-01-25 12:24:34 +00:00
oovbaapi tdf#149786 sc: add VBA function: ExportAsFixedFormat 2023-02-14 10:41:17 +00:00
oox Typo: interpets->interprets 2023-02-22 16:58:01 +00:00
opencl Use raw string literal in opencl to keep PMD static analyser happy 2023-02-03 07:13:52 +00:00
osx Add all vcl subdirs to soffice.xcodeproj 2022-09-01 11:51:38 +02:00
package osl::Mutex->std::mutex in OHierarchyElement_Impl 2023-02-17 07:33:24 +00:00
pch
postprocess Remove support for 32-bit S390 2023-01-27 07:29:14 +00:00
pyuno tdf#143148 Use pragma once instead of include guards 2023-02-13 11:26:27 +00:00
qadevOOo Add some more failure information 2022-11-30 16:44:07 +01:00
readlicense_oo update credits 2023-02-22 20:47:03 +01:00
registry tdf#143148 Use pragma once instead of include guards 2023-02-13 11:26:27 +00:00
remotebridges
reportbuilder Fix typos 2022-08-12 13:24:49 +02:00
reportdesign editeng: remove SvxLRSpaceItem::nTxtLeft 2023-02-08 11:03:36 +00:00
ridljar warning: empty <p> tag 2022-08-13 00:35:17 +02:00
sal Only specialize CppUnit::assetion_traits<T>::toString member functions 2023-02-16 21:16:12 +00:00
salhelper
sax Drop 'using namespace ::std' in dirs s* 2023-02-16 08:14:21 +00:00
sc Extend loplugin:cppunitassertequals to more argument types 2023-02-23 07:04:09 +00:00
scaddins tdf#147906 Use std::hypot for Pythagorean addition 2022-11-19 00:48:16 +01:00
sccomp Extend loplugin:cppunitassertequals to more argument types 2023-02-23 07:04:09 +00:00
schema schema: properly extend office-styles instead of style-style "hack" 2023-02-01 14:53:37 +00:00
scp2 Remove support for AIX 2023-01-27 07:28:16 +00:00
scripting Fix/simplify some vnd.sun.star.expand: handling 2023-02-13 11:29:34 +00:00
sd CppunitTest_sd_import_tests-smartart: use CPPUNIT_TEST_FIXTURE() 2023-02-22 20:09:49 +00:00
sdext Drop 'using namespace ::std' in dirs s* 2023-02-16 08:14:21 +00:00
setup_native Bump copyright year to 2023 2023-01-01 10:12:56 +00:00
sfx2 osl::Mutex->std::mutex in SfxDocTemplate_Impl 2023-02-22 06:24:33 +00:00
shell Remove support for AIX 2023-01-27 07:28:16 +00:00
slideshow tdf#143148 Use pragma once instead of include guards 2023-02-23 05:52:01 +00:00
smoketest clang-tidy modernize-pass-by-value in various 2022-08-13 19:11:49 +02:00
solenv Use -O3 for Emscripten, seems to work 2023-02-16 21:27:14 +00:00
soltools Remove support for AIX 2023-01-27 07:28:16 +00:00
sot split utl::TempFile into fast and named variants 2022-09-29 09:11:18 +02:00
starmath tdf#152850: Fix bad scoping of MathML frac command 2023-02-21 12:11:06 +00:00
static Fix typo 2023-02-13 11:27:46 +00:00
stoc Drop 'using namespace ::std' in dirs s* 2023-02-16 08:14:21 +00:00
store clang-tidy modernize-pass-by-value in various 2022-08-13 19:11:49 +02:00
svgio CppunitTest_svgio: use CPPUNIT_TEST_FIXTURE() 2022-12-08 07:06:31 +00:00
svl Extend loplugin:cppunitassertequals to more argument types 2023-02-23 07:04:09 +00:00
svtools BaseMutex->std::mutex in PopupMenuControllerBase 2023-02-22 13:24:47 +00:00
svx create new OPropertyChangeListener2 and use it in FmFieldWin 2023-02-22 12:43:55 +00:00
sw tdf#153561 rename "chapter" to "heading"; update/add tool/extended tip 2023-02-23 01:13:30 +00:00
swext
sysui Rename: Extension Manager -> Extensions 2023-02-13 13:17:12 +00:00
test Extend loplugin:cppunitassertequals to more argument types 2023-02-23 07:04:09 +00:00
testtools Related: rhbz#2136459 use a value which is exactly representable as a float 2023-01-20 21:04:33 +00:00
toolkit toolkit: Port AccessibleStatusBarTest to test::AccessibleTestBase 2023-02-22 16:53:41 +00:00
tools Only specialize CppUnit::assetion_traits<T>::toString member functions 2023-02-16 21:16:12 +00:00
translations@70a23c0afa Update git submodules 2023-02-22 19:20:47 +00:00
ucb osl::Mutex->std::mutex in SortedDynamicResultSetListener 2023-02-17 08:19:52 +00:00
ucbhelper osl::Mutex->std::mutex in ucbhelper::FdInputStream 2023-02-20 17:45:49 +00:00
udkapi Update the reference rdbs to libreoffice-7.5.0.3 2023-02-02 20:06:18 +00:00
uitest tdf#152850: Fix bad scoping of MathML frac command 2023-02-21 12:11:06 +00:00
UnoControls Base BaseControl on WeakComponentImplHelper 2023-01-20 17:18:27 +00:00
unodevtools Fix typo 2023-01-25 14:45:00 +00:00
unoidl tdf#147021 Use std::size() instead of SAL_N_ELEMENTS() macro 2022-11-06 01:22:27 +01:00
unoil
unotest qa: call ProcessEventsToIdle inside dispatchCommand 2023-02-21 20:20:29 +00:00
unotools osl::Mutex->std::mutex in FmSearchConfigItem 2023-02-21 11:02:47 +00:00
unoxml tdf#153039 unoxml: replace root element of CDocument throws 2023-01-19 11:28:50 +00:00
ure Revert "tdf#145538 Use range based for loops" 2022-11-07 08:20:46 +01:00
uui move image into the .ui file 2023-02-15 16:56:59 +00:00
vbahelper VBA: Remove conversions in writer from OORGBTOXLRGB (XLRGB is actually BGR!) 2023-02-20 16:55:31 +00:00
vcl Extend loplugin:cppunitassertequals to more argument types 2023-02-23 07:04:09 +00:00
winaccessibility Revert all the recent loplugin:unocast changes 2023-01-05 11:45:51 +00:00
wizards Fix/simplify some vnd.sun.star.expand: handling 2023-02-13 11:29:34 +00:00
writerfilter tdf#153526 writerfilter: catch exception from no NumberingRules 2023-02-22 22:35:06 +00:00
writerperfect Extend loplugin:cppunitassertequals to more argument types 2023-02-23 07:04:09 +00:00
xmerge cid#1509209 DCN: Don't Catch NullPointer Exception 2022-09-15 15:29:57 +02:00
xmlhelp fix deadlock in xmlhelper::Databases 2023-02-22 13:12:04 +00:00
xmloff Drop 'using namespace ::std' in dirs [u-x]* 2023-02-16 08:14:39 +00:00
xmlreader
xmlscript use more string_view 2022-10-17 10:39:11 +02:00
xmlsecurity new comphelper::SingletonRef 2023-02-15 13:31:11 +00:00
.buckconfig
.buckversion
.clang-format Document that .clang-format would benefit from StatementMacros 2022-11-06 15:38:07 +01:00
.editorconfig
.git-blame-ignore-revs
.gitattributes
.gitignore .gitignore: /.vscode* 2023-02-12 21:37:18 +00:00
.gitmodules
.gitpod.dockerfile
.gitpod.yml
.gitreview
antivirusDetection.vbs
autogen.sh Remove support for AIX 2023-01-27 07:28:16 +00:00
BUCK
config.guess Update config.guess & .sub to latest 2022-12-12 15:46:46 +00:00
config.sub Update config.guess & .sub to latest 2022-12-12 15:46:46 +00:00
config_host.mk.in android: Use libc++_shared path that works for NDK 25, too 2023-02-16 20:32:46 +00:00
config_host_lang.mk.in don't export the various language lists and consolidate them 2022-12-15 21:07:37 +00:00
configure.ac vcl: Avoid the need to patch HarfBuzz 2023-02-22 09:02:40 +00:00
COPYING
COPYING.LGPL
COPYING.MPL
cpp.hint Add a VisualStudio cpp.hint file 2022-08-22 16:01:16 +02:00
download.lst nss: upgrade to release 3.88.1 2023-02-21 13:40:38 +00:00
g Avoid refreshing all hooks in secondary worktrees 2022-11-28 05:18:12 +01:00
hardened_runtime.xcent.in
install-sh
install_deps.sh
leak-suppress.txt
Library_merged.mk
lo.xcent.in
logerrit
Makefile.fetch tdf#136604: Remove Source Sans Pro fonts 2022-12-31 19:34:37 +00:00
Makefile.gbuild create pocheck convenience target 2022-12-15 22:10:23 +00:00
Makefile.in create pocheck convenience target 2022-12-15 22:10:23 +00:00
README.cross
README.help.md
README.md Update Android baseline in README.md 2023-02-16 20:33:15 +00:00
README.Solaris
Repository.mk Make minvcl and svdemo VCL examples build on Windows 2023-01-28 13:08:27 +00:00
RepositoryExternal.mk Get the shared object of a bundled fontconfig into rpm and deb packages 2023-02-10 11:54:16 +00:00
RepositoryFixes.mk
RepositoryModule_build.mk introduce docmodel comp., model::ThemeColor, use it in SvxColorItem 2023-01-12 23:15:58 +00:00
RepositoryModule_host.mk introduce docmodel comp., model::ThemeColor, use it in SvxColorItem 2023-01-12 23:15:58 +00:00
sanitize-ubsan-excludelist
setup.cfg
TEMPLATE.SOURCECODE.HEADER
tsan-suppress.txt update TSAN suppressions 2023-01-30 13:53:45 +00:00

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 and Developers Guide. 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.10
  • macOS:
    • Runtime: 10.15
    • Build: 12 (13 for aarch64) + Xcode 14
  • 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 r23 and SDK 30.0.3
  • Emscripten / WASM:
    • Runtime: a browser with SharedMemory support (threads + atomics)
    • Build: Qt 5.15 with Qt supported Emscripten 1.39.8
    • See README.wasm

Java is required for building many parts of LibreOffice. In TDF Wiki article Development/Java, the exact modules that depend on Java are listed.

The baseline for Java is Java Development Kit (JDK) Version 11 or later. It is possible to build LibreOffice with JDK version 9, but it is no longer supported by the JDK vendors, thus it should be avoided.

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.