git - wrong paths in documentation files

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi folks,
I am looking at the #1357438 BZ about broken links to "How to*" doc files and I am thinking,
about the best solution of this. Problem is with using of %doc macro, which moves/copies
doc files to specific directories of each subpackage. However the Makefile expects that will
be used just one directory, where all documentation will be included.

It can be fixed basically in two ways:

  1) Do not use %doc macro and keep all Doc files under common directory,
       e.g. /usr/share/doc/git/
     ignoring the sub-package that install specific doc files.

  2) Use sed for affected doc files to modify path correctly.

The 1st method seems much better for me, because doc files will be together and in case of changes
of doc files or another split/rename/merge of packages, it will be still OK. The 2nd method would
provide incompatible solution in future when another changes in doc files will be provided or
split of packages will be different.

I haven't seen any requirement in packaging guidelines, that we have to put all files to specific
directories bounded with specific subpackage, so why do not use '/usr/share/doc/git'?. The third option
would be create symlink, but that solution seems ugly to me.

What do you think? In case we will want to change filelist, I would prefer make this change in F26
yet too.

Thanks for feedback/advice,
 Petr



Attachment: signature.asc
Description: OpenPGP digital signature

_______________________________________________
devel mailing list -- devel@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to devel-leave@xxxxxxxxxxxxxxxxxxxxxxx

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Fedora Announce]     [Fedora Kernel]     [Fedora Testing]     [Fedora Formulas]     [Fedora PHP Devel]     [Kernel Development]     [Fedora Legacy]     [Fedora Maintainers]     [Fedora Desktop]     [PAM]     [Red Hat Development]     [Gimp]     [Yosemite News]
  Powered by Linux