Test repository to check push and ssh key
Find a file
Noel Grandin 8aa16f7ae0 dtrans/ftransl: create instances with uno constructors
See tdf#74608 for motivation.

Change-Id: I7068fd727d57258a21001d24d2f6b14fa51f9870
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/99159
Tested-by: Jenkins
Reviewed-by: Noel Grandin <noel.grandin@collabora.co.uk>
2020-07-22 20:33:33 +02:00
.git-hooks
.github
accessibility
android Update paths in Makefile.in and android/.gitignore 2020-07-17 14:35:53 +02:00
animations
apple_remote
avmedia compact namespace: avmedia 2020-07-16 18:05:48 +02:00
basctl
basegfx compact namespace: basegfx,canvas 2020-07-16 18:06:55 +02:00
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 compact namespace: basegfx,canvas 2020-07-16 18:06:55 +02:00
chart2 chart2: clean-up redundant ShapeFactory::createText() 2020-07-22 11:08:59 +02:00
cli_ure
codemaker
comphelper tdf#81522 comphelper: just ignore disposed obj on save 2020-07-22 17:27:55 +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 compact namespace: connectivity 2020-07-18 19:08:12 +02:00
connectivity Fix typo 2020-07-20 05:05:36 +02:00
cppcanvas compact namespace: cppcanvas 2020-07-16 20:37:01 +02:00
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 compact namespace: dbaccess,desktop 2020-07-16 18:06:13 +02:00
dictionaries@8cd579e3a6 Update git submodules 2020-07-22 16:01:45 +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/ftransl: create instances with uno constructors 2020-07-22 20:33:33 +02:00
editeng compact namespace: editeng-filter 2020-07-16 20:31:01 +02:00
embeddedobj embeddedobj/msole: create instances with uno constructors 2020-07-22 17:48:12 +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 [en-US] Added 13 words to autocorrect 2020-07-22 15:38:53 +02:00
filter SVG export: fix lost semi-transparent text on shapes 2020-07-17 10:07:11 +02:00
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@4366b556f4 Update git submodules 2020-07-22 18:49:48 +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 Follow up tdf#132022: Remove Tango icons for LibreLogo 2020-07-17 06:50:25 +02:00
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 package: create instances with uno constructors 2020-07-17 08:47:55 +02:00
pch
postprocess
pyuno
qadevOOo xmloff: remove dead com.sun.star.comp.Impress.XMLStylesExporter 2020-07-17 09:08:11 +02:00
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#132816: update slide "master" option buttons in tabbed ui 2020-07-22 17:57:45 +02:00
sdext loplugin:unnecessaryvirtual 2020-07-20 23:03:43 +02:00
setup_native
sfx2 tdf#130863: autoredact, disable useless checkboxes for regex 2020-07-22 18:56:31 +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 embeddedobj/msole: create instances with uno constructors 2020-07-22 17:48:12 +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 make label fill full area 2020-07-22 18:41:32 +02:00
sw tdf#131288 Chart: fix export of embedded xlsx 2020-07-22 17:45:39 +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 Update git submodules 2020-07-15 16:25:57 +02:00
ucb ucb/ftp: create instances with uno constructors 2020-07-22 17:52:10 +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 Fix typo 2020-07-22 15:37:48 +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 use Clang11's -fpch-instantiate-templates if available 2020-07-17 13:30:55 +02:00
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 Update paths in Makefile.in and android/.gitignore 2020-07-17 14:35:53 +02:00
README.cross
README.md
README.Solaris
Repository.mk
RepositoryExternal.mk python3: update to 3.8.4 2020-07-17 10:15:06 +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.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.