Skip to Content.
Sympa Menu

freetds - RE: [freetds] status: documentation

freetds AT lists.ibiblio.org

Subject: FreeTDS Development Group

List archive

Chronological Thread  
  • From: "ZIGLIO Frediano" <Frediano.Ziglio AT vodafone.com>
  • To: "FreeTDS Development Group" <freetds AT lists.ibiblio.org>
  • Subject: RE: [freetds] status: documentation
  • Date: Tue, 23 Dec 2003 11:16:22 +0100

>
> I've spent the last three days hacking a way to install the
> documentation.
> These are a few of my not favorite tools....
>
> Freddy: the solution I came up with earlier didn't work, because that
> variable doesn't accept a directory. The solution you came
> up with -- the
> $(DOCDIR)/userguide/* target -- didn't work on my machine,
> maybe because I
> use BSD make.
>

Good, so our Makefiles should work with no-GNU make.

> My solution has several parts:
>
> 1. use EXTRA_DIST to include built documentation in the source
> distribution. This has the nice property of accepting directories.
>
> 2. use pkgdata_DATA to trigger "data" installation.
>

You used a mix of pkddata and data, I changed to use just data (still
not in CVS... see below)

> 3. use install-data-local (once again) to move the UG and reference
> manual to $(datadir)/doc/freetds-$(RELEASE).
>
> 4. use $(mkinstalldirs) to create directories, and $(INSTALL_DATA) to
> copy the files.
>
> 5. remove the spurious $(pkgdatadir) created by pkgdata_DATA.
>
> One objective was to let people using ./configure do e.g.:
>
> $ mkdir build; cd build
> $ ../configure
>
> That works. If they have jade and doxygen set up, the
> documentation will
> be built in the build directory and installed therefrom. If
> they don't
> have one or the other, and are working from a normal source
> distribution,
> the build directory will be symlinked to the source directory, and
> installed as if it had been built.
>

Ok

> Along the way, I discovered a bunch of other little problems,
> like things
> that should have been in EXTRA_DIST that weren't.
>

userguide.dsl have to be distributed... This cause userguide/index.htm
depend on userguide.dsl, so userguide get rebuild if userguide.dsl is
not distributed...

> I think Frediano and I are the only fellows building documentation
> regularly. I haven't tested every permutation, and if you
> have problems
> at the tail end of your installation, it might well be because of this
> work. Your install should otherwise be unaffected. Just
> holler and I'll
> try to remedy whatever's broken.
>

I'm going to write a test-dist.sh to reflect our aim to distribution...
(attached, still do not work, userguide get rebuild...)

> There was a complaint recently about errors installing
> documentation. I
> hope to have fixed that.
>

It's good to do a "cvs update" before every "cvs commit" just to make
sure you are working on a recent version, I had to merge some fixes
already in CVS...

freddy77

Attachment: test-dist.sh.gz
Description: test-dist.sh.gz




Archive powered by MHonArc 2.6.24.

Top of Page