Ghc Api conversion guide?

[Claus Reinke]

Hi Thomas,

Is there a document describing what people have to do
to convert their Ghc Api client code to the new Api?

The project page

    http://hackage.haskell.org/trac/ghc/wiki/GhcApiStatus

is already out of date (at least, I couldn't find a withGhc)
and the modifications have of course invalidated any and
all Ghc Api documentation examples and client code out 
there (the related docs section links to some of them, at
least Haskell wiki and Ghc commentary should be checked
and updated?).

Since you have some recent experience with the conversion,
and the new Api is part of the upcoming Ghc release, it would 
be a good time to write it all down, so that users of the new 
release won't be left in the dark (*). This might also help to flush 
out any residual issues (eg, runGhc; why are the flag strings
for parseDynamicFlags suddenly 'Located String's, should
there be a 'dynamicFlagLoc' to match? are all necessary utils 
re-exported from GHC.hs, such as Located, or liftIO?).

Claus

(*) use the source, Luke!-)