Re: [DOCS] Re: [HACKERS] vacuum problem

From: Bruce Momjian <maillist(at)candle(dot)pha(dot)pa(dot)us>
To: lockhart(at)alumni(dot)caltech(dot)edu (Thomas G(dot) Lockhart)
Cc: tih(at)nhh(dot)no, pgsql-hackers(at)postgresql(dot)org, docs(at)postgresql(dot)org
Subject: Re: [DOCS] Re: [HACKERS] vacuum problem
Date: 1998-08-30 00:10:41
Message-ID: 199808300010.UAA16092@candle.pha.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

> > OK, I see it. Looks like I am going to have to learn sgml. I have no
> > way of viewing it, so I will have to do my best, and you can tell me
> > how it looks. Is there an sgml->something conversion tool I can use
> > for testing?
>
> Well, you are allowed to not learn sgml. As you can see from the current
> release.sgml file, there are a _very_ few tags used to mark up your
> previous release notes. And you can choose to ignore those.
>
> For example, in previous releases you have built a "one-line-per" list
> of changes. Those I have laid into the release notes without
> modification, just bracketing them with a "<programlisting>" tag to have
> them come through unchanged.
>
> The written introduction you did for the last big release was put into
> sgml as a section (probably a "<sect2>" tag) and then the paragraphs
> were just started with the "<para>" tag.
>
> And again, I'm happy to mark them up from your usual plain-text file.
>
> Another option, if you don't want or need to try sgml in the privacy of
> your own home :) is to use the installation on hub.org. It works, and a
> cvs checkout of the tree (which you have already done), a "configure",
> and then a "doc/src/sgml/make postgres.html" is sufficient to build the
> full html docs. I've left out one or two one-time trivial setup steps,
> but I wanted to give you an idea of how easy it can be.
>
> What I'd like to do is tie the cvs tree to an automatic update of the
> pages on the web site, which would let you check things in and then see
> a doc rebuild soon after. Been thinking about it, but haven't done it
> yet :(

Thomas, as I remember, the HISTORY file is constantly changing up until
the final days. PLease let me know when you are ready to cut the docs,
and I will make sure the HISTORY file is up-to-date, and you can load it
into sgml.

--
Bruce Momjian | 830 Blythe Avenue
maillist(at)candle(dot)pha(dot)pa(dot)us | Drexel Hill, Pennsylvania 19026
+ If your life is a hard drive, | (610) 353-9879(w)
+ Christ can be your backup. | (610) 853-3000(h)

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 1998-08-30 00:15:54 Documentation updates for 6.4
Previous Message Bruce Momjian 1998-08-30 00:08:01 Re: [HACKERS] Core dump in regression tests.