the eclass documentation should be totally scrapped: http://devmanual.gentoo.org/eclass-reference/index.html eclasses can (and should) be self-documenting now via the eclass-manpages package if we want pretty web pages (rather than man pages), then i'd suggest someone put together an awk to auto-generate it from eclasses and output into guidexml rather than the devmanual
I'll look into what would be required to auto-generate them so the eclass documentation fits in like it does now.
i was suggesting scrapping as part of the unification of disparate manuals make the autogeneration output integrate into guidexml, not devmanual ... one less thing to convert later
Converting man pages into devmanual is a heck of a lot easier than converting devmanual into guidexml (devmanual needs a huge number of guidexml extensions which probably won't ever happen).
no one is talking about converting man pages. in fact, i say quite the opposite in the original comment. expanding on guidexml is a possibility. devmanual should go away.
Which is all very nice in theory, but in practice the reason devmanual didn't use guidexml still stands: it's a huge amount of effort. For practical reasons, the way the devmanual is currently is the only way it's going to work until someone with a lot of spare time and enough patience to deal with XSLT comes along and puts in the work.
well it's a good thing we a QA team to work on that sort of thing
(In reply to comment #6) > well it's a good thing we a QA team to work on that sort of thing > We do?
I was under the impression that Gentoo had barely enough of the QA team to keep up with the basics, and that converting a large document to and maintaining a large document in a rather inconvenient format was substantially beyond its current capabilities. But if I'm wrong there, then yes, switching to guidexml is the way to go.
if that's true, then the people doing nothing should make way for the people doing the work
By not making requests that they spend all their time messing around with impractical formats and changing things for aesthetic reasons?
i'm not sure what requests you're referring to, but that certainly has nothing to do with this
Updating summary
Created attachment 163942 [details] sed script to convert .eclass files to devmanual compatible pages I stumbled on this bug and I wrote this sed script. Apply with the --quiet option. If this is what you are looking for, I can work on improving the script to do what needs to be done.
(In reply to comment #13) > Created an attachment (id=163942) [details] > sed script to convert .eclass files to devmanual compatible pages > > I stumbled on this bug and I wrote this sed script. Apply with the --quiet > option. If this is what you are looking for, I can work on improving the > script to do what needs to be done. > It is good, but not perfect. It doesn't output VARIABLES, only functions. Here is my test: http://devmanual.gentoo.org/eclass-reference/xfconf.eclass/index.html (not linked from anywhere yet)
(In reply to comment #14) > (In reply to comment #13) > > Created an attachment (id=163942) [details] [details] > > sed script to convert .eclass files to devmanual compatible pages > > > > I stumbled on this bug and I wrote this sed script. Apply with the --quiet > > option. If this is what you are looking for, I can work on improving the > > script to do what needs to be done. > > > > It is good, but not perfect. It doesn't output VARIABLES, only functions. > Here is my test: > http://devmanual.gentoo.org/eclass-reference/xfconf.eclass/index.html (not > linked from anywhere yet) Scrap that. I'm going to use eclass-manpages and man2html to skip the xml step. Re-assigning to myself and will update this bug when complete. New proto: http://devmanual.gentoo.org/eclass-reference/xorg-2.eclass/index.html
FYI, this is completed. Sadly, I have not investigated a way to add the link to the main page. Generated daily: http://devmanual.gentoo.org/eclass-reference/index.html
There is now a link to "Eclass Reference Pages" on the main index.html. Fixed on the server-side script that runs the Makefile.