Test repository to check push and ssh key
Find a file
Stephan Bergmann ddcc98fa50 Remove obsolete dynamic exception specifications from SDK example C++ code
GCC 11 trunk g++ defaults to C++17 now, so that CustomTarget_odk/build-examples
and CustomTarget_odk/build-examples_java would now fail with "error: ISO C++17
does not allow dynamic exception specifications".

550e0e42d9 "Remove dynamic exception
specifications from cppumaker-generated code" had long since removed the
exception specifications from the underlying (C++ classes representing) UNO
interface types, so just remove them from the SDK example code, too.  An
alternative would have been to make sure those CustomTarget use an old C++
compiler standard.  However, testing that the examples work against a new
standard has probably similar merit to testing that they keep working against
some obsolete standard.

Change-Id: I8ec9ac2f9ced7bd1b746fb00d9bce94bf6aedda5
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/99218
Tested-by: Jenkins
Reviewed-by: Stephan Bergmann <sbergman@redhat.com>
2020-07-22 15:13:24 +02:00
.git-hooks
.github
accessibility
android
animations
apple_remote
avmedia
basctl
basegfx
basic Fix uses of char16_t*/wchar_t* stream inserters 2020-07-21 21:32:10 +02:00
bean
bin Silence GCC 11 trunk -Werror=nonnull in external/boost 2020-07-22 15:05:54 +02:00
binaryurp
bridges
canvas
chart2 chart2: clean-up redundant ShapeFactory::createText() 2020-07-22 11:08:59 +02:00
cli_ure
codemaker
comphelper loplugin:unusedmethods 2020-07-21 08:31:20 +02:00
compilerplugins loplugin:unusedmethods 2020-07-21 08:31:20 +02:00
config_host Revert "configure: add a --with-product-flavor switch" 2020-07-21 13:24:16 +02:00
configmgr
connectivity Fix typo 2020-07-20 05:05:36 +02:00
cppcanvas
cppu
cppuhelper
cpputools
cui tdf#133026: Additions - Parameter support to UNO Command 2020-07-21 22:25:13 +02:00
dbaccess weld PatternControl 2020-07-22 12:24:23 +02:00
desktop
dictionaries@bdedc84127 Update git submodules 2020-07-20 20:25:17 +02:00
distro-configs
drawinglayer limit bitmap size for glow/softedge effects to visible area (tdf#134237) 2020-07-20 12:40:17 +02:00
dtrans dtrans/clipboard: create instances with uno constructors 2020-07-22 14:41:19 +02:00
editeng
embeddedobj embeddedobj/util: create instances with uno constructors 2020-07-22 08:29:47 +02:00
embedserv
emfio
eventattacher
extensions extensions/prop: create instances with uno constructors 2020-07-22 14:40:58 +02:00
external Silence GCC 11 trunk -Werror=nonnull in external/boost 2020-07-22 15:05:54 +02:00
extras tdf#130711: [tr] Extend Autocorrect list for Turkish language (Start with N-P) 2020-07-21 22:28:54 +02:00
filter
forms compact namespace decl 2020-07-20 10:12:57 +02:00
formula
fpicker
framework Revert "configure: add a --with-product-flavor switch" 2020-07-21 13:24:16 +02:00
helpcompiler
helpcontent2@da688f647b Update git submodules 2020-07-22 13:17:35 +02:00
hwpfilter
i18nlangtag
i18npool i18npool: don't break line at slash '/' 2020-07-21 13:17:47 +02:00
i18nutil
icon-themes Remove tagline from brand image and splash screen 2020-07-21 16:00:14 +02:00
idl
idlc
include move PatternField to toolkit headers 2020-07-22 12:24:46 +02:00
instsetoo_native
io
ios tdf#134832: Also run the BitmapTest from vcl 2020-07-22 10:38:22 +03:00
javaunohelper
jurt
jvmaccess
jvmfwk
l10ntools
librelogo
libreofficekit We apparently need to call Application::Quit() on iOS now 2020-07-20 13:14:46 +02:00
lingucomponent this should be a single-instance component 2020-07-20 22:00:09 +02:00
linguistic fix SAL_WARN when instantiating Thesaurus 2020-07-20 17:28:33 +02:00
lotuswordpro
m4
nlpsolver
o3tl
odk Remove obsolete dynamic exception specifications from SDK example C++ code 2020-07-22 15:13:24 +02:00
offapi
officecfg
onlineupdate
oovbaapi
oox ofz#24317 hash too short 2020-07-22 12:52:20 +02:00
opencl
osx
package
pch
postprocess
pyuno
qadevOOo
readlicense_oo
registry compact namespace decl 2020-07-20 10:12:57 +02:00
remotebridges
reportbuilder
reportdesign
ridljar
sal Improved oplugin:staticanonymous -> redundantstatic redux, macOS 2020-07-21 09:19:33 +02:00
salhelper
sax
sc tdf#133026: Additions - Parameter support to UNO Command 2020-07-21 22:25:13 +02:00
scaddins compact namespace decl 2020-07-20 10:12:57 +02:00
sccomp
schema
scp2
scripting
sd tdf#134969 Add solid transparence in color gradient 2020-07-22 11:54:04 +02:00
sdext loplugin:unnecessaryvirtual 2020-07-20 23:03:43 +02:00
setup_native
sfx2 Removed executable permission on cxx file 2020-07-22 13:19:08 +02:00
shell shell/simplemail: create instances with uno constructors 2020-07-21 15:17:19 +02:00
slideshow Deprecated std::result_of has been removed from C++20 2020-07-21 22:50:32 +02:00
smoketest
solenv weld PatternControl 2020-07-22 12:24:23 +02:00
soltools
sot
starmath compact namespace decl 2020-07-20 10:12:57 +02:00
stoc
store
svgio compact namespace: svgio 2020-07-20 08:42:57 +02:00
svl
svtools weld PatternControl 2020-07-22 12:24:23 +02:00
svx weld PatternControl 2020-07-22 12:24:23 +02:00
sw weld PatternControl 2020-07-22 12:24:23 +02:00
swext
sysui
test
testtools
toolkit weld DateControl 2020-07-21 10:25:42 +02:00
tools Fix uses of char16_t*/wchar_t* stream inserters 2020-07-21 21:32:10 +02:00
translations@d602d2af8c
ucb ucb/expand: create instances with uno constructors 2020-07-22 08:30:21 +02:00
ucbhelper
udkapi
uitest
UnoControls
unodevtools
unoidl
unoil
unotest
unotools
unoxml
ure
uui compact namespace decl 2020-07-20 10:12:57 +02:00
vbahelper
vcl weld PatternControl 2020-07-22 12:24:23 +02:00
winaccessibility
wizards
writerfilter tdf#134648 DOCX import: fix bottom auto margin of subitem 2020-07-21 11:01:12 +02:00
writerperfect compact namespace: writerperfect 2020-07-20 08:42:29 +02:00
xmerge
xmlhelp
xmloff compact namespace decl 2020-07-20 10:12:57 +02:00
xmlreader
xmlscript
xmlsecurity compact namespace decl 2020-07-20 10:12:57 +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
config_host_lang.mk.in
configure.ac Revert "configure: add a --with-product-flavor switch" 2020-07-21 13:24:16 +02:00
COPYING
COPYING.LGPL
COPYING.MPL
download.lst external: update pdfium to 4203 2020-07-22 10:40:57 +02:00
g
hardened_runtime.xcent.in
install-sh
leak-suppress.txt
Library_merged.mk
lo.xcent
logerrit
Makefile.fetch
Makefile.gbuild
Makefile.in
README.cross
README.md
README.Solaris
Repository.mk
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.