Re: [PATCH 1/2] cmd: Improve WCMD_fgets documentation

2011-10-01 Thread Frédéric Delanoy
2011/10/1 Dan Kegel :
> + * We can't use the native f* functions because of the filename
> syntax differences
> + * between DOS and Unix.
>
> That doesn't belong in a function comment; it's
> an implementation detail that belongs, at most,
> inside the function.

Yeah true. I simply copied it over from previous doc.
Might move it/delete part of it




re: [PATCH 1/2] cmd: Improve WCMD_fgets documentation

2011-09-30 Thread Dan Kegel
+ * We can't use the native f* functions because of the filename
syntax differences
+ * between DOS and Unix.

That doesn't belong in a function comment; it's
an implementation detail that belongs, at most,
inside the function.