[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: document cygwin-convert-path-{from,to}-windows?

From: Daniel Colascione
Subject: Re: document cygwin-convert-path-{from,to}-windows?
Date: Sun, 18 Nov 2012 18:45:24 -0800
User-agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:16.0) Gecko/20121026 Thunderbird/16.0.2

On 11/18/2012 6:37 PM, Stefan Monnier wrote:
>>>>> I do have a gripe wrt their names: GNU coding standards frown upon
>>>>> using "path" for anything but PATH-style lists of directories.  But my
>>>>> comments about that at the time evidently weren't enough to convince
>>>>> the guilty parties.
>>>> It's not too late to change the names. What would you suggest?
>>> cygwin-convert-filename-to-windows, and similarly for the other one.
>>> IOW, replace "path" with "filename".
>> But the functions convert directory names too.
> You clearly need to (re-)read the GNU coding standards.

The GNU Coding Standards are silent on the topic except for the following
sentence in section 6.1:

"Please do not use the term “pathname” that is used in Unix documentation; use
“file name” (two words) instead. We use the term “path” only for search paths,
which are lists of directory names."

The document could be clearer on what to call names that can refer to either
files or directories. (FWIW, I find "path" the least confusing option, and I
find names like "directory-file-name" confusing.)

Attachment: signature.asc
Description: OpenPGP digital signature

reply via email to

[Prev in Thread] Current Thread [Next in Thread]