Test repository to check push and ssh key
Find a file
Andrea Gelmini 269b8a086e Fix typos
Change-Id: Ia66e31a0ad71dde1a6c1caa911d6083e1fb9eb61
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/104538
Reviewed-by: Julien Nabet <serval2412@yahoo.fr>
Tested-by: Jenkins
2020-10-21 20:37:07 +02:00
.git-hooks
.github
accessibility use tools::Long in accessibility..basctl 2020-10-21 14:34:01 +02:00
android
animations
apple_remote
avmedia use tools::Long in accessibility..basctl 2020-10-21 14:34:01 +02:00
basctl use tools::Long in accessibility..basctl 2020-10-21 14:34:01 +02:00
basegfx use tools::Long in basegfx..chart2 2020-10-21 15:34:16 +02:00
basic use tools::Long in basegfx..chart2 2020-10-21 15:34:16 +02:00
bean
bin
binaryurp
bridges
canvas use tools::Long in basegfx..chart2 2020-10-21 15:34:16 +02:00
chart2 use tools::Long in basegfx..chart2 2020-10-21 15:34:16 +02:00
cli_ure
codemaker
comphelper use tools::Long in comphelper..cui 2020-10-21 14:33:39 +02:00
compilerplugins Fix loplugin:salcall 2020-10-21 15:02:42 +02:00
config_host fix build with box2d 2.4.0 2020-10-17 14:19:44 +02:00
configmgr
connectivity Fix typos 2020-10-21 20:37:07 +02:00
cppcanvas use tools::Long in comphelper..cui 2020-10-21 14:33:39 +02:00
cppu
cppuhelper
cpputools
cui Fix typos 2020-10-21 20:37:07 +02:00
dbaccess Database Wizard: show info label instead of empty list. 2020-10-16 22:36:25 +02:00
desktop new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
dictionaries@8cd579e3a6
distro-configs
drawinglayer new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
editeng new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
embeddedobj
embedserv clang-cl: Adapt Windows-specific code to extended loplugin:cstylecast 2020-10-19 22:01:31 +02:00
emfio new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
eventattacher
extensions Rename CLANG_CC, CLANG_CXX configuration vars (avoid clash with scan-build) 2020-10-16 11:21:27 +02:00
external external/cairo: Support building with ASan/UBSan 2020-10-20 22:16:54 +02:00
extras tdf#130711: [tr] Extend Autocorrect list for Turkish language (Start with R-Z) 2020-10-18 15:01:30 +02:00
filter new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
forms
formula
fpicker
framework fix some *printf which are using "%l" ie. long specifiers 2020-10-16 11:12:31 +02:00
helpcompiler
helpcontent2@a9deae83c3
hwpfilter
i18nlangtag
i18npool fix some *printf which are using "%l" ie. long specifiers 2020-10-16 11:12:31 +02:00
i18nutil
icon-themes Colibre: update large Freeze icons & extra large undo redo icons 2020-10-21 05:41:27 +02:00
idl
idlc fix some *printf which are using "%l" ie. long specifiers 2020-10-16 11:12:31 +02:00
include use tools::Long in basegfx..chart2 2020-10-21 15:34:16 +02:00
instsetoo_native
io
ios Rename CLANG_CC, CLANG_CXX configuration vars (avoid clash with scan-build) 2020-10-16 11:21:27 +02:00
javaunohelper
jurt
jvmaccess
jvmfwk
l10ntools
librelogo
libreofficekit
lingucomponent
linguistic
lotuswordpro ofz#26357 Timeout in lwpfuzzer, 12s -> 1.3s 2020-10-18 20:07:48 +02:00
m4
nlpsolver
o3tl
odk
offapi Fix typos 2020-10-21 20:37:07 +02:00
officecfg tdf#136073 combine glow and softedge sidebar section 2020-10-19 13:06:01 +02:00
onlineupdate
oovbaapi
oox new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
opencl
osx Rename CLANG_CC, CLANG_CXX configuration vars (avoid clash with scan-build) 2020-10-16 11:21:27 +02:00
package
pch
postprocess tdf#137573: The fps_aqua component was missing for macOS 2020-10-18 13:22:14 +02:00
pyuno
qadevOOo
readlicense_oo
registry
remotebridges
reportbuilder
reportdesign new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
ridljar
sal Limit nDecPlaces to a sensible value [-20, 20] 2020-10-18 01:46:58 +02:00
salhelper
sax
sc new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
scaddins
sccomp
schema
scp2
scripting
sd new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
sdext
setup_native
sfx2 mirror changes of ThumbnailView to SfxThumbnailView 2020-10-21 15:07:25 +02:00
shell
slideshow new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
smoketest Removed duplicated include 2020-10-17 14:23:06 +02:00
solenv drop unused suppression 2020-10-21 09:46:22 +02:00
soltools
sot
starmath starmath: use the fastparser API when possible 2020-10-17 15:41:55 +02:00
stoc
store
svgio
svl new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
svtools new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
svx Fix typos 2020-10-21 20:37:07 +02:00
sw Fix one more get_url_for_data_file 2020-10-21 20:35:47 +02:00
swext
sysui
test
testtools fix some *printf which are using "%l" ie. long specifiers 2020-10-16 11:12:31 +02:00
toolkit new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
tools new tools::Degree10 strong typedef 2020-10-21 08:13:05 +02:00
translations@b7dd30b210
ucb
ucbhelper
udkapi
uitest
UnoControls
unodevtools
unoidl tdf#124176: Using pragma once 2020-10-18 10:24:35 +02:00
unoil
unotest
unotools
unoxml
ure
uui
vbahelper
vcl clamp angle to valid value 2020-10-21 20:35:01 +02:00
winaccessibility clang-cl: Adapt Windows-specific code to extended loplugin:cstylecast 2020-10-19 22:01:31 +02:00
wizards
writerfilter tdf#133045 sw: add shape alignment to the top page border 2020-10-20 09:17:32 +02:00
writerperfect writerfilter: use the fastparser API when possible 2020-10-16 14:18:19 +02:00
xmerge
xmlhelp
xmloff tdf#137585 Chart ODF: fix export of DataLabelPlacement::CUSTOM 2020-10-19 14:19:34 +02:00
xmlreader
xmlscript
xmlsecurity xmlsecurity: clean up last raw pdfium call 2020-10-21 14:44:31 +02:00
.buckconfig
.buckversion
.clang-format
.editorconfig
.git-blame-ignore-revs put clang-format commits to .git-blame-ignore-revs 2020-10-18 22:35:07 +02:00
.gitattributes
.gitignore
.gitmodules
.gitpod.dockerfile
.gitpod.yml
.gitreview
antivirusDetection.vbs
autogen.sh
BUCK
config.guess
config.sub
config_host.mk.in Rename CLANG_CC, CLANG_CXX configuration vars (avoid clash with scan-build) 2020-10-16 11:21:27 +02:00
config_host_lang.mk.in
configure.ac Accept iOS SDK 14.1 2020-10-21 10:11:05 +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
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.