Test repository to check push and ssh key
Find a file
Luboš Luňák 5d051f443b build Skia also on Mac
This only builds the library, without using it.

Change-Id: I54e940bcaa61852b831dbe7ae5660a5daf5fe609
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/119356
Tested-by: Jenkins
Reviewed-by: Luboš Luňák <l.lunak@collabora.com>
2021-07-26 13:32:37 +02:00
.git-hooks
.github
.vscode
accessibility
android
animations
apple_remote
avmedia tdf#126665 Remember last used file picker directory 2021-07-12 14:31:20 +02:00
basctl Move svl::Items to include/svl/whichranges.hxx, and unify its usage 2021-07-19 16:33:01 +02:00
basegfx
basic tdf#143332 - Use utl::TextSearch to implement the InStrRev function 2021-07-19 13:03:22 +02:00
bean
bin find-unneeded-includes: Add --headers option 2021-07-15 11:59:52 +02:00
binaryurp binaryurp : use std::mutex in outgoingrequests 2021-07-18 11:37:21 +02:00
bridges flatten RTTI code 2021-07-19 17:52:15 +02:00
canvas
chart2 use officecfg to retrieve OdfDefaultVersion 2021-07-25 20:05:30 +02:00
cli_ure
codemaker
comphelper osl::Mutex->std::mutex in AsyncEventNotifier 2021-07-23 09:59:13 +02:00
compilerplugins no need to allocate these static vars on demand 2021-07-23 11:22:59 +02:00
config_host
configmgr Revert "simplify locking in configmgr" 2021-07-22 21:17:15 +02:00
connectivity
cppcanvas
cppu osl::Mutex->std::mutex in MappingsData 2021-07-19 08:54:19 +02:00
cppuhelper better to use a std::vector here 2021-07-18 11:34:39 +02:00
cpputools
cui use officecfg for default options 2021-07-26 10:58:14 +02:00
dbaccess use officecfg to retrieve OdfDefaultVersion 2021-07-25 20:05:30 +02:00
desktop use officecfg for menu options 2021-07-26 08:26:18 +02:00
dictionaries@01bb1d2c47
distro-configs
drawinglayer use officecfg for drawing options 2021-07-25 20:05:10 +02:00
editeng Make static_casting to the only derived class less verbose 2021-07-22 17:25:12 +02:00
embeddedobj sfx2: handle OnMainThread=true in SfxOfficeDispatch::dispatch() 2021-07-14 11:52:00 +02:00
embedserv
emfio ofz#36481 Timeout 2021-07-25 15:42:16 +02:00
eventattacher osl::Mutex->std::mutex in EventAttacherImpl 2021-07-18 14:54:35 +02:00
extensions do not use "using namespace std" in headers 2021-07-23 10:32:08 +02:00
external build Skia also on Mac 2021-07-26 13:32:37 +02:00
extras Addition of OpenSymbol2 2021-07-24 15:21:11 +02:00
filter IsVertical->IsEffectivelyVertical, GetDirectVertical->GetVertical 2021-07-21 14:03:49 +02:00
forms IsVertical->IsEffectivelyVertical, GetDirectVertical->GetVertical 2021-07-21 14:03:49 +02:00
formula
fpicker
framework simplify SvtDynamicMenuOptions 2021-07-26 10:10:47 +02:00
helpcompiler
helpcontent2@1cd02ab17d Update git submodules 2021-07-26 11:48:14 +02:00
hwpfilter Fix typo 2021-07-19 19:49:09 +02:00
i18nlangtag Resolves: tdf#123466 Add Microsoft ill-used {x-none} to known language tags 2021-07-12 22:00:10 +02:00
i18npool do not use "using namespace std" in headers 2021-07-23 10:32:08 +02:00
i18nutil Add PowerPoint compatible screen size for Impress 2021-07-13 13:05:34 +02:00
icon-themes elementary tdf#143300 add diagonal border line icons 2021-07-22 20:33:08 +02:00
idl
idlc no need to allocate these static vars on demand 2021-07-23 11:22:59 +02:00
include use officecfg for default options 2021-07-26 10:58:14 +02:00
instsetoo_native
io
ios
javaunohelper
jurt
jvmaccess
jvmfwk loplugin:indentation (clang-cl) 2021-07-09 09:15:52 +02:00
l10ntools
librelogo
libreofficekit
lingucomponent do not use "using namespace std" in headers 2021-07-23 10:32:08 +02:00
linguistic osl::Mutex->std::mutex in linguistic 2021-07-18 20:47:06 +02:00
lotuswordpro Fix typo 2021-07-19 19:49:09 +02:00
m4
nlpsolver AbsGTBehavior should implement ILibEngine 2021-07-19 18:01:24 +02:00
o3tl
odk Fix typos 2021-07-18 12:14:16 +02:00
offapi sw bibliography, local copy: add document model & UNO API 2021-07-21 16:42:48 +02:00
officecfg tdf#140107 Remove all collect usage data code. 2021-07-23 13:29:22 +02:00
onlineupdate
oovbaapi
oox tdf#143528 Use triple backquotes+xml to markdown xml part in oox/README.md 2021-07-24 20:09:27 +02:00
opencl
osx
package pass ZipEnumeration around by value 2021-07-21 12:20:23 +02:00
pch
postprocess tdf#133368: update extensions website URLs and use https 2021-07-07 12:45:35 +02:00
pyuno
qadevOOo
readlicense_oo update credits 2021-07-16 23:09:42 +02:00
registry -Werror=maybe-uninitialized 2021-07-22 08:15:30 +02:00
remotebridges
reportbuilder
reportdesign use officecfg to retrieve SaveRelFSys 2021-07-24 16:52:52 +02:00
ridljar
sal no need to allocate these static vars on demand 2021-07-23 11:22:59 +02:00
salhelper
sax use officecfg to retrieve OdfDefaultVersion 2021-07-25 20:05:30 +02:00
sc use officecfg to retrieve OdfDefaultVersion 2021-07-25 20:05:30 +02:00
scaddins Purge out when safe rtl::math ( isValidArcArg / sin / cos ) 2021-07-03 21:57:29 +02:00
sccomp
schema sw bibliography, local copy: add ODF filter 2021-07-23 14:34:35 +02:00
scp2
scripting
sd Avoid some division by zero 2021-07-25 22:35:46 +02:00
sdext sdext.pdfimport: Restore to read font file for the determination... 2021-07-26 08:28:20 +02:00
setup_native
sfx2 simplify SvtDynamicMenuOptions 2021-07-26 10:10:47 +02:00
shell do not use "using namespace std" in headers 2021-07-23 10:32:08 +02:00
slideshow workaround accumulate() ambiguity on Mac with PCH 2021-07-23 10:31:51 +02:00
smoketest
solenv add gbuild support for ObjC/C++ sources from tarballs 2021-07-26 13:32:16 +02:00
soltools
sot
starmath use officecfg to retrieve PrettyPrinting 2021-07-24 09:57:08 +02:00
stoc osl::Mutex->std::mutex in ImplementationEnumeration_Impl 2021-07-19 08:54:03 +02:00
store
svgio
svl expand out contractions in PasswordContainer 2021-07-23 12:36:15 +02:00
svtools UBSAN fix 2021-07-26 12:49:48 +02:00
svx use officecfg for drawing options 2021-07-25 20:05:10 +02:00
sw sw: prefix members of SwXMLTableColContext_Impl, SwXMLTableColumn_Impl, ... 2021-07-26 11:12:44 +02:00
swext
sysui tdf#133368: update extensions website URLs and use https 2021-07-07 12:45:35 +02:00
test Avoid external processes picking up instdir/program/libnspr4.so 2021-07-21 15:27:02 +02:00
testtools
toolkit remove pimpl in AnimatedImagesControlModel 2021-07-22 08:58:31 +02:00
tools tdf#143148 Use pragma once instead of include guards 2021-07-15 08:06:11 +02:00
translations@299af21d9c Update git submodules 2021-07-09 16:19:07 +02:00
ucb no need for a pimpl in ResultSetDataSupplier 2021-07-20 11:55:49 +02:00
ucbhelper no need to allocate Sequence separately in CommandProcessorInfo 2021-07-20 14:52:04 +02:00
udkapi
uitest Revert "uitest: try harder to close the dialog when it fails..." 2021-07-02 21:45:04 +02:00
UnoControls fix the mutex locking in impl_searchTopic 2021-07-22 18:50:49 +02:00
unodevtools
unoidl
unoil
unotest Avoid external processes picking up instdir/program/libnspr4.so 2021-07-21 15:27:02 +02:00
unotools use officecfg for default options 2021-07-26 10:58:14 +02:00
unoxml
ure
uui
vbahelper
vcl vcl: bitmap::CreateFromData add option to reverse alpha (0xff - a) 2021-07-26 01:53:09 +02:00
wasm-qt
winaccessibility wina11y: Deduplicate mapping for IA2TextBoundaryType 2021-07-21 14:35:49 +02:00
wizards ScriptForge - Change copyright dates and names 2021-07-23 18:36:58 +02:00
writerfilter Fix typo 2021-07-24 19:35:05 +02:00
writerperfect
xmerge
xmlhelp Avoid strtol on non-NUL-terminated input 2021-07-23 14:03:11 +02:00
xmloff use officecfg to retrieve OdfDefaultVersion 2021-07-25 20:05:30 +02:00
xmlreader
xmlscript
xmlsecurity pass SvXMLNamespaceMap around by value 2021-07-22 10:16:20 +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 build Skia also on Mac 2021-07-26 13:32:37 +02:00
config_host_lang.mk.in
configure.ac build Skia also on Mac 2021-07-26 13:32:37 +02:00
COPYING
COPYING.LGPL
COPYING.MPL
download.lst curl: upgrade to release 7.78.0 2021-07-22 09:09:30 +02:00
g Add "--progress" agument to the ./g command 2021-07-12 10:55:05 +02:00
hardened_runtime.xcent.in
install-sh
install_deps.sh
leak-suppress.txt
Library_merged.mk
lo.xcent
logerrit Make logerrit more portable 2021-07-13 10:28:36 +02:00
Makefile.fetch
Makefile.gbuild
Makefile.in Avoid bash'ism (comment in line continuation) 2021-07-19 23:55:58 +02:00
README.cross
README.help.md
README.md
README.Solaris
README.wasm
Repository.mk
RepositoryExternal.mk curl: upgrade to release 7.78.0 2021-07-22 09:09:30 +02:00
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.5
  • 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
  • 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.