Re: [PATCH 2/3] docs/s390x: document 3270

[Thomas Huth <thuth@redhat.com>]

On 15/05/2020 11.45, Cornelia Huck wrote:
> On Fri, 15 May 2020 11:14:40 +0200
> Thomas Huth <thuth@redhat.com> wrote:
> 
>> On 15/05/2020 11.00, Cornelia Huck wrote:
>>> On Fri, 15 May 2020 09:29:42 +0200
>>> Thomas Huth <thuth@redhat.com> wrote:
>>>   
>>>> On 05/05/2020 15.50, Cornelia Huck wrote:  
>>>>> Add some basic info how to use 3270 devices.
>>>>>
>>>>> Signed-off-by: Cornelia Huck <cohuck@redhat.com>
>>>>> ---
>>>>>  docs/system/s390x/3270.rst   | 32 ++++++++++++++++++++++++++++++++
>>>>>  docs/system/target-s390x.rst |  1 +
>>>>>  2 files changed, 33 insertions(+)
>>>>>  create mode 100644 docs/system/s390x/3270.rst
>>>>>
>>>>> diff --git a/docs/system/s390x/3270.rst b/docs/system/s390x/3270.rst
>>>>> new file mode 100644
>>>>> index 000000000000..e367a457e001
>>>>> --- /dev/null
>>>>> +++ b/docs/system/s390x/3270.rst
>>>>> @@ -0,0 +1,32 @@
>>>>> +3270 devices
>>>>> +============
>>>>> +
>>>>> +With the aid of the ``x3270`` emulator, QEMU provides limited support
>>>>> +for making a single 3270 device available to a guest. Note that this
>>>>> +supports basic features only.    
>>>>
>>>> The first sentence sounds somewhat confusing. Maybe rather something like:
>>>>
>>>> QEMU can emulate a 3270 device attached to a guest, which then can be
>>>> used with a program like ``x3270`` to get a traditional 3270 terminal
>>>> for your guest.  
>>>
>>> But QEMU actually relies on x3270 (or a comparable program). It only
>>> emulates the basic ccw plumbing; for the actual protocol (beyond
>>> negotiating tn3270), it relies on the emulation done by x3270.  
>>
>> Ok, makes sense now. Maybe something like:
>>
>> QEMU provides the possibility to connect an external 3270 terminal
>> emulator (like ``x3270``) to a guest?
> 
> Hm...
> 
> "QEMU supports connecting an external 3270 terminal emulator (such as
> ``x3270``) to make a single 3270 device available to a guest. Note that
> this supports basic features only."
> 
> ?

Yes, that sounds good!

 Thanks,
  Thomas