Test repository to check push and ssh key
Find a file
Seth Chaiklin ad826c2809 Update git submodules
* Update helpcontent2 from branch 'master'
  to 155384c51ee22314c18a428ec7c1c773b222e804
  - tdf#137715 add "text in data range" note to diverse functions
    
      ( scalc/01/04060118.xhp )
        FVSCHEDULE
    
     ( scalc/01/04060103.xhp )
       IRR
    
     ( scalc/01/04060105.xhp )
       AND, OR
    
     ( scalc/01/04060106.xhp )
       SUBTOTAL
    
     ( scalc/01/04060107.xhp )
       FREQUENCY
    
     ( scalc/01/04060119.xhp )
       NPV
    
    Change-Id: I6b6fe55f232bf4aa5e66db1f7fb8e6f6255b15e9
    Reviewed-on: https://gerrit.libreoffice.org/c/help/+/113219
    Tested-by: Jenkins
    Reviewed-by: Seth Chaiklin <sdc.blanco@youmail.dk>
2021-03-27 22:11:07 +01:00
.git-hooks
.github
.vscode
accessibility Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
android Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
animations Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
apple_remote Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
avmedia Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
basctl Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
basegfx Drop these defines 2021-03-26 15:05:44 +01:00
basic loplugin:flatten 2021-03-26 18:02:19 +01:00
bean cid#1473991 Dereference null return value 2021-03-25 15:46:43 +01:00
bin Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
binaryurp Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
bridges Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
canvas Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
chart2 const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
cli_ure Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
codemaker Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
comphelper loplugin:flatten 2021-03-26 18:02:19 +01:00
compilerplugins loplugin:unusedvarsglobal 2021-03-25 14:13:12 +01:00
config_host Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
configmgr Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
connectivity tdf#141115 semi-userfriendly message on UNION query on file driver 2021-03-27 17:34:13 +01:00
cppcanvas vcl: add initializer_list constructor to BitmapPalette and use it 2021-03-26 08:18:19 +01:00
cppu Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
cppuhelper Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
cpputools const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
cui loplugin:flatten 2021-03-26 18:02:19 +01:00
dbaccess loplugin:flatten 2021-03-26 18:02:19 +01:00
desktop lok: mark strings static after pre-init, not after the fork. 2021-03-26 20:42:35 +01:00
dictionaries@a968e48f9b
distro-configs Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
drawinglayer create operator bool for Bitmap 2021-03-26 11:58:03 +01:00
editeng tdf#119292 sc layout: fix overlapping wrapped cell texts 2021-03-26 14:41:03 +01:00
embeddedobj const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
embedserv Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
emfio loplugin:flatten 2021-03-26 18:02:19 +01:00
eventattacher Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
extensions loplugin:flatten 2021-03-26 18:02:19 +01:00
external external: update pdfium to 4450 2021-03-25 09:01:45 +01:00
extras tdf#140839 all ToTD images use 150x150px size 2021-03-25 22:36:16 +01:00
filter vcl: add initializer_list constructor to BitmapPalette and use it 2021-03-26 08:18:19 +01:00
forms const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
formula Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
fpicker const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
framework loplugin:flatten 2021-03-26 18:02:19 +01:00
helpcompiler
helpcontent2@155384c51e Update git submodules 2021-03-27 22:11:07 +01:00
hwpfilter ofz#32499 overflowing pos 2021-03-26 11:51:21 +01:00
i18nlangtag Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
i18npool const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
i18nutil Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
icon-themes Colibre: tdf#141284 Inconsistent Track Changes icons 2021-03-27 14:57:28 +01:00
idl Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
idlc Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
include cid#1473755 Untrusted loop bound 2021-03-27 21:55:55 +01:00
instsetoo_native Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
io Drop these defines 2021-03-26 15:05:44 +01:00
ios Fix editing mistake for iOS build 2021-03-25 15:30:12 +02:00
javaunohelper Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
jurt Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
jvmaccess Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
jvmfwk Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
l10ntools Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
librelogo Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
libreofficekit Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
lingucomponent tdf#124173: Enable thesauruses in the iOS app 2021-03-25 09:06:39 +01:00
linguistic const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
lotuswordpro cid#1474321 make it a little more clear that the size *is* checked 2021-03-26 20:39:57 +01:00
m4 Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
nlpsolver Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
o3tl Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
odk Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
offapi tdf#134734 svx,sd: BackgroundFullSize 2021-03-25 11:11:53 +01:00
officecfg tdf#107588 Assign F4 shortcut to Image Properties in Writer 2021-03-25 14:21:47 +01:00
onlineupdate Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
oovbaapi Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
oox loplugin:flatten 2021-03-26 18:02:19 +01:00
opencl Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
osx Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
package const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
pch Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
postprocess tdf#124173: Enable thesauruses in the iOS app 2021-03-25 09:06:39 +01:00
pyuno Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
qadevOOo Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
readlicense_oo update credits 2021-03-24 17:19:41 +01:00
registry Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
remotebridges Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
reportbuilder Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
reportdesign const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
ridljar Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
sal const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
salhelper Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
sax Revert "Fix typo" 2021-03-24 12:47:08 +01:00
sc cid#1474320 silence Untrusted allocation size 2021-03-26 20:41:33 +01:00
scaddins Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
sccomp Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
schema tdf#134734 tdf#141059 tdf#122508 cui,sw,xmloff: BackgroundFullSize 2021-03-25 09:49:33 +01:00
scp2 Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
scripting Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
sd loplugin:flatten 2021-03-26 18:02:19 +01:00
sdext loplugin:flatten 2021-03-26 18:02:19 +01:00
setup_native
sfx2 loplugin:flatten 2021-03-26 18:02:19 +01:00
shell Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
slideshow loplugin:flatten 2021-03-26 18:02:19 +01:00
smoketest Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
solenv Include the pdfimport library constructor in the mobile apps if enabled 2021-03-25 14:27:34 +01:00
soltools
sot Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
starmath loplugin:flatten 2021-03-26 18:02:19 +01:00
stoc Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
store Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
svgio Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
svl tdf#140968 tdf#140978 XLSX import: fix lost rounded filters 2021-03-25 15:00:31 +01:00
svtools loplugin:flatten 2021-03-26 18:02:19 +01:00
svx tdf#140936 statusbar selection mode control improvements 2021-03-27 09:01:30 +01:00
sw tdf#139667 add or improve List Style tab tooltips 2021-03-27 09:26:18 +01:00
swext Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
sysui Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
test Extract copy&pasted namespace list to XmlTestTools::registerODFNamespaces() 2021-03-26 09:07:59 +01:00
testtools Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
toolkit Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
tools tdf#58745 - Detect end of month when extending a date list 2021-03-25 09:42:40 +01:00
translations@943a62baf9 Update git submodules 2021-03-23 12:48:20 +01:00
ucb const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
ucbhelper Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
udkapi Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
uitest Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
UnoControls loplugin:flatten 2021-03-26 18:02:19 +01:00
unodevtools const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
unoidl loplugin:flatten 2021-03-26 18:02:19 +01:00
unoil Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
unotest
unotools Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
unoxml Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
ure Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
uui Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
vbahelper Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
vcl cid#1473755 Untrusted loop bound 2021-03-27 21:55:55 +01:00
winaccessibility Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
wizards ScriptForge - (scriptforge.py) Session class 2021-03-26 17:31:39 +01:00
writerfilter const OUString -> const OUStringLiteral 2021-03-25 10:06:26 +01:00
writerperfect Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
xmerge Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
xmlhelp Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
xmloff Extract copy&pasted namespace list to XmlTestTools::registerODFNamespaces() 2021-03-26 09:07:59 +01:00
xmlreader Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
xmlscript Using .md extension/Markdown syntax for modules README 2021-03-24 11:46:14 +01:00
xmlsecurity Drop these defines 2021-03-26 15:05:44 +01: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 tdf#124173: Enable thesauruses in the iOS app 2021-03-25 09:06:39 +01:00
COPYING
COPYING.LGPL
COPYING.MPL
download.lst external: update pdfium to 4450 2021-03-25 09:01:45 +01: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 tdf#124173: Enable thesauruses in the iOS app 2021-03-25 09:06:39 +01:00
RepositoryExternal.mk Rename LO Windows arm64 ID to aarch64 2021-03-23 23:46:12 +01: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

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.