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=583058

--- Comment #8 from Jaroslav Reznik <[email protected]> 2010-05-18 11:21:15 
EDT ---
(In reply to comment #6)
> %{_docdir}/HTML/en/grantlee-apidocs still seems a bit strange, maybe
> %{_docdir}/HTML/grantlee-apidocs/en is more appropriate if we consider the
> fedora-release-notes package.
> 
> ls /usr/share/doc/HTML/fedora-release-notes/
> 
>  cs-CZ  es-ES  index.html  nl-NL  pt-PT  uk-UA
>  en-US  fr-FR  it-IT       pl-PL  sv-SE  zh-CN
> 
> The installation path and subpackage name for html documentation is really a
> mess in fedora and need further consideration.
> 
> The guideline only has one line about this - if there's a lot of 
> documentation,
> consider putting it into a subpackage.
> 
> http://fedoraproject.org/wiki/PackagingGuidelines#Documentation
> 
> Actually, we now have several subpackage name for html documention.
> E.g
> -doc
> -docs
> -devel-doc
> -devel-docs
> -apidocs
> -manual
> 
> 
> We also have several installation path for those html files(normally built by
> docbook or doxygen).
> 
> %{_docdir}/%{name}-%{version}
> %{_docdir}/%{name}-[subpackagename]-%{version}
> %{_docdir}/%{name}
> %{_docdir}/HTML/%{name}
> %{_docdir}/HTML/[locale]/%{name}
> %{_datadir}/gtk-doc/html/%{name}
> 
> In java package guideline,we have
> %{_datadir}/javadoc/%{name}-%{version} for -javadoc subpackage
> %{_docdir}/%{name}-[subpackagename]-%{version} for -manual subpackage
> 
> 
> I think add a fixed installation path for html apidocs or enduser manuals like
> man or info will benefit all of us a lot .    

Indeed it's a mess, so we are trying to fix it at least on our KDE side. But
sistribution wide solution would be really very nice.

-- 
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.
_______________________________________________
package-review mailing list
[email protected]
https://admin.fedoraproject.org/mailman/listinfo/package-review

Reply via email to