Documentation on PITR still scarce

Hi there,

I just wanted to try the PITR feature in beta and got it working somehow.
However I think the docs on this point are still not sufficient enough.

We have to assume that people will have a closer look at the backup/recovery
documentation as soon as 8.0 ships, because we're kinda heavily advertizing
for 8.0 with the PITR feature.

In chapter 22, "Backup and Restore", there is not a single example of a
recovery.conf, nor is any of these parameters even mentioned:

recovery_target_time
recovery_target_xid
recovery_target_timeline
recovery_target_inclusive

There's an example file in the source tree in backend/access/transam
however.

So from looking at the docs only it's quite difficult to figure out how it
works in practice. I'd appreciate an example with multiple timelines as
well.


Joachim