Bug 227349 - graphics/lensfun: no documentation installed
Summary: graphics/lensfun: no documentation installed
Status: Open
Alias: None
Product: Ports & Packages
Classification: Unclassified
Component: Individual Port(s) (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Alexey Dokuchaev
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2018-04-07 17:37 UTC by freebsd
Modified: 2019-10-27 03:49 UTC (History)
1 user (show)

See Also:
bugzilla: maintainer-feedback? (danfe)


Attachments
svn-diff-lensfun-docs (6.24 KB, patch)
2018-06-21 20:18 UTC, Walter Schwarzenfeld
no flags Details | Diff
svn-diff-lensfun-0.3.95 (13.15 KB, patch)
2018-10-21 14:54 UTC, Walter Schwarzenfeld
no flags Details | Diff
svn-diff-lensfun-0.3.2 (6.91 KB, patch)
2019-08-14 12:23 UTC, Walter Schwarzenfeld
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description freebsd 2018-04-07 17:37:12 UTC
pkg-plist shows nothing in terms of documentation, and "pkg info -l lensfun" shows nothing installed.
Comment 1 Walter Schwarzenfeld freebsd_triage 2018-06-21 20:18:19 UTC
Created attachment 194470 [details]
svn-diff-lensfun-docs
Comment 2 Tobias Kortkamp freebsd_committer freebsd_triage 2018-10-21 13:57:50 UTC
Comment on attachment 194470 [details]
svn-diff-lensfun-docs

-%%PYHELPERS%%bin/g-lensfun-update-data
-%%PYHELPERS%%bin/lensfun-add-adapter
-%%PYHELPERS%%bin/lensfun-update-data
+bin/g-lensfun-update-data
+bin/lensfun-add-adapter
+bin/lensfun-update-data
...
+man/man1/g-lensfun-update-data.1.gz
+man/man1/lensfun-add-adapter.1.gz
+man/man1/lensfun-update-data.1.gz

This doesn't look right.  Clearly various option combinations (e.g.,
with DOCS=off, PYHELPERS=off) have not been through a test build.
Comment 3 Walter Schwarzenfeld freebsd_triage 2018-10-21 14:18:12 UTC
There is another error (maybe, from the cmake update)
bin/mkdir -p /ram/usr/ports/graphics/lensfun/work/lensfun-0.3.2
CMake Error at /usr/local/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:137 (message):
  Could NOT find Doxygen (missing: DOXYGEN_EXECUTABLE)
Call Stack (most recent call first):
  /usr/local/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:378 (_FPHSA_FAILURE_MESSAGE)
  /usr/local/share/cmake/Modules/FindDoxygen.cmake:615 (find_package_handle_standard_args)
  docs/CMakeLists.txt:2 (FIND_PACKAGE)


-- Configuring incomplete, errors occurred!
See also "/ram/usr/ports/graphics/lensfun/work/lensfun-0.3.2/CMakeFiles/CMakeOutput.log".
See also "/ram/usr/ports/graphics/lensfun/work/lensfun-0.3.2/CMakeFiles/CMakeError.log".
*** Error code 1
Comment 4 Walter Schwarzenfeld freebsd_triage 2018-10-21 14:28:20 UTC
There is newer version lensfun-0.3.95.
Comment 5 Walter Schwarzenfeld freebsd_triage 2018-10-21 14:30:32 UTC
(In reply to w.schwarzenfeld from comment #3)
This error was a typo in my Makefile (seems I changed something unwanted).
Comment 6 Walter Schwarzenfeld freebsd_triage 2018-10-21 14:54:33 UTC
Created attachment 198435 [details]
svn-diff-lensfun-0.3.95

I hope this is right now (not sure about the pkg-plist).
Comment 7 Alexey Dokuchaev freebsd_committer freebsd_triage 2018-11-07 08:38:22 UTC
Please note that version 0.3.95 is described as alpha by the upstream, so it probably better if the port serves stable version.  If there are some particularly interesting changes/fixes you want to see included with the port, consider cherry-picking them and adding as patches.
Comment 8 Walter Schwarzenfeld freebsd_triage 2019-08-14 12:23:39 UTC
Created attachment 206532 [details]
svn-diff-lensfun-0.3.2
Comment 9 Alexey Dokuchaev freebsd_committer freebsd_triage 2019-10-25 04:23:39 UTC
It looks like that this documentation is purely for developers of lensfun-based applications, isn't it?

In this case it's actually useless for the FreeBSD Ports *users* (consumers), being of no interest to them.  Software developers most likely won't rely on the API documentation bits installed by any OS package manager as it might be incomplete or outdated, and would look for it elsewhere, e.g. online.
Comment 10 freebsd 2019-10-27 03:49:38 UTC
(In reply to Alexey Dokuchaev from comment #9)
I can't remember the circumstances where I encountered this, but it was as a user of a port which used lensfun.  I think I was trying to see if a particular lens was in the database, and how I might add one on my system.