pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Richard Huxton <dev@archonet.com>
To: pgsql-docs@postgresql.org
Subject: RFC - Admin manual index (draft)
Date: Tue, 17 Apr 2001 19:39:32 -0000
Message-ID: <20010417193932.20F082A3A7@mainbox.archonet.com> (raw)

Well, here's my first stab at indexing the admin manual. Sorry about the
delay, but it was one part lack of round tuits and two parts half-wittery on
my part.

http://www.archonet.com/pgadmin/

I've tried to concentrate on getting environment variables, config settings
etc indexed since I figure people will run a text-search on the index page to
find a specific thing.

I still need to go through and refactor the whole thing and also figure out
how the "see xxx" bit works.

It's based on CVS of a week or so ago, so I'll need to update it to match
current. Was having problems doing a cvs update - seemed to be doing something
but was sending one packet every minute or so - might just be the server was
busy.

Any comments gratefully received. Some notes/thoughts below:

I'm getting 12 index entries ignored and no idea why (didn't notice until I'd
almost finished). Any smart ideas how to figure out which 12 of the 200?

Would it be possible to use entities to add indexterms? Then we could have a
central list of index definitions and just put &idx-backup-pgdump; in the
actual document. Might help to keep the index structured.

Some of the links in the index have very good names, some less good. I'm
guessing these are taken from the id attributes. Any problems with renaming a
few of these presuming I grepped for references to the original id's?

If this gets accepted for inclusion, I take it I need to do a make clean then
a cvs diff?

PS - congrats to any/all involved in the release of 7.1 - nice work.

- Richard Huxton



view thread (2+ messages)  latest in thread

Message-ID: <20010417193932.20F082A3A7@mainbox.archonet.com>
Permalink:  ../20010417193932.20F082A3A7@mainbox.archonet.com/
Also on:    postgresql.org/message-id/20010417193932.20F082A3A7@mainbox.archonet.com

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: dev@archonet.com
  Subject: Re: RFC - Admin manual index (draft)
  In-Reply-To: <20010417193932.20F082A3A7@mainbox.archonet.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox