Re: libstdc++-v3 2.90.9

[Phil Edwards <pedwards at disaster dot jaj dot com>]

[cc'ing Gerald]


On Mon, Nov 13, 2000 at 11:24:27AM -0800, Benjamin Kosnik wrote:
> 
> > - With the docs/webpages being moved to gcc.gnu.org, I'm thinking 
> >   +  a mostly empty docs dir in CVS, containing
> >   +  a pointer to the real pages, with the exception that
> >   +  snapshots/releases should include the current wwwdocs/libtdc++ as
> >      the docs subdir
> 
> Yeah. What's happening with the docs webpages? Can you fill me in on the 
> current plan, and the current status?

The highly-mutable plan so far is:

    1)  Copy the docs repository into the wwwdocs repository, thus
        preserving history.
    2)  Do not create any links into the new htdocs/libstdc++/ tree
        until everything works.
    3)  Change structure of new libstdc++ docs as necessary to work with
        the wwwdocs preprocessing.

Gerald and I are on step 3 now.  Mutability goes up at this point;
I'm thinking

    4)  Remove the contents of the docs dir, replace with a pointer
        to the new pages.  Explain that there will be docs there only
        in snapshots and releases.
    5)  Start a new ChangeLog in wwwdocs/htdocs/libstdc++ to keep track
        (it still is official documentation, after all).

I'm not entirely thrilled with (4), since it would mean that users checking
out CVS won't get the local copies of the build instructions.  They'd still
be on the web, but that's an extra step, and much slower besides.  Hmm.

We tried to think up some way of getting help from CVS modules, like having
"libstdc++-v3" actually check out the real sources *and* the web pages,
and silently do a merge on the local user's end.  That ain't gonna happen;
the directory trees are too far apart for the modules trick to work, and
we can't have the CVS client execute arbitrary shell commands to mv stuff
around (for good reason).

Getting CVS to automatically copy things from the wwwdocs repo area into
the sources repo area upon a checkin might be possible, but sounds really
hideous and I don't think we want to go there.

Anything I've forgotten?


-- 
pedwards at disaster dot jaj dot com  |  pme at sources dot redhat dot com
devphil at several other less interesting addresses in various dot domains
The gods do not protect fools.  Fools are protected by more capable fools.