[PATCH 2/5] winsup/doc: Add intro man pages from cygwin-doc

[Jon TURNEY]

On 22/06/2015 16:14, Corinna Vinschen wrote:
> A few nits:

Thanks for the detailed review.

>> +      <para>Keep in mind that there are many underlying differences between UNIX
>> +      and Win32 (for example, a case-insensitive file system), making complete
>> +      compatibility an ongoing challenge.</para>
>
> Is "case-insensitive file system" a good example?  For one thing, NTFS
> is a case-sensitive filesystem, and only the Win32 API and the default
> NT kernel setting in the registry enforces case-insensitivity.  See
> https://cygwin.com/cygwin-ug-net/using-specialnames.html#pathnames-casesensitive
>
> What about the OS consequently using UTF-16 as an example?

I don't know if it actually helps to give a specific example here. The 
meaning is plain enough without one.

>> +    <refsect1>
>> +      <title>SEE ALSO</title>
>> +      <para>
>> +	<citerefentry>
>> +	  <refentrytitle>intro</refentrytitle>
>> +	  <manvolnum>1</manvolnum>
>
> Shouldn't that be a 3 here?

I don't think so.  This is a cross-reference to intro.1 in the SEE ALSO 
section of intro.3