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@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org

Reply via email to