Bug 284126 - Documentation required for compilation but should be optional
Summary: Documentation required for compilation but should be optional
Status: RESOLVED FIXED
Alias: None
Product: digikam
Classification: Applications
Component: Documentation (show other bugs)
Version: 2.2.0
Platform: Compiled Sources Linux
: NOR normal
Target Milestone: ---
Assignee: Digikam Developers
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-10-15 19:54 UTC by Andrzej
Modified: 2022-12-24 16:20 UTC (History)
1 user (show)

See Also:
Latest Commit:
Version Fixed In: 4.3.0


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Andrzej 2011-10-15 19:54:50 UTC
Version:           2.2.0 (using KDE 4.7.1) 
OS:                Linux

when I do not have linuxdoc-tools installed there is no complain during cmake but there are errors during compilation

Reproducible: Didn't try

Steps to Reproduce:
try to compile digiKam without linuxdoc-tools installed

Actual Results:  
relevant part of make output:

Linking CXX executable digikamdatabaseserver
[ 58%] Built target digikamdatabaseserver
[ 58%] Generating index.cache.bz2
file:///usr/share/apps/ksgmltools2/customization/dtd/kdex.dtd:101: warning: failed to load external entity "file:///usr/share/xml/docbook/xml-dtd-4.5/docbookx.dtd"
%DocBookDTD;
            ^
Entity: line 1:
 %DocBookDTD;
             ^
file:///usr/share/apps/ksgmltools2/customization/dtd/modifications.elements:42: validity error : PEReference: %div.title.content; not found
<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo,
                                         ^
file:///usr/share/apps/ksgmltools2/customization/dtd/modifications.elements:42: parser error : ContentDecl : Name or '(' expected
<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo,
                                         ^
file:///usr/share/apps/ksgmltools2/customization/dtd/modifications.elements:42: parser error : expected '>'
<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo,
                                           ^
file:///usr/share/apps/ksgmltools2/customization/dtd/modifications.elements:42: parser error : Content error in the external subset
<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo,
                                           ^
index.docbook:29: parser error : Entity 'language' not defined
<book lang="&language;">
                      ^
index.docbook:81: parser error : Entity 'FDLNotice' not defined
<legalnotice>&FDLNotice;</legalnotice>


Expected Results:  
lack of linuxdoc-tools should not prevent compilation

OS: Linux (i686) release 3.0.4
Compiler: gcc
Comment 1 caulier.gilles 2011-10-17 10:53:14 UTC
Git commit b2832d201702251d400d3f2816eeab07a3235853 by Gilles Caulier.
Committed on 17/10/2011 at 12:51.
Pushed by cgilles into branch 'master'.

set doc dir optional for compilation
CCBUGS: 284126

M  +4    -1    CMakeLists.txt

http://commits.kde.org/scratch/mwiesweg/digikam-sc/b2832d201702251d400d3f2816eeab07a3235853
Comment 2 caulier.gilles 2011-10-17 10:55:01 UTC
doc dir is now optional into git/master, but your compilation error is due to a missing DTD file from KDELibs. Check your system

Gilles Caulier
Comment 3 Andrzej 2011-10-17 21:40:39 UTC
Thank you.

I would rather say that kdelibs depends on /usr/share/xml/docbook/xml-dtd-4.5/docbookx.dtd from linuxdoc-tools package.
Comment 4 caulier.gilles 2011-10-17 22:09:49 UTC
With my commit, problem is fixed for you now ?

Gilles Caulier
Comment 5 Andrzej 2011-10-18 18:25:58 UTC
I'm not able to clone git repository:

-> ./download-repos
Cloning into core...
error: RPC failed; result=7, HTTP code = 0
fatal: The remote end hung up unexpectedly
Could not clone http://anongit.kde.org/digikam onto core
 
- Failed to populate gits repositories, aborting.
Comment 6 caulier.gilles 2011-10-18 20:31:47 UTC
It's a network problem with your computer... Try again

Gilles Caulier
Comment 7 Andrzej 2011-10-19 22:16:23 UTC
I changed:
# git clone http://anongit.kde.org/digikam-software-compilation digikam-sc
into
# git clone git://anongit.kde.org/digikam-software-compilation digikam-sc

and I manged to download repository. ;) (maybe a coincidence)


and coming back to the bug it still persist:

Linking CXX shared module ../../../lib/digikamimageplugin_transform.so
[ 99%] Built target digikamimageplugin_transform                                                                                                                                    
[ 99%] Built target digikamdatabaseserver_automoc
Linking CXX executable digikamdatabaseserver
[100%] Built target digikamdatabaseserver                                                                                                                                           
[100%] Generating index.cache.bz2
file:///usr/share/apps/ksgmltools2/customization/dtd/kdex.dtd:101: warning: failed to load external entity "file:///usr/share/xml/docbook/xml-dtd-4.5/docbookx.dtd"                 
%DocBookDTD;
            ^
Entity: line 1: 
 %DocBookDTD; 
             ^
file:///usr/share/apps/ksgmltools2/customization/dtd/modifications.elements:42: validity error : PEReference: %div.title.content; not found
<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo,
                                         ^
file:///usr/share/apps/ksgmltools2/customization/dtd/modifications.elements:42: parser error : ContentDecl : Name or '(' expected
<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo,
                                         ^
file:///usr/share/apps/ksgmltools2/customization/dtd/modifications.elements:42: parser error : expected '>'
<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo,
                                           ^
file:///usr/share/apps/ksgmltools2/customization/dtd/modifications.elements:42: parser error : Content error in the external subset
<!ELEMENT book %ho; ((%div.title.content;)?, bookinfo,
                                           ^
index.docbook:29: parser error : Entity 'language' not defined
<book lang="&language;">
                      ^
Comment 8 caulier.gilles 2014-08-23 11:37:24 UTC
documentation can be disable with a cmake flags at compilation time :

https://projects.kde.org/projects/extragear/graphics/digikam/digikam-software-compilation/repository/revisions/master/entry/CMakeLists.txt#L42

Gilles cAulier