[Bug 674188] Review Request: libzeitgeist - Library to access zeitgeist; needed by synapse

[bugzilla at redhat.com]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.


https://bugzilla.redhat.com/show_bug.cgi?id=674188

--- Comment #7 from Michael Schwendt <mschwendt at gmail.com> 2011-02-06 15:08:14 EST ---
%doc and %docdir compete with eachother.
It's as follows:


  %doc /some/file

includes /some/file in the package and marks it as documentation.



  %docdir /some/path/
  /some/path/file1
  /some/path/file2
  /some/path/file3

can save you a few %doc attributes. It is equivalent to:

  %doc /some/path/file1
  %doc /some/path/file2
  %doc /some/path/file3

However, it does not include a directory entry for /some/path (rpm -qlpv would
not show the ^d entry for /some/path). You would need to include the directory
separately.



There is the much shorter form

  %doc /some/path/

which includes the directory /some/path and additionally marks every file in it
as documentation. It is equivalent to:

  %dir /some/path/
  %doc /some/path/*

However, it also doesn't mark the directory /some/path as %doc, just all
ordinary files in it.



So, in

  %docdir /some/path/
  %doc /some/path/

the %docdir line is superfluous. Using %docdir can be helpful, if you don't
include a full tree of files, but specific file names as above in the file1,
file2, file3 case (where the build of an update would break if files are
missing). Of course, you can mark each file %doc instead and achieve the same
thing. ;)

-- 
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.