Re: [DOCS] Re: [HACKERS] vacuum problem - Mailing list pgsql-hackers

From Bruce Momjian
Subject Re: [DOCS] Re: [HACKERS] vacuum problem
Date
Msg-id 199808300010.UAA16092@candle.pha.pa.us
Whole thread Raw
In response to Re: [DOCS] Re: [HACKERS] vacuum problem  ("Thomas G. Lockhart" <lockhart@alumni.caltech.edu>)
List 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@candle.pha.pa.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)

pgsql-hackers by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: [HACKERS] Core dump in regression tests.
Next
From: Bruce Momjian
Date:
Subject: Release 6.4