Re: [Qemu-devel] [PATCH V2 06/10] docs: add qemu-clock documentation

[Peter Maydell]

On 7 February 2017 at 17:15, Frederic Konrad <address@hidden> wrote:
> On 02/07/2017 05:13 PM, Peter Maydell wrote:
>> On 26 January 2017 at 09:47,  <address@hidden> wrote:
>>> From: KONRAD Frederic <address@hidden>
>>>
>>> This adds the qemu-clock documentation.
>>>
>>> Signed-off-by: KONRAD Frederic <address@hidden>
>>>
>>> V1 -> V2:
>>>   * Fixed in accordance with the changes in the previous patches.
>>> ---
>>>  docs/clock.txt | 108 
>>> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>>>  1 file changed, 108 insertions(+)
>>>  create mode 100644 docs/clock.txt
>>
>> Could we have a simple example of what you need to do if you are:
>>  * a device providing a clock source of some kind
>
> The fixed clock in patch 7 might be helpful for that.
> Maybe I can just point to it in the documentation?
>
>>  * a device that takes a clock input and has one or more
>>    clock outputs which are configured by that device (for
>>    frequency, on/off, etc)
>>  * a device that consumes a clock
>
> The CRF is doing that. Maybe I can add a simpler testcase device to
> build a make check for that?

I don't really want a whole test case device (which is a lot
of extra boilerplate and detail obscuring the necessities),
I'd just like a sketch of what these devices need to do in
the documentation.

thanks
-- PMM