Test repository to check push and ssh key
Find a file
Michael Weghorn 491fa499d6 tdf#135212 Don't crash when unable to create clipboard
Gracefully handle the case where the SalInstance returns an
empty Reference when trying to create clipboard.

Primary selection support on Wayland has only recently been
added to the relevant KDE components ([1], [2]), and an empty
Reference would be returned for the qt5/kf5 VCL plugin when
trying to create create a clipboard for primary selection
in a Plasma Wayland session with that functionality not yet being
available.

Regression from commit 05d286e006
("vcl/clipboard: create instances with uno constructors", 2020-07-07).

[1] https://invent.kde.org/plasma/kwayland-server/-/merge_requests/15
[2] https://invent.kde.org/plasma/kwin/-/merge_requests/27

Change-Id: Ia9016f56b775003b2ffe81a6f3bf44f411ad39a2
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/99871
Tested-by: Jenkins
Reviewed-by: Michael Weghorn <m.weghorn@posteo.de>
2020-07-31 16:45:06 +02:00
.git-hooks
.github
accessibility
android
animations
apple_remote
avmedia
basctl tdf#134887 Rework last item handling in NewToolbarController 2020-07-28 00:44:46 +02:00
basegfx basegfx: remove completly useless namespace opening and closing 2020-07-26 22:16:13 +02:00
basic fix comment 2020-07-30 10:28:46 +02:00
bean
bin make some classes private 2020-07-30 09:44:45 +02:00
binaryurp
bridges Replace brittle gcc3_linux_aarch64 vtableSlotCall with pure assembler code 2020-07-29 09:56:02 +02:00
canvas fix leak in CppunitTest_cppcanvas_test 2020-07-31 14:17:09 +02:00
chart2 Removed executable permission on data files 2020-07-29 09:03:41 +02:00
cli_ure
codemaker
comphelper loplugin:unusedmethods 2020-07-31 11:17:48 +02:00
compilerplugins loplugin:unusedmethods 2020-07-31 11:17:48 +02:00
config_host
configmgr configmgr: Use a proper LanguageTag-based locale fallback mechanism. 2020-07-23 10:40:27 +02:00
connectivity fix leak in Mork::OResultSet 2020-07-30 15:24:59 +02:00
cppcanvas
cppu
cppuhelper Remove no longer relevant assert 2020-07-23 19:49:49 +02:00
cpputools
cui tdf#135321: fix crash when right click empty in Command list 2020-07-31 16:09:25 +02:00
dbaccess dbaccess: create instances with uno constructors 2020-07-31 08:41:02 +02:00
desktop LOK: send state of ShowResolvedAnnotations 2020-07-29 10:19:59 +02:00
dictionaries@8cd579e3a6
distro-configs
drawinglayer
dtrans dtrans/dnd: create instances with uno constructors 2020-07-24 13:25:45 +02:00
editeng move getUIRootDir to AllSettings 2020-07-25 17:23:48 +02:00
embeddedobj
embedserv
emfio
eventattacher
extensions loplugin:unusedmethods 2020-07-30 17:34:39 +02:00
external optimize a bit more conversions to/from Skia bitmap formats 2020-07-29 11:45:31 +02:00
extras tdf#87605 Added a few more terms 2020-07-28 07:49:35 +02:00
filter filter/xsltdialog: create instances with uno constructors 2020-07-25 17:39:26 +02:00
forms weld AbsolutePos 2020-07-23 20:45:17 +02:00
formula
fpicker fpicker/win32: create instances with uno constructors 2020-07-26 22:15:12 +02:00
framework tdf#134887 NewToolbarController: Use different icons for extra large 2020-07-31 09:13:25 +02:00
helpcompiler
helpcontent2@1749b770bb Update git submodules 2020-07-30 17:45:37 +02:00
hwpfilter
i18nlangtag
i18npool expand out macro 2020-07-29 22:17:07 +02:00
i18nutil
icon-themes Sukapura: Update Save icons to make it crisp 2020-07-31 09:13:52 +02:00
idl
idlc
include add queue_draw to force redraw with custom rendering 2020-07-31 11:27:54 +02:00
instsetoo_native tdf#134522 remove --with-build-version ./configure flag 2020-07-23 10:51:30 +02:00
io
ios
javaunohelper
jurt
jvmaccess
jvmfwk
l10ntools
librelogo
libreofficekit
lingucomponent
linguistic
lotuswordpro ofz#24404 row insert attempt in table with same table already in the row 2020-07-29 16:15:34 +02:00
m4
nlpsolver Related tdf#135211: return early if no data 2020-07-28 12:52:20 +02:00
o3tl
odk
offapi tdf#38093 Writer outline folding - feature sensitivity 2020-07-30 12:03:36 +02:00
officecfg tdf#38093 Writer outline folding - .uno:ToggleOutlineContentVisibility 2020-07-30 12:04:39 +02:00
onlineupdate
oovbaapi
oox oox smartart: consider rules when scaling in linear layout 2020-07-31 11:56:23 +02:00
opencl
osx
package package/xstor: create instances with uno constructors 2020-07-26 10:41:17 +02:00
pch
postprocess terminate XDesktop properly in unit tests 2020-07-30 10:49:27 +02:00
pyuno
qadevOOo xmloff: remove dead com.sun.star.comp.Impress.XMLContentExporter 2020-07-24 09:03:22 +02:00
readlicense_oo update credits 2020-07-29 20:45:30 +02:00
registry
remotebridges
reportbuilder
reportdesign move getUIRootDir to AllSettings 2020-07-25 17:23:48 +02:00
ridljar
sal
salhelper
sax
sc avoid config for fuzzing 2020-07-31 14:47:22 +02:00
scaddins terminate XDesktop properly in unit tests 2020-07-30 10:49:27 +02:00
sccomp tdf#135211: fix crash Swarm Non Linear Solver with blank input 2020-07-28 11:42:53 +02:00
schema tdf#38093 Writer outline folding - persistence 2020-07-30 12:05:20 +02:00
scp2
scripting
sd oox smartart: consider rules when scaling in linear layout 2020-07-31 11:56:23 +02:00
sdext
setup_native
sfx2 Notebookbar: skip early init 2020-07-31 14:17:19 +02:00
shell
slideshow
smoketest
solenv add valgrind suppression file 2020-07-31 14:17:34 +02:00
soltools
sot
starmath starmath: create instances with uno constructors 2020-07-26 10:41:52 +02:00
stoc Use comphelper::IsContextFlagActive for flags from comphelper::NewFlagContext 2020-07-25 17:29:23 +02:00
store
svgio
svl replace and drop MiscCfg 2020-07-29 16:48:42 +02:00
svtools tdf#134887 NewToolbarController: Use different icons for extra large 2020-07-31 09:13:25 +02:00
svx Resolves: tdf#134831 reorg to expand inspector to fit full panel size 2020-07-30 12:44:57 +02:00
sw tdf#134965 sw: avoid RemoveFollowFlowLine() SNAFU 2020-07-31 16:31:00 +02:00
swext
sysui Revert "tdf#132787: Don't duplicate hicolor icon theme as gnome" 2020-07-26 19:02:05 +02:00
test terminate XDesktop properly in unit tests 2020-07-30 10:49:27 +02:00
testtools
toolkit cid#1465510 Dereference null return value 2020-07-25 15:01:41 +02:00
tools
translations@d0e75e01d0 Update git submodules 2020-07-27 15:24:25 +02:00
ucb
ucbhelper
udkapi
uitest
UnoControls
unodevtools
unoidl
unoil
unotest
unotools replace and drop SvtExtendedSecurityOptions class 2020-07-29 17:41:33 +02:00
unoxml
ure
uui
vbahelper loplugin:unusedmethods 2020-07-30 17:34:39 +02:00
vcl tdf#135212 Don't crash when unable to create clipboard 2020-07-31 16:45:06 +02:00
winaccessibility
wizards
writerfilter DOCX import: fix overlapping floating tables when anchored inside a table 2020-07-30 11:37:00 +02:00
writerperfect
xmerge
xmlhelp
xmloff tdf#38093 Writer outline folding - persistence 2020-07-30 12:05:20 +02:00
xmlreader
xmlscript
xmlsecurity xmlsecurity: detect unsigned incremental update between signatures 2020-07-24 13:47:08 +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 tdf#134522 remove --with-build-version ./configure flag 2020-07-23 10:51:30 +02:00
config_host_lang.mk.in
configure.ac Port to FreeBSD aarch64 2020-07-29 21:30:23 +02:00
COPYING
COPYING.LGPL
COPYING.MPL
download.lst
g
hardened_runtime.xcent.in
install-sh
leak-suppress.txt
Library_merged.mk
lo.xcent
logerrit Add an optional Gerrit change ID to testfeature 2020-07-30 12:48:37 +02:00
Makefile.fetch
Makefile.gbuild
Makefile.in
README.cross
README.md
README.Solaris
Repository.mk sw: introduce a Library_swqahelper 2020-07-31 10:04:09 +02:00
RepositoryExternal.mk
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.4
  • 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

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 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 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.freenode.net - 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.