Re: [Opencxx-users] Makefile.am fixes

[Grzegorz J. <ja...@he...>]

On Thu, 4 Sep 2003, Yann Dirson wrote:

> On Thu, Sep 04, 2003 at 09:04:26AM +0800, Grzegorz Jakacki wrote:
> > Thanks for your contribution, I reviewed it shortly below. Will you have
> > time to commit those changes to CVS on SF?
>
> I can find the time :)

Great. You have been added to the project.

> > > - a test for an allocation, which I inserted some time ago when
> > > investigating a problem (dont remember the details)
> >
> > Is this necessary? Standard mandates exception when 'new' cannot allocate
> > memory, so on conforming compiler the execution should never make it to
> > the test.
>
> OK, I can drop it.
>
> > > -<DT><TT><B>opencxx.a</B></TT>
> > > +<DT><TT><B>/usr/lib/libopenc++.a</B></TT>
> >
> > (1) I am under impression that library names is 'libocc.a'
>
> Right, fixed.
>
> > (2) The library is not necessarily intalled in /usr/lib
>
> Right as well.  To be correct the doc should be generated from an .in
> file by configure, who can then substitute the path matching the local
> installation.  I can arrange to do that if there are no objections.
> Gasp, I always hated file renamings in CVS...

I am afraid this may cause confusion to the users, because some of them
reading the (installed version of) documentation may not notice, that the
library path can vary. My personal opinion is that it is much safer to
just say '$libdir/libocc.a' in docs, as it clearly indicates that the path
may vary, also giving a hint on what the path depends (the name "libdir"
occures verbatim in './configure --help'). Thous I would discourage you
from moving the docs to .in files etc. However, if you have some time to
donate to documentation cleanup, then there is a long outstanding project
of integrating documentation with code, so that it can be generated with
Doxygen and/or Synopsis (which I hope would contribute to better
maintenance of documentation). Also there are coding tasks (both in core
and infrastructure) if you would like to get involved.

Best regards
Grzegorz

PS: Haven't we met at BLUG meeting?

> Regards,
> --
> Yann Dirson    <yd...@al...> |    Why make M$-Bill richer & richer ?
> Debian-related: <di...@de...> |   Support Debian GNU/Linux:
> Pro:    <yan...@fr...> |  Freedom, Power, Stability, Gratuity
>      http://ydirson.free.fr/        | Check <http://www.debian.org/>
>
>

##################################################################
# Grzegorz Jakacki                       Huada Electronic Design #
# Senior Engineer, CAD Dept.              1 Gaojiayuan, Chaoyang #
# tel. +86-10-64365577 x2074               Beijing 100015, China #
# Copyright (C) 2002 Grzegorz Jakacki, HED. All Rights Reserved. #
##################################################################