< CalligraRevision as of 04:29, 22 November 2015 by Frinring (talk | contribs) (dead link to KOffice wide icons)(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff) Contents 1 General 2 Design Documents and usecases 3 Calligra Wide Technologies 4 Common specifications 5 Todo for the libraries 6 License cleanup 6.1 Detected issues reported by Debian 6.1.1 ZIP files 6.1.2 Minified js files 6.1.3 Color profiles (ICC, ICM) 6.1.4 Java jar files 6.1.5 Binaries 7 Brainstorming General General overview (10km) Design Documents and usecases Collaboration Bibliography Outliners Open Street Map Integration ShapeSelector Master Documents (Words) Outline (Words) Colordialogs Images Calligra Wide Technologies Plugins Flake Pigment KoText Kross KOffice and ODF File filters Dockers KoAbstraction: library utilizing facade design patter in order to simplify implementation of custom graphical interfaces for various applications Interactional Tools: tools with support of complex modifiers Common specifications mouse keyboard modifiers Hierarchy of what the koffice-libraries provide upon linking to them. Todo for the libraries In the 2.0 release the libs are shared only by the applications and external users will not be able to depend on forward compatibility of the libraries as shipped in 2.0 There are several things in the KOffice libraries that have to be renamed/deleted and generally cleaned up before we can make the libs become binary+source compatible in future features. Lets keep a list of things on a Refactor Todo page. License cleanup GPL code in LGPL libs/ dir: obtained using grep -lR "GNU General"|grep -e '\.h$' -e '\.cpp' -e '\.cc'|grep -v -e test -e benchmarks -e parser. Please remove items from the list when fixed. vectorimage/libwmf/qwmf.cc vectorimage/libwmf/qwmf.h Maybe also this - GPL code in filters/ dir: libmso/msodraw.h libmso/msoleps.h libmso/shapes2.cpp sheets/qpro/libqpro/qpro/common.h sheets/qpro/libqpro/qpro/formula.h sheets/qpro/libqpro/qpro/record_factory.h sheets/qpro/libqpro/qpro/record.h sheets/qpro/libqpro/qpro/stream.h sheets/qpro/libqpro/qpro/tablenames.h sheets/qpro/libqpro/src/formula.cc sheets/qpro/libqpro/src/record.cc sheets/qpro/libqpro/src/record_factory.cc sheets/qpro/libqpro/src/stream.cc sheets/qpro/libqpro/src/tablenames.cc words/msword-odf/conversion.cpp words/msword-odf/conversion.h words/msword-odf/document.cpp words/msword-odf/document.h words/msword-odf/drawclient.cpp words/msword-odf/exceptions.h words/msword-odf/graphicshandler.cpp words/msword-odf/graphicshandler.h words/msword-odf/msdoc.h words/msword-odf/mswordodfimport.cpp words/msword-odf/mswordodfimport.h words/msword-odf/paragraph.cpp words/msword-odf/paragraph.h words/msword-odf/tablehandler.cpp words/msword-odf/tablehandler.h words/msword-odf/texthandler.cpp words/msword-odf/texthandler.h words/msword-odf/versionmagic.h words/msword-odf/wv2/src/associatedstrings.h words/msword-odf/wv2/src/properties97.cpp words/msword-odf/wv2/src/styles.cpp words/msword-odf/wv2/src/textconverter.cpp words/msword-odf/wv2/src/ustring.cpp words/msword-odf/wv2/src/utilities.cpp words/msword-odf/wv2/src/word95_generated.cpp words/msword-odf/wv2/src/word95_helper.cpp words/msword-odf/wv2/src/word97_generated.cpp words/msword-odf/wv2/src/word97_helper.cpp words/msword-odf/wv2/src/word_helper.cpp words/msword-odf/wv2/src/wv2version.cpp Detected issues reported by Debian ZIP files libs/flake/tests/store.zip (png and jpg files) PROPOSAL: if general license applies, no further action. RESOLUTION: no further action. filters/libmsooxml/doc/presetShapeDefinitions.xml.zip (only an xml file) PROPOSAL: if general license applies, no further action. RESOLUTION: no further action. stage/templates/exportHTML/templates/stage.zip: This zip contains several png files which copyright and licensing I'd appreciate to be confirmed. It also contains a css where I'd assume general license applies and a minified js file (see next section) PROPOSAL: if general license applies for png/jpg/css, no further action. Read next section. PENDING Minified js files Minified js files are considered compiled files in Debian, and require source code (the non minified js) to produce the minified/compiled file on package build. js/jquery-min.js (in stage/templates/exportHTML/templates/stage.zip) PROPOSAL: provided non-minified source and procedure to generate minified js (possibly at build time) RESOLUTION: removed (was unused and only in by accident) kexi/webforms/webroot/extjs/ext-all.js kexi/webforms/webroot/extjs/extjs/adapter/ext/ext-base.js PROPOSAL1: provided non-minified source and procedure to generate minified js (possibly at build time) PROPOSAL2: remove webforms as already done in master. RESOLUTION: webforms already removed. Color profiles (ICC, ICM) We're concerned about license for these profiles. In some cases, neither licensing nor copyright is clear. Metadata is helpful, but not enough. Public domain profiles are ok, but there must be a way to verify it. For instance: download url where the authorship/license is stated. If color profiles (as binary file) are generated from a human readable source, then having source (with licensing information) would be helpful as well. Note: I used iccdump from debian package argyll to get profile metadata. (argyll package is https://packages.debian.org/sid/argyll ) krita/data/profiles/WideGamut.icm (No copyright) krita/data/profiles/sRGB.icm (No copyright) PROPOSAL: verify authorship and licensing of these files. RESOLUTION: files were removed krita/data/profiles/scRGB.icm (© Cyrille Berger) Verified. For instance: http://commits.kde.org/calligra/d97b7d6a5e46c057f6660cd76409b2eb62943612 PROPOSAL: If assessment is correct, no further action. RESOLUTION: no further action. krita/data/profiles/krita25_lcms-builtin-sRGB_g100-truegamma.icc (No copyright, use freely) PROPOSAL: verify authorship and licensing of this file. RESOLUTION: Author and licensing is known. plugins/colorengines/lcms2/colorprofiles/data/fogra27l.icm (public domain) According to metadata, profile is public domain, yet the origin is needed for verification. PROPOSAL1: verify authorship and licensing of this file. PROPOSAL2: fogra27l is superseded by fogra39l. Using fogra39l would lead to the same situation. See also http://www.color.org/fogra39.xalter PROPOSAL3: switch to a verified free profile. DECISION: Remove from calligra RESOLUTION: Awaiting for removal. plugins/colorengines/lcms2/colorprofiles/data/CMY.icm (copyright Sun Microsystems, 1996) This is very problematic. Debian packages can't ship this file without clarifying licensing which I couldn't find anywhere. PROPOSAL1: verify authorship and licensing of this file. PROPOSAL2: switch to a verified free profile. DECISION: Remove from calligra and add a free profile RESOLUTION: free profile added, awaiting for removal. Java jar files jar files are binary files, as such, in Debian we need the source code of those files and generate them on package build (or removing the files from the tarball and adding dependencies on the packages that provide these files). In the jar case, there are some pointers on where the jar comes from, but still bundling a generated binary is not desirable. The fixes for that from the licensing point of view are: - Removing the feature - If the jar generates code needed at build time, adding the required (source) files which are generated from the jar. But not the jar. Also include a script or document a procedure how to get those files. - If the jar is required as a runtime dependency, you could either add a run time dependency on a separate package providing that jar or generate the jar at build time. filters/libmso/generated/mso.jar As per README in that directory this jar generates some code that's used later. PROPOSAL: Describe (or script) the procedure to generate the code and remove the jar file. PENDING (Jos pinged about it on mailinglist) filters/plan/mpxj/planconvert/jar/PlanConvert.jar The feature looks good, but maybe since there's already a cmake switch to enable it the java part could be a separated dependency rather that included in calligra itself. For instance: providing a separate package for mpx conversion which calligra(plan) would invoke if feature is enabled. PROPOSAL1: bundling source java files and build jar PROPOSAL2: depend on external package. PENDING Binaries These are binary files which should be avoided in an upstream tarball if possible. 3rdparty/google-breakpad/src/client/mac/gcov/libgcov.a 3rdparty/google-breakpad/src/third_party/linux/lib/glog/libglog.a 3rdparty/google-breakpad/src/third_party/linux/lib/gflags/libgflags.a 3rdparty/google-breakpad/src/tools/windows/binaries/symupload.exe 3rdparty/google-breakpad/src/tools/windows/binaries/dump_syms.exe PROPOSAL: remove these files. PENDING References: http://lists.kde.org/?l=calligra-devel&m=141409908920334&w=2 (From Raúl Sánchez) Brainstorming Brainstorming Retrieved from "https://community.kde.org/index.php?title=Calligra/Libs&oldid=44945" This page was last edited on 22 November 2015, at 04:29. Content is available under Creative Commons License SA 4.0 unless otherwise noted.