Re: [Qemu-devel] [PATCH] Documentation: Update chapter on installation

[Stefan Weil <weil@mail.berlios.de>]

Aurelien Jarno schrieb:
> On Sat, Apr 10, 2010 at 09:56:00AM +0200, Stefan Weil wrote:
>> Aurelien Jarno schrieb:
>>> On Sat, Apr 10, 2010 at 09:21:54AM +0200, Stefan Weil wrote:
>>>> Aurelien Jarno schrieb:
>>>>> On Sun, Mar 28, 2010 at 11:50:19AM +0200, Stefan Weil wrote:
>>>>>
>>>>>> * Replace broken links by link to QEMU wiki.
>>>>>>
>>>>>> * Separate sections for Linux / Windows / Mac OS X
>>>>>> are no longer needed: the wiki link will provide
>>>>>> additional links, so we don't need them here.
>>>>>>
>>>>>> * Add hint for (Open) Solaris.
>>>>>>
>>>>> Whats the reason for the change disk_image -> disk image?
>>>>>
>>>> It_simply_looks_better. The reversed question is more interesting:
>>>> why was it called disk_image?
>>>>
>>> To be consistent with all the other links?
>> I think that earlier versions of texinfo did not support
>> links which contain spaces.
>>
>> Those underscores look bad when a link is not only used
>> in link lists but also in plain text: would you prefer to create
>> a disk_image or a disk image?
>>
>
> That's an argument, but I still don't see the point of changing only one
> link and leave the others with an underscore, moreover in an unrelated
> patch and without writing anything about that in the description.
>

This new part of the documentation was the reason for this change:

+QEMU @ref{disk images} for several guest operating systems are also
available
+from the FreeOsZoo project (@url{http://www.oszoo.org/}).

In a first version, it looked like "QEMU disk_images for several",
and I wanted to improve that. I thought this was obvious, so I did
not mention it in the change description.

If link address and texual representation were separate in texinfo
(like they are in html), there would be no need to change the link.
Alas, I don't know whether texinfo supports this kind of separation.