Test repository to check push and ssh key
Find a file
Noel Grandin 8fed86b3eb add some more TypeWhichId annotations
and update the idl compiler to cope with namespaced class names

Change-Id: I7b5242f872e358bc3c5584f543767719172aac83
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/129026
Tested-by: Jenkins
Reviewed-by: Noel Grandin <noel.grandin@collabora.co.uk>
2022-01-27 14:10:25 +01:00
.git-hooks
.github
.vscode vscode-ide-integration: use gdb from $PATH by default 2022-01-17 15:06:32 +01:00
accessibility Recheck modules [a-c]* with IWYU 2022-01-13 08:26:15 +01:00
android
animations
apple_remote
avmedia tdf#145538 - Use range based for loops 2022-01-17 20:49:57 +01:00
basctl move ToolBoxItemId into its own header 2022-01-26 12:07:18 +01:00
basegfx tdf#145614 Convert #define to enum or constexpr 2022-01-19 06:55:12 +01:00
basic tdf#90341 Clean Up Excessive const_cast'ing 2022-01-25 19:54:54 +01:00
bean
bin ensure no 'angle' is used in a GtkLabel 2022-01-26 20:56:36 +01:00
binaryurp
bridges WASM UNO: add a minimal dummy bridge 2022-01-19 14:26:09 +01:00
canvas Recheck modules [a-c]* with IWYU 2022-01-13 08:26:15 +01:00
chart2 add some more TypeWhichId annotations 2022-01-27 14:10:25 +01:00
cli_ure
codemaker Improve DBG_UNHANDLED_EXCEPTION output a bit 2022-01-23 09:50:33 +01:00
comphelper fix opengl slide transition 2022-01-21 13:44:57 +01:00
compilerplugins WASM open links in new browser tabs 2022-01-20 10:26:04 +01:00
config_host upgrade to box2d 2.4.1 2022-01-24 09:58:45 +01:00
configmgr Recheck modules [a-c]* with IWYU 2022-01-13 08:26:15 +01:00
connectivity Mysql/MariaDB: remove obsolete comment in views 2022-01-27 13:10:38 +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 WASM UNO: add a minimal dummy bridge 2022-01-19 14:26:09 +01:00
cpputools Recheck modules [a-c]* with IWYU 2022-01-13 08:26:15 +01:00
cui add some more TypeWhichId annotations 2022-01-27 14:10:25 +01:00
dbaccess Avoid warn:dbaccess:828616:828616:dbaccess/source/core/dataaccess/ModelImpl.cxx 2022-01-27 08:36:54 +01:00
desktop desktop lok, export options: allow passing through a JSON string as-is 2022-01-26 09:31:21 +01:00
dictionaries@d37591fce4 Update git submodules 2022-01-19 22:46:16 +01:00
distro-configs WASM add strip flags to configure.ac 2022-01-19 12:00:48 +01:00
drawinglayer avoid Skia GPU surfaces for small virtual devices (bsc#1183308) 2022-01-24 14:40:22 +01:00
editeng add some more TypeWhichId annotations 2022-01-27 14:10:25 +01:00
embeddedobj Recheck modules [e-f]* with IWYU 2022-01-17 01:33:35 +01:00
embedserv
emfio Recheck modules [e-f]* with IWYU 2022-01-17 01:33:35 +01:00
eventattacher
extensions Related: tdf#146971 remove %PRODUCTNAME from accessible-description 2022-01-25 13:24:23 +01:00
external external/mdds: Avoid -Werror=use-after-free (GCC 12 trunk) 2022-01-27 08:00:48 +01:00
extras WASM --enable-wasm-strip now skips lots of LO code 2022-01-20 12:28:54 +01:00
filter this should be a normal dialog type 2022-01-26 18:04:23 +01:00
forms Recheck modules [e-f]* with IWYU 2022-01-17 01:33:35 +01:00
formula Recheck modules [e-f]* with IWYU 2022-01-17 01:33:35 +01:00
fpicker Recheck modules [e-f]* with IWYU 2022-01-17 01:33:35 +01:00
framework WASM make test file loading work 2022-01-20 14:27:16 +01:00
helpcompiler
helpcontent2@714b152de6 Update git submodules 2022-01-27 04:09:19 +01:00
hwpfilter Make HWPStyle::style type-safe 2022-01-13 14:29:12 +01:00
i18nlangtag tdf#146602 Add Pennsylvania Dutch {pdc-US} 0x06AF to language list 2022-01-26 17:03:52 +01:00
i18npool Add CIRCLED NUMBER TWENTY ONE through CIRCLED NUMBER FIFTY to numbring list 2022-01-27 14:00:51 +01:00
i18nutil
icon-themes
idl add some more TypeWhichId annotations 2022-01-27 14:10:25 +01:00
idlc
include add some more TypeWhichId annotations 2022-01-27 14:10:25 +01:00
instsetoo_native Make installer compression tool configurable 2022-01-22 10:14:23 +01:00
io
ios
javaunohelper
jurt Avoid loplugin:salcall 2022-01-23 12:28:20 +01:00
jvmaccess
jvmfwk
l10ntools
librelogo
libreofficekit Add HAVE_(UNIX_)DLAPI config header define 2022-01-18 13:44:53 +01:00
lingucomponent WASM --enable-wasm-strip now skips lots of LO code 2022-01-20 12:28:54 +01:00
linguistic
lotuswordpro ofz#44080 throw exception on a negative length 2022-01-26 14:49:11 +01:00
m4
nlpsolver
o3tl
odk Let CppunitTest_odk_checkapi build against the SDK include directory 2022-01-19 23:00:55 +01:00
offapi remove css:💹:XDataInterpreter 2022-01-23 12:45:18 +01:00
officecfg Resolves tdf#128258 - Draw a dotted line before hidden columns/rows 2022-01-27 10:31:52 +01:00
onlineupdate
oovbaapi vba: add support for Application.WindowState + test 2022-01-27 07:38:09 +01:00
oox Add missing test dependencies 2022-01-20 21:17:16 +01:00
opencl
osx Add more source files for debugging convenience 2022-01-27 13:15:39 +01:00
package WASM make test file loading work 2022-01-20 14:27:16 +01:00
pch
postprocess WASM open links in new browser tabs 2022-01-20 10:26:04 +01:00
pyuno
qadevOOo
readlicense_oo update credits 2022-01-26 14:51:20 +01:00
registry
remotebridges
reportbuilder
reportdesign Use o3tl::convert instead of OutputDevice::LogicToLogic 2022-01-22 20:02:15 +01:00
ridljar
sal WASM setup as non-multiuser, desktop build 2022-01-19 10:50:35 +01:00
salhelper
sax WASM make test file loading work 2022-01-20 14:27:16 +01:00
sc add some more TypeWhichId annotations 2022-01-27 14:10:25 +01:00
scaddins
sccomp
schema
scp2
scripting make comphelper::OInterfaceContainerHelper4 more threadsafe 2022-01-14 21:04:10 +01:00
sd add some more TypeWhichId annotations 2022-01-27 14:10:25 +01:00
sdext
setup_native
sfx2 use WindowStateMask::Size 2022-01-27 10:51:54 +01:00
shell WASM open links in new browser tabs 2022-01-20 10:26:04 +01:00
slideshow
smoketest
solenv gbuild: fix spurious rebuilds from gb_LinkTarget__use_libraries 2022-01-26 08:07:46 +01:00
soltools
sot
starmath add some more TypeWhichId annotations 2022-01-27 14:10:25 +01:00
static Fix typos 2022-01-21 12:51:49 +01:00
stoc Let loplugin:nullptr look into template instantiations 2022-01-15 15:58:07 +01:00
store Let loplugin:nullptr look into template instantiations 2022-01-15 15:58:07 +01:00
svgio
svl fix opengl slide transition 2022-01-21 13:44:57 +01:00
svtools Resolves tdf#128258 - Draw a dotted line before hidden columns/rows 2022-01-27 10:31:52 +01:00
svx add some more TypeWhichId annotations 2022-01-27 14:10:25 +01:00
sw add some more TypeWhichId annotations 2022-01-27 14:10:25 +01:00
swext
sysui change rpm compression algorithm to multi threaded xz 2022-01-23 15:13:03 +01:00
test
testtools
toolkit WASM --enable-wasm-strip now skips lots of LO code 2022-01-20 12:28:54 +01:00
tools Improve DBG_UNHANDLED_EXCEPTION output a bit 2022-01-23 09:50:33 +01:00
translations@59aa671612 Update git submodules 2022-01-26 14:15:58 +01:00
ucb ucb: add more webdav-curl doc to README 2022-01-26 18:50:07 +01:00
ucbhelper fix opengl slide transition 2022-01-21 13:44:57 +01:00
udkapi
uitest
UnoControls tdf#145614 Convert #define to enum or constexpr 2022-01-19 06:55:12 +01:00
unodevtools
unoidl
unoil
unotest
unotools WASM --enable-wasm-strip now skips lots of LO code 2022-01-20 12:28:54 +01:00
unoxml
ure
uui
vbahelper
vcl Add a SAL_INFO listing types on pasteboard 2022-01-27 13:14:26 +01:00
winaccessibility
wizards
writerfilter Add simple unit test for recent fix to take layoutInCell into consideration 2022-01-27 11:53:52 +01:00
writerperfect WASM --enable-wasm-strip now skips lots of LO code 2022-01-20 12:28:54 +01:00
xmerge
xmlhelp
xmloff Fix typos 2022-01-20 15:16:55 +01:00
xmlreader
xmlscript
xmlsecurity Make Certificate not found dialog async 2022-01-24 13:46:57 +01: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 Make installer compression tool configurable 2022-01-22 10:14:23 +01:00
config_host_lang.mk.in
configure.ac icu: use libo_CHECK_SYSTEM_MODULE 2022-01-23 17:30:56 +01:00
COPYING
COPYING.LGPL
COPYING.MPL
download.lst upgrade to box2d 2.4.1 2022-01-24 09:58:45 +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
Makefile.fetch
Makefile.gbuild gbuild: build static LO / link static executables 2022-01-12 11:12:46 +01:00
Makefile.in Add <module>.*all aliases to .all* and update help 2022-01-17 11:10:34 +01:00
README.cross
README.help.md
README.md
README.Solaris
Repository.mk The Emscripten FS image isn't installed anymore 2022-01-21 15:24:25 +01:00
RepositoryExternal.mk Fix gtk3_kde5 build when qt5/kf5 VCL plugins are not built 2022-01-27 12:04:24 +01:00
RepositoryFixes.mk WASM more initial bits and pieces 2022-01-19 10:49:40 +01:00
RepositoryModule_build.mk
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: 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.