Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 19156 - app-admin/syslog-ng-1.6.1-rc1 HTML doc fix
Summary: app-admin/syslog-ng-1.6.1-rc1 HTML doc fix
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Seemant Kulleen (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2003-04-11 13:21 UTC by Andy Dustman
Modified: 2003-05-31 02:43 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
ebuild patch (syslog-ng.patch,660 bytes, patch)
2003-04-11 13:22 UTC, Andy Dustman
Details | Diff
Really fix HTML docs (syslog-ng-real-doc-fix.patch,469 bytes, patch)
2003-05-01 14:58 UTC, Andy Dustman
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Andy Dustman 2003-04-11 13:21:36 UTC
The 1.6.1-rc1 ebuild installs the HTML docs as a tarball; not very useful. The
following patch installs them sensibly. (to be attached)
Comment 1 Andy Dustman 2003-04-11 13:22:31 UTC
Created attachment 10512 [details, diff]
ebuild patch

Unpack HTML docs, install with dohtml
Comment 2 Seemant Kulleen (RETIRED) gentoo-dev 2003-04-12 06:44:16 UTC
thanks andy
Comment 3 Andy Dustman 2003-04-15 11:49:45 UTC
I think think it's kind of silly to unpack syslog-ng.html.tar.gz in ${S}/doc/sgml and that it should be unpacked in ${S} and then simply dohtml syslog-ng.html/*  The current method interjects two levels of otherwise empty directories, because everything else that was in doc/sgml is being installed in the top-level directory. That is, you get this:

/usr/share/doc/syslog-ng-1.6.0_rc1-r1/:
AUTHORS.gz    NEWS.gz    stresstest.sh.gz          syslog-ng.ps.gz
COPYING.gz    PORTS.gz   syslog-ng.conf.demo.gz    syslog-ng.sgml.gz
ChangeLog.gz  README.gz  syslog-ng.conf.sample.gz  syslog-ng.txt.gz
INSTALL.gz    html/      syslog-ng.dvi.gz          syslog2ng.gz
 
/usr/share/doc/syslog-ng-1.6.0_rc1-r1/html:
doc/
 
/usr/share/doc/syslog-ng-1.6.0_rc1-r1/html/doc:
sgml/
 
/usr/share/doc/syslog-ng-1.6.0_rc1-r1/html/doc/sgml:
syslog-ng.html/
 
/usr/share/doc/syslog-ng-1.6.0_rc1-r1/html/doc/sgml/syslog-ng.html:
book1.html         logpath.html    tuning.html  x567.html  x743.html
destinations.html  msgroute.html   x172.html    x601.html  x97.html
intro.html         reference.html  x354.html    x737.html

...whereas my patch gives you this:

/usr/share/doc/syslog-ng-1.6.0_rc1-r2/:
AUTHORS.gz    INSTALL.gz  stresstest.sh.gz          syslog-ng.dvi.gz
ChangeLog.gz  NEWS.gz     syslog2ng                 syslog-ng.ps.gz
COPYING.gz    PORTS.gz    syslog-ng.conf.demo.gz    syslog-ng.sgml.gz
html/         README.gz   syslog-ng.conf.sample.gz  syslog-ng.txt.gz
                                                                                
/usr/share/doc/syslog-ng-1.6.0_rc1-r2/html:
book1.html         logpath.html    tuning.html  x567.html  x743.html
destinations.html  msgroute.html   x172.html    x601.html  x97.html
intro.html         reference.html  x354.html    x737.html
Comment 4 Andy Dustman 2003-04-16 09:44:13 UTC
Please revisit this issue.
Comment 5 Seemant Kulleen (RETIRED) gentoo-dev 2003-04-16 09:57:30 UTC
revisiting
Comment 6 Andy Dustman 2003-05-01 14:58:56 UTC
Created attachment 11364 [details, diff]
Really fix HTML docs

This installs the HTML docs properly. Patch is relative to the current portage
tree syslog-ng-1.6.0_rc1-r2.ebuild. Oh and while we're at it, this updates to
rc3. I would mark as testing because I've only superficially tested it.
Comment 7 Seemant Kulleen (RETIRED) gentoo-dev 2003-05-18 22:46:21 UTC
fixed and also version bumped
Comment 8 Andy Dustman 2003-05-19 10:45:39 UTC
ARGH! It's still wrong. doc/sgml/syslog-ng.html is a *directory*, you need:

dohtml doc/sgml/syslog-ng.html/*

which is what I had in the patch; you left off the /*. You could also have done dohtml -r, but that would have created an additional (useless) directory under html. At the moment, the HTML docs do not install at all.
Comment 9 Seemant Kulleen (RETIRED) gentoo-dev 2003-05-31 02:43:49 UTC
fixed, sorry