Should files under %{_datadir}/gtk-doc/html be marked as %doc? They are API docs for libraries which are extracted using the gtk-doc toolset and viewable in devhelp. I've never seen a set of files that was necessary for the runtime operation of a library (and doubt that I will... they're API docs and usually included in a -devel subpackage.) On my current system I haven't found any files in %{_datadir}/gtk-doc/html that are marked as %doc.
-Toshio
Toshio Kuratomi wrote:
Should files under %{_datadir}/gtk-doc/html be marked as %doc? They are API docs for libraries which are extracted using the gtk-doc toolset and viewable in devhelp. I've never seen a set of files that was necessary for the runtime operation of a library (and doubt that I will... they're API docs and usually included in a -devel subpackage.) On my current system I haven't found any files in %{_datadir}/gtk-doc/html that are marked as %doc.
%doc +1
-- Rex
Toshio Kuratomi wrote:
Should files under %{_datadir}/gtk-doc/html be marked as %doc? They are API docs for libraries which are extracted using the gtk-doc toolset and viewable in devhelp. I've never seen a set of files that was necessary for the runtime operation of a library (and doubt that I will... they're API docs and usually included in a -devel subpackage.) On my current system I haven't found any files in %{_datadir}/gtk-doc/html that are marked as %doc.
I think they should be marked %doc. (I added that to my working spec for libgpod some time ago. I was planning to put that into libgpod if/when I get to update the package.)
On Thu, 2007-06-28 at 18:28 -0700, Toshio Kuratomi wrote:
Should files under %{_datadir}/gtk-doc/html be marked as %doc? They are API docs for libraries which are extracted using the gtk-doc toolset and viewable in devhelp. I've never seen a set of files that was necessary for the runtime operation of a library (and doubt that I will... they're API docs and usually included in a -devel subpackage.) On my current system I haven't found any files in %{_datadir}/gtk-doc/html that are marked as %doc.
They should be considered %doc, yes. But the right way to do so is to get it added to the list of docDirs within rpm. Attached patch should do it.
Jeremy
On Thu, 2007-06-28 at 22:08 -0400, Jeremy Katz wrote:
On Thu, 2007-06-28 at 18:28 -0700, Toshio Kuratomi wrote:
Should files under %{_datadir}/gtk-doc/html be marked as %doc? They are API docs for libraries which are extracted using the gtk-doc toolset and viewable in devhelp. I've never seen a set of files that was necessary for the runtime operation of a library (and doubt that I will... they're API docs and usually included in a -devel subpackage.) On my current system I haven't found any files in %{_datadir}/gtk-doc/html that are marked as %doc.
They should be considered %doc, yes. But the right way to do so is to get it added to the list of docDirs within rpm. Attached patch should do it.
Great! Are you sending this on or should I open a bug against rpm?
-Toshio
On Thu, 2007-06-28 at 19:17 -0700, Toshio Kuratomi wrote:
On Thu, 2007-06-28 at 22:08 -0400, Jeremy Katz wrote:
On Thu, 2007-06-28 at 18:28 -0700, Toshio Kuratomi wrote:
Should files under %{_datadir}/gtk-doc/html be marked as %doc? They are API docs for libraries which are extracted using the gtk-doc toolset and viewable in devhelp. I've never seen a set of files that was necessary for the runtime operation of a library (and doubt that I will... they're API docs and usually included in a -devel subpackage.) On my current system I haven't found any files in %{_datadir}/gtk-doc/html that are marked as %doc.
They should be considered %doc, yes. But the right way to do so is to get it added to the list of docDirs within rpm. Attached patch should do it.
Great! Are you sending this on or should I open a bug against rpm?
That mail was cc'd to rpm-maint. So I'll get it pushed through
Jeremy
On Thu, 2007-06-28 at 22:08 -0400, Jeremy Katz wrote:
On Thu, 2007-06-28 at 18:28 -0700, Toshio Kuratomi wrote:
Should files under %{_datadir}/gtk-doc/html be marked as %doc? They are API docs for libraries which are extracted using the gtk-doc toolset and viewable in devhelp. I've never seen a set of files that was necessary for the runtime operation of a library (and doubt that I will... they're API docs and usually included in a -devel subpackage.) On my current system I haven't found any files in %{_datadir}/gtk-doc/html that are marked as %doc.
They should be considered %doc, yes. But the right way to do so is to get it added to the list of docDirs within rpm. Attached patch should do it.
To be honest rather than a hard coded list in files.c we probably want a configurable list of dirs as a macro so policy can be site/distro/os specific.
Paul
packaging@lists.fedoraproject.org