Test repository to check push and ssh key
Find a file
Noel Grandin 6c724e18c2 use more string_view in i18nlangtag
Change-Id: I92e3d60180c31d765994a2212e1c4547c09c93d2
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/133517
Tested-by: Jenkins
Reviewed-by: Noel Grandin <noel.grandin@collabora.co.uk>
2022-04-28 11:45:56 +02:00
.git-hooks
.github
.vscode Fix typos 2022-03-13 19:17:37 +01:00
accessibility loplugin:passstuffbyref 2022-04-20 15:24:34 +02:00
android android: Slightly clean up style of LOKitTileProvider#resetParts 2022-04-27 05:51:32 +02:00
animations
apple_remote
avmedia Fix typo 2022-04-13 15:07:01 +02:00
basctl new loplugin:stringviewvar looks for OUString vars that can be 2022-04-19 18:31:10 +02:00
basegfx add string_view wrappers for rtl::math::stringToDouble 2022-04-27 12:19:55 +02:00
basic cid#738565 Uninitialized scalar field 2022-04-27 15:58:45 +02:00
bean
bin find-unneeded-includes: bail out early if no files are found with --recursive 2022-04-25 08:43:38 +02:00
binaryurp Pick better variable types 2022-04-14 09:58:00 +02:00
bridges loplugin:stringview 2022-04-25 23:58:46 +02:00
canvas loplugin:stringview check for getToken and trim 2022-04-10 12:59:38 +02:00
chart2 add string_view wrappers for rtl::math::stringToDouble 2022-04-27 12:19:55 +02:00
cli_ure
codemaker use more string_view in codemaker 2022-04-27 16:45:41 +02:00
comphelper add o3tl::toUInt32 2022-04-26 19:37:20 +02:00
compilerplugins add o3tl::toUInt32 2022-04-26 19:37:20 +02:00
config_host make Calc jumbo sheets an explicit build feature 2022-03-01 10:48:13 +01:00
configmgr Adapt function's interface to change from OUString to std::u16string_view 2022-04-26 15:43:59 +02:00
connectivity add string_view wrappers for rtl::math::stringToDouble 2022-04-27 12:19:55 +02:00
cppcanvas
cppu use more string_view in cppu 2022-04-21 15:29:33 +02:00
cppuhelper Use o3tl::make_unsigned in some places 2022-04-26 17:04:01 +02:00
cpputools cpputools : use std::mutex instead of osl::Mutex 2022-04-01 10:07:55 +02:00
cui tdf#126658 UI improvements to Arrow Styles tab in Line dialog 2022-04-27 10:16:08 +02:00
dbaccess officecfg,unotools,framework,sfx2: store ReadOnly for recent docs 2022-04-26 10:39:31 +02:00
desktop cid#1504268 Silence false data race condition warning 2022-04-26 11:54:28 +02:00
dictionaries@e0a820ca5c Update git submodules 2022-04-18 07:06:31 +02:00
distro-configs Drop unused LanguageTool extension 2022-04-26 10:08:54 +02:00
drawinglayer Introduce a better mechanism to suppress false loplugin warnings 2022-04-25 18:21:24 +02:00
editeng Fix typos 2022-04-27 19:42:03 +02:00
embeddedobj tdf#147589 In document with OLE link, don't show temp-file is in use 2022-03-21 10:25:03 +01:00
embedserv
emfio Remove brittle test from WmfTest 2022-04-24 14:56:24 +02:00
eventattacher Update remaining DevGuide wiki links. 2022-04-13 08:16:52 +02:00
extensions loplugin:stringviewparam 2022-04-19 11:32:56 +02:00
external ofz: Use-of-uninitialized-value 2022-04-26 11:36:47 +02:00
extras tdf#143956 Remove page size of Writer templates 3 2022-04-26 09:42:26 +02:00
filter Two more uses of rtl::createUriCharClass 2022-04-26 10:41:42 +02:00
forms loplugin:passstuffbyref 2022-04-20 15:24:34 +02:00
formula add o3tl::toUInt32 2022-04-26 19:37:20 +02:00
fpicker loplugin:stringviewparam 2022-04-25 23:24:04 +02:00
framework officecfg,unotools,framework,sfx2: store ReadOnly for recent docs 2022-04-26 10:39:31 +02:00
helpcompiler
helpcontent2@b6accc5eaf Update git submodules 2022-04-28 08:28:09 +02:00
hwpfilter remove static buffer 2022-04-27 09:44:55 +02:00
i18nlangtag use more string_view in i18nlangtag 2022-04-28 11:45:56 +02:00
i18npool loplugin:stringviewparam convert methods using copy() 2022-04-17 10:27:33 +02:00
i18nutil add o3tl::toUInt32 2022-04-26 19:37:20 +02:00
icon-themes tdf#144788 Split up footnotes and endnotes in Navigator 2022-04-28 10:48:38 +02:00
idl loplugin:stringviewparam convert methods using copy() 2022-04-17 10:27:33 +02:00
idlc use more string_view in idlc 2022-04-28 11:03:47 +02:00
include use more string_view in i18nlangtag 2022-04-28 11:45:56 +02:00
instsetoo_native Depend on 64-bit packages for aarch64 as well 2022-03-25 12:06:37 +01:00
io loplugin:stringview more o3tl conversion 2022-04-12 12:42:15 +02:00
ios
javaunohelper Don't use Library_tl in URE libraries 2022-02-25 08:20:55 +01:00
jurt Fix jurt/source/pipe/staticsalhack.cxx 2022-02-28 18:11:23 +01:00
jvmaccess loplugin:stringviewparam whitelist some more functions 2022-04-13 08:38:53 +02:00
jvmfwk use more string_view in jvmfwk 2022-04-15 21:33:17 +02:00
l10ntools address potential find/rfind failures 2022-04-15 14:06:06 +02:00
librelogo LibreLogo: add basic HTML formatting support to LABEL 2022-04-22 20:46:35 +02:00
libreofficekit sw content controls: add LOK API 2022-04-22 13:20:09 +02:00
lingucomponent -Werror,-Wunused-but-set-variable 2022-03-28 16:34:38 +02:00
linguistic use more string_view 2022-04-11 17:44:46 +02:00
lotuswordpro loplugin:stringviewparam convert methods using compareTo 2022-04-02 16:55:36 +02:00
m4
nlpsolver
o3tl Avoid unhelpful loplugin:stringviewvar 2022-04-20 13:39:09 +02:00
odk tdf#143122 - Port Java examples to C++ 2022-04-20 14:51:40 +02:00
offapi Extend UNO API for custom jump lists 2022-04-26 11:46:17 +02:00
officecfg tdf#144788 Split up footnotes and endnotes in Navigator 2022-04-28 10:48:38 +02:00
onlineupdate
oovbaapi
oox sd theme: add PPTX import for shape fill color effects 2022-04-28 08:15:54 +02:00
opencl loplugin:stringviewparam whitelist some more functions 2022-04-13 08:38:53 +02:00
osx
package Use o3tl::make_unsigned in some places 2022-04-26 17:04:01 +02:00
pch
postprocess
pyuno loplugin:stringviewparam convert methods using copy() 2022-04-17 10:27:33 +02:00
qadevOOo tdf#45904: Remove ScHeaderFieldObj Java test 2022-03-04 17:16:06 +01:00
readlicense_oo update credits 2022-04-27 13:12:17 +02:00
registry loplugin:stringviewparam convert methods using indexOf 2022-04-02 13:31:19 +02:00
remotebridges
reportbuilder
reportdesign loplugin:passstuffbyref 2022-04-20 15:24:34 +02:00
ridljar
sal add string_view wrappers for rtl::math::stringToDouble 2022-04-27 12:19:55 +02:00
salhelper
sax add string_view wrappers for rtl::math::stringToDouble 2022-04-27 12:19:55 +02:00
sc reduce Calc's INITIALCOLCOUNT to 1 2022-04-28 05:51:53 +02:00
scaddins Pick better variable types 2022-04-26 16:24:26 +02:00
sccomp tdf#139734 removing redundant asserts after MacrosTest::loadFromDesktop 2022-02-28 22:21:28 +01:00
schema sw content controls, checkbox: add ODT filter 2022-04-27 10:16:19 +02:00
scp2 Drop unused LanguageTool extension 2022-04-26 10:08:54 +02:00
scripting loplugin:stringviewparam convert methods using copy() 2022-04-17 10:27:33 +02:00
sd UITest_impress_tests: fix sporadic failures 2022-04-27 23:43:59 +02:00
sdext loplugin:stringviewparam whitelist some more functions 2022-04-13 08:38:53 +02:00
setup_native Drop unused LanguageTool extension 2022-04-26 10:08:54 +02:00
sfx2 tdf#131760 change category of Styles command 2022-04-27 09:37:41 +02:00
shell Extend UNO API for custom jump lists 2022-04-26 11:46:17 +02:00
slideshow Resolves: tdf#143615 clamp relative times to 1.0 2022-04-14 19:29:03 +02:00
smoketest
solenv tdf#126658 UI improvements to Arrow Styles tab in Line dialog 2022-04-27 10:16:08 +02:00
soltools cid#1500573 silence Untrusted loop bound 2022-03-03 10:15:26 +01:00
sot Use o3tl::make_unsigned in some places 2022-04-26 17:04:01 +02:00
starmath tdf#148819: let the scroller know the custom widget's line size 2022-04-27 22:36:06 +02:00
static Fix typo 2022-03-30 20:47:23 +02:00
stoc Two more uses of rtl::createUriCharClass 2022-04-26 10:41:42 +02:00
store
svgio add string_view wrappers for rtl::math::stringToDouble 2022-04-27 12:19:55 +02:00
svl use string_view in ImpSvNumberInputScan::StringToDouble 2022-04-27 14:01:47 +02:00
svtools Resolves: tdf#141441 get and set selected entry when "unfrozen" 2022-04-25 18:09:24 +02:00
svx sd theme: add PPTX import for shape fill color effects 2022-04-28 08:15:54 +02:00
sw tdf#144788 Split up footnotes and endnotes in Navigator 2022-04-28 10:48:38 +02:00
swext cid#1500542 swext: Wiki Publisher: "Insecure TLS version" 2022-03-07 11:01:32 +01:00
sysui
test loplugin:stringview check for getToken and trim 2022-04-10 12:59:38 +02:00
testtools Recheck modules t* with IWYU 2022-04-02 23:32:08 +02:00
toolkit loplugin:passstuffbyref 2022-04-20 15:24:34 +02:00
tools use more string_view in tools 2022-04-27 14:02:16 +02:00
translations@c2b26d58f5 Update git submodules 2022-04-26 14:34:33 +02:00
ucb Improve some signed vs. unsigned comparisons 2022-04-26 17:08:19 +02:00
ucbhelper Use o3tl::make_unsigned in some places 2022-04-26 17:04:01 +02:00
udkapi
uitest tdf#128610: math: add UItest 2022-03-14 15:25:08 +01:00
UnoControls Recheck modules [uU]* with IWYU 2022-04-12 15:20:47 +02:00
unodevtools use more string_view in unodevtools 2022-04-28 11:45:30 +02:00
unoidl address review comments on "use more string in unoidl.." 2022-04-22 13:27:56 +02:00
unoil
unotest Fix the test failing when invalid certificate is in cert store 2022-03-01 15:17:55 +01:00
unotools add string_view wrappers for rtl::math::stringToDouble 2022-04-27 12:19:55 +02:00
unoxml Recheck modules [uU]* with IWYU 2022-04-12 15:20:47 +02:00
ure Provide unoidl-write also for the SDK 2022-02-25 16:46:26 +01:00
uui loplugin:stringviewparam convert methods using copy() 2022-04-17 10:27:33 +02:00
vbahelper loplugin:stringviewparam whitelist some more functions 2022-04-13 08:38:53 +02:00
vcl make SalLayoutGlyphsImpl::cloneCharRange() work for RTL runs too 2022-04-28 11:08:16 +02:00
winaccessibility loplugin:stringviewparam 2022-03-24 09:28:29 +01:00
wizards Access2Base - (access2base.py) FIX remove duplicate 2022-04-26 10:28:04 +02:00
writerfilter tdf#148380 sw ms: import select fldLock'd fields as FIXED 2022-04-27 12:04:01 +02:00
writerperfect loplugin:stringview check for getToken and trim 2022-04-10 12:59:38 +02:00
xmerge
xmlhelp use more string_view in xml* 2022-04-15 20:11:48 +02:00
xmloff tdf#146449 sw: fix Z-order after undoing 2022-04-27 16:44:09 +02:00
xmlreader
xmlscript add o3tl::toUInt32 2022-04-26 19:37:20 +02:00
xmlsecurity loplugin:passstuffbyref 2022-04-20 15:24:34 +02:00
.buckconfig
.buckversion
.clang-format
.editorconfig
.git-blame-ignore-revs
.gitattributes
.gitignore .gitignore: Add Qt Creator's '.qtc_clangd' 2022-03-30 10:46:37 +02:00
.gitmodules
.gitpod.dockerfile
.gitpod.yml
.gitreview
antivirusDetection.vbs
autogen.sh
BUCK
config.guess
config.sub
config_host.mk.in android: Stop using ANDROID_SDK_HOME env variable 2022-04-20 05:19:20 +02:00
config_host_lang.mk.in
configure.ac Fix determining ZXING_CFLAGS for --with-system-zxing 2022-04-28 09:56:32 +02:00
COPYING
COPYING.LGPL
COPYING.MPL
download.lst Drop unused LanguageTool extension 2022-04-26 10:08:54 +02:00
g
hardened_runtime.xcent.in
install-sh
install_deps.sh
leak-suppress.txt
Library_merged.mk
lo.xcent
logerrit
Makefile.fetch Drop unused LanguageTool extension 2022-04-26 10:08:54 +02:00
Makefile.gbuild
Makefile.in Fix for xcode-ide-integration 2022-04-26 10:20:04 +02:00
README.cross
README.help.md
README.md Update README.md files 2022-04-16 20:43:11 +02:00
README.Solaris
Repository.mk Drop unused CT2N extension 2022-04-26 10:08:30 +02:00
RepositoryExternal.mk Sync the two definitions of python_arch_subdir 2022-02-23 10:17:22 +01:00
RepositoryFixes.mk
RepositoryModule_build.mk
RepositoryModule_host.mk serialize linking of large libraries only if USE_LD is not set 2022-04-21 14:17:58 +02:00
sanitize-ubsan-excludelist
setup.cfg
TEMPLATE.SOURCECODE.HEADER
tsan-suppress.txt more tsan suppressions 2022-03-01 14:46:30 +01:00

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 and Developers Guide. 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.13
    • Build: 11.0 + Xcode 12.5
  • Linux:
    • Runtime: RHEL 7 or CentOS 7
    • Build: either GCC 7.0.0; or Clang 8.0.1 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 12.0.1. 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.