Test repository to check push and ssh key
Find a file
Stephan Bergmann 221caface8 More adapting to C++2a char8_t
...in test code that is unhelpfully excluded on macOS, so wasn't covered by
c89a4996b8 "Adapt to C++2a char_t" which I
happened to do on macOS.

Change-Id: I215898a1c468c576d88914ee22deaaaa536d91e9
2018-11-19 15:15:52 +01:00
.git-hooks
accessibility tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
android android: lock away editing mode in separate build flavor 2018-11-13 15:27:57 +01:00
animations
apple_remote
avmedia Adapt to C++2a char_t 2018-11-17 17:17:26 +01:00
basctl weld TreeView 2018-11-19 12:09:25 +01:00
basegfx tdf#121305 Increase accuracy of custom shape circle 2018-11-16 17:45:48 +01:00
basic Adapt to C++2a char_t 2018-11-17 17:17:26 +01:00
bean
bin find-unneeded-includes: sort the output 2018-11-13 09:03:45 +01:00
binaryurp
bridges loplugin:buriedassign in avmedia..cui 2018-11-16 14:03:25 +01:00
canvas tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
chart2 weld TreeView 2018-11-19 12:09:25 +01:00
cli_ure
codemaker
comphelper tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
compilerplugins Take array-to-pointer decay into account in loplugin:redundantcast 2018-11-19 09:25:35 +01:00
config_host Fix creation/removal of GPG socketdir 2018-11-09 15:05:18 +01:00
configmgr Simplify and fix Java UNO API test makefiles 2018-11-09 07:37:00 +01:00
connectivity Fix typos 2018-11-17 19:35:38 +01:00
cppcanvas
cppu loplugin:buriedassign in avmedia..cui 2018-11-16 14:03:25 +01:00
cppuhelper cppCheck narrowed variableScope rEntry 2018-11-11 11:16:31 +01:00
cpputools
cui weld TreeView 2018-11-19 12:09:25 +01:00
dbaccess weld TreeView 2018-11-19 12:09:25 +01:00
desktop weld TreeView 2018-11-19 12:09:25 +01:00
dictionaries@86921a78c4 Revert "lok: calc: fix needed when position caching is disabled" 2018-11-08 14:45:19 +01:00
distro-configs
drawinglayer tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
dtrans Fix typos 2018-11-16 23:33:04 +01:00
editeng tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
embeddedobj Fix typo 2018-11-15 01:21:50 +01:00
embedserv tdf#120703 PVS: V560 A part of conditional expression is always true/false 2018-11-18 12:32:18 +01:00
emfio tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
eventattacher
extensions weld TreeView 2018-11-19 12:09:25 +01:00
external external: update pdfium to 3613 2018-11-19 10:52:21 +01:00
extras weld TreeView 2018-11-19 12:09:25 +01:00
filter weld TreeView 2018-11-19 12:09:25 +01:00
forms tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
formula Adapt to C++2a char_t 2018-11-17 17:17:26 +01:00
fpicker tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
framework tdf#45904 Move XEnumeration Java tests to C++ 2018-11-18 22:03:38 +01:00
helpcompiler
helpcontent2@789b9f5849 Update git submodules 2018-11-19 01:30:30 +01:00
hwpfilter loplugin:staticmethods improvement 2018-11-16 07:26:27 +01:00
i18nlangtag
i18npool loplugin:singlevalfields 2018-11-19 07:42:14 +01:00
i18nutil
icon-themes Add addtextbox link to breeze and colibre icons 2018-11-19 10:51:43 +01:00
idl
idlc
include Related: tdf#108104 Fix nitpick inline in ShapeProperty enum class 2018-11-19 14:00:38 +01:00
instsetoo_native Related: tdf#121134: Changing http to https where possible 2018-11-09 11:44:59 +01:00
io
ios We need share/liblangtag, too 2018-11-12 20:20:52 +02:00
javaunohelper
jurt Fix many Java subsequentcheck test by using JUH 2018-11-09 07:37:50 +01:00
jvmaccess
jvmfwk tdf#120703 PVS: V547 Expression is always true/false 2018-11-10 12:23:42 +01:00
l10ntools cppcheck: fix returnDanglingLifetime (l10ntools) 2018-11-18 15:03:43 +01:00
librelogo Adapt LibreLogo.py to Python 3.7 re.sub change 2018-11-08 11:03:41 +01:00
libreofficekit gtktiledviewer: Handle LOK_CALLBACK_SIGNATURE_STATUS to avoid an assert. 2018-11-15 10:11:16 +01:00
lingucomponent lolugin:staticmethods 2018-11-18 12:51:03 +01:00
linguistic tdf#42949 Fix IWYU warnings in include/svl/* 2018-11-14 09:48:28 +01:00
lotuswordpro loplugin:buriedassign in dbaccess..oox 2018-11-16 14:31:38 +01:00
m4
nlpsolver
o3tl
odk Fix typos 2018-11-18 10:47:52 +01:00
offapi Fix typos 2018-11-19 08:34:08 +01:00
officecfg Make tabbed notebookbar non experimental 2018-11-13 13:28:58 +01:00
onlineupdate fix off by one error 2018-11-18 05:20:02 +01:00
oovbaapi
oox tdf#104579, if no data point shape props are set take the series props 2018-11-19 01:59:35 +01:00
opencl $SC_FORCE_CALCULATION to force Calc use opencl/threads for everything 2018-11-14 16:09:16 +01:00
osx
package loplugin:staticmethods improvement 2018-11-16 07:26:27 +01:00
postprocess
pyuno
qadevOOo tdf#45904 Move XEnumeration Java tests to C++ 2018-11-18 22:03:38 +01:00
readlicense_oo Related: tdf#121134: Changing http to https where possible 2018-11-09 11:50:24 +01:00
registry loplugin:staticmethods improvement 2018-11-16 07:26:27 +01:00
remotebridges
reportbuilder
reportdesign tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
ridljar
sal Fix typos 2018-11-19 08:34:08 +01:00
salhelper
sax clang-tidy: (WIP) bugprone-too-small-loop-variable findings 2 2018-11-10 23:11:28 +01:00
sc Removed duplicated includes 2018-11-19 14:54:41 +01:00
scaddins Adapt to C++2a char_t 2018-11-17 17:17:26 +01:00
sccomp Adapt to C++2a char_t 2018-11-17 17:17:26 +01:00
schema
scp2 Related: tdf#121134: Changing http to https where possible 2018-11-09 11:49:07 +01:00
scripting Guard listener cleanup of BasicProviderImpl 2018-11-12 15:37:26 +01:00
sd NB impress groupedbar compact big update and sync 2018-11-19 14:00:57 +01:00
sdext loplugin:staticmethods improvement 2018-11-16 07:26:27 +01:00
setup_native
sfx2 weld TreeView 2018-11-19 12:09:25 +01:00
shell Fix typos 2018-11-19 08:34:08 +01:00
slideshow loplugin singlevalfields improvement 2018-11-13 12:27:08 +01:00
smoketest
solenv FormattedField is gone 2018-11-19 14:11:29 +02:00
soltools loplugin:buriedassign in sd..writerfilter 2018-11-16 18:42:57 +01:00
sot loplugin:constantparam 2018-11-19 07:43:51 +01:00
starmath weld TreeView 2018-11-19 12:09:25 +01:00
stoc loplugin:buriedassign in sd..writerfilter 2018-11-16 18:42:57 +01:00
store
svgio tdf#120703 PVS: V547 Expression is always true/false 2018-11-10 12:23:42 +01:00
svl Fix typos 2018-11-19 08:33:09 +01:00
svtools -Werror,-Wunused-private-field 2018-11-19 13:38:48 +01:00
svx Simplify containers iterations in svx/source/[f-i]* 2018-11-19 13:17:32 +01:00
sw More adapting to C++2a char8_t 2018-11-19 15:15:52 +01:00
swext Help files: http -> https 2018-11-15 04:50:23 +01:00
sysui Add EMF and WMF mime types to Draw .desktop file 2018-11-14 17:28:59 +01:00
test tdf#45904 Move _XEnumeration for ScCellsEnumeration to C++ 2018-11-14 03:50:27 +01:00
testtools Fix typos 2018-11-19 08:34:08 +01:00
toolkit tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
tools loplugin:constantparam 2018-11-19 07:43:51 +01:00
translations@552fa2fbab Update git submodules 2018-11-17 20:42:39 +01:00
ucb Fix typos 2018-11-18 10:47:52 +01:00
ucbhelper
udkapi
uitest
UnoControls Fix typos 2018-11-09 07:05:30 +01:00
unodevtools
unoidl
unoil
unotest
unotools Use shared methods instead of duplicated code 2018-11-13 12:06:30 +01:00
unoxml loplugin:staticmethods improvement 2018-11-16 07:26:27 +01:00
ure
uui weld TreeView 2018-11-19 12:09:25 +01:00
vbahelper
vcl weld TreeView 2018-11-19 12:09:25 +01:00
winaccessibility
wizards Access2Base - tdf#121342 Increase number of recordsets 2018-11-13 09:12:36 +01:00
writerfilter tdf#42949 Fix IWYU warnings in include/vcl/[ab]* 2018-11-19 09:38:53 +01:00
writerperfect Adapt to C++2a char_t 2018-11-17 17:17:26 +01:00
xmerge
xmlhelp loplugin:useuniqueptr in ResultSetForQuery 2018-11-09 06:41:26 +01:00
xmloff loplugin:staticmethods improvement 2018-11-16 07:26:27 +01:00
xmlreader
xmlscript
xmlsecurity weld TreeView 2018-11-19 12:09:25 +01:00
.buckconfig
.buckversion
.clang-format
.editorconfig
.gitattributes
.gitignore
.gitmodules
.gitreview
autogen.sh
BUCK
config.guess
config.sub
config_host.mk.in Fix creation/removal of GPG socketdir 2018-11-09 15:05:18 +01:00
config_host_lang.mk.in
configure.ac Fix typos 2018-11-19 08:33:09 +01:00
COPYING
COPYING.LGPL
COPYING.MPL
download.lst external: update pdfium to 3613 2018-11-19 10:52:21 +01:00
g
install-sh
leak-suppress.txt
Library_merged.mk
lo.xcent.in
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-blacklist
setup.cfg
TEMPLATE.SOURCECODE.HEADER

LibreOffice

Coverity Scan Build Status CII Best Practices

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 2017
  • macOS:
    • Runtime: 10.9
    • Build: 10.12 + Xcode 8
  • Linux:
    • Runtime: RHEL 6 or CentOS 6
    • Build: GCC 4.8.1 or Clang
  • iOS (only for LibreOfficeKit):
    • Runtime: 11.4 (only support for newer i devices == 64 bit)
    • Build: Xcode 9.3 and iPhone SDK 11.4

At least Clang 3.4.2 is known to be too old to pass the configure.ac check "whether $CXX supports C++17, C++14, or C++11" in its current form (due to the #pragma GCC diagnostic ignored "-Wpragmas" that it does not understand).

If you want to use Clang with the LibreOffice compiler plugins, the minimal version of Clang is 3.8. 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.