This patchset converts docs/barrier.txt to rST, putting
it in the appropriate places:
 * the protocol info lives in interop/
 * the "how to use this" info lives in system/
 * TODO remarks live in the .c file :-)

thanks
-- PMM

Peter Maydell (3):
  docs: Move the protocol part of barrier.txt into interop
  ui/input-barrier: Move TODOs from barrier.txt to a comment
  docs: Move user-facing barrier docs into system manual

 docs/barrier.txt         | 370 ----------------------------------
 docs/interop/barrier.rst | 426 +++++++++++++++++++++++++++++++++++++++
 docs/interop/index.rst   |   1 +
 docs/system/barrier.rst  |  44 ++++
 docs/system/index.rst    |   1 +
 ui/input-barrier.c       |   5 +
 6 files changed, 477 insertions(+), 370 deletions(-)
 delete mode 100644 docs/barrier.txt
 create mode 100644 docs/interop/barrier.rst
 create mode 100644 docs/system/barrier.rst

-- 
2.20.1

On 27/07/21 22:41, Peter Maydell wrote:
> This patchset converts docs/barrier.txt to rST, putting
> it in the appropriate places:
>   * the protocol info lives in interop/
>   * the "how to use this" info lives in system/
>   * TODO remarks live in the .c file :-)
> 
> thanks
> -- PMM
> 
> Peter Maydell (3):
>    docs: Move the protocol part of barrier.txt into interop
>    ui/input-barrier: Move TODOs from barrier.txt to a comment
>    docs: Move user-facing barrier docs into system manual
> 
>   docs/barrier.txt         | 370 ----------------------------------
>   docs/interop/barrier.rst | 426 +++++++++++++++++++++++++++++++++++++++
>   docs/interop/index.rst   |   1 +
>   docs/system/barrier.rst  |  44 ++++
>   docs/system/index.rst    |   1 +
>   ui/input-barrier.c       |   5 +
>   6 files changed, 477 insertions(+), 370 deletions(-)
>   delete mode 100644 docs/barrier.txt
>   create mode 100644 docs/interop/barrier.rst
>   create mode 100644 docs/system/barrier.rst
> 

Apart from the two typos in patch 3,

Reviewed-by: Paolo Bonzini <pbonzini@redhat.com>

Paolo