On Sun, May 06, 2012 at 08:06:42PM +0100, Ken Moffat wrote:
> On Sun, May 06, 2012 at 10:14:19AM -0700, Fernando de Oliveira wrote:
> > Hi, Ken,
> > 
> > Thanks for the upgrades.
> > 
> > 1. I have in my script:
> > 
> >                 make install                      &&
> >                 install -v -m644 docs/*.{css,html} \
> >                     /usr/share/gtk-doc/html/gegl
> > 
> > I do not use "--enable-gtk-doc", but /usr/share/gtk-doc/html/gegl gets 
> > populated.
> > 
> 
>  1.1 - I'm on a different machine today, with an older babl, so I
> can't conveniently test at the moment.  But my impression was that
> at least one stylesheet and html file were installed by 'make
> install'.  Will recheck later this week.
> 
 'make install' installs gegl.css and operations.html.  The later is
nicely formatted, and all the links appear to be within this same
document.

 The following html files are NOT installed: *.h.html (these just
pretty up the headers with colours and add a title of 'Enscript
Output' to the browser window), and api.html.

 The api.html file looks similar to operations.html, and uses the
same gegl.css stylesheet.  It says its both a tutorial and a
reference for the C API of GEGL.  Looks like it ought to be
installed.

 For the headers, I find it easier to read the canonical versions in
/usr/include.

 There is also class-hierarchy.html which pulls in images/gegl.ico,
devhelp.css, but (from looking at it and the stylesheet in  a term)
appears to have no useful content - I can see a reference to a
non-existent index.html, and a claim to be a javascript script, but I
don't grok it.  However, when I look at it in the browser, it appears
to provide information on the classes, with a -/+ selection to
hide/show more details (by default, not shown).  I suppose this too
ought to be installed, but the details baffle me.  The file gegl.ico
is tiny, and unreadable, and I don't know if it appears, or not, in
the non-installed version of the html - if I maximize gegl.ico in
'display' it's blurred.  I don't think that icon is useful - unlike
the GEGL.png and GEGL.svg images which are *not* apparently
referenced.

 Note that there is no obvious way to force the EXTRA_DIST or
BUILT_EXTRA_DIST files to be installed, and index.html apparently
requires (at least) asciidoc to create it.

 I was going to ask if the installed version of class-hierarchy.html
works ok for you in a graphical browser, and if you said yes I was
going to go with installing all the css and html files your way.
But let's just bite the bullet and install images/* too.

ĸen
-- 
das eine Mal als Tragödie, das andere Mal als Farce
-- 
http://linuxfromscratch.org/mailman/listinfo/blfs-dev
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page

Reply via email to