DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id
	:list-unsubscribe:list-subscribe:list-archive:list-post
	:list-help:sender:subject:to:references:from:message-id:date
	:mime-version:in-reply-to:content-type
	:content-transfer-encoding; q=dns; s=default; b=bGKVxEYTupBi2x+4
	FC6nHr7Y0Qvz7/s+u3Y10mxveVl3qdnv7/6M2hoTyx+VFe5p/XCx25S5gSSYwyGX
	MK+1RZ1DpAWRu/9ALR6uLZgjPM9jBr+FjVKKy0t9xVDpVtb6heI9eeXeewrfo/TQ
	q7UsxoOu4YjvTsnqTszfsGToe+c=
Mailing-List: contact cygwin-help@cygwin.com; run by ezmlm
Sender: cygwin-owner@cygwin.com
Mail-Followup-To: cygwin@cygwin.com
Subject: Re: Documentation for cygwin-console-helper.exe
To: cygwin@cygwin.com
References: <1b1fd757-dd11-72a7-cc2c-7280d89a0500@gmail.com> <20180813075342.GG3747@calimero.vinschen.de> <165ec576-622d-a33a-9e38-722afc834af3@gmail.com> <20180813144529.GN3747@calimero.vinschen.de>
From: cyg Simple <cygsimple@gmail.com>
Openpgp: preference=signencrypt
Message-ID: <1adebdf8-d0e7-d74d-c715-0a3ecc88036c@gmail.com>
Date: Tue, 14 Aug 2018 16:19:39 -0400
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1
MIME-Version: 1.0
In-Reply-To: <20180813144529.GN3747@calimero.vinschen.de>
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit

On 8/13/2018 10:45 AM, Corinna Vinschen wrote:
> On Aug 13 08:57, cyg Simple wrote:
>> On 8/13/2018 3:53 AM, Corinna Vinschen wrote:
>>> On Aug 12 19:53, cyg Simple wrote:
>>>> The documentation for cygwin-console-helper.exe is missing, not even a
>>>> --help function.
>>>
>>> cygwin-console-helper.exe is not for the user to use, so why add
>>> user docs?  The documentation is in the source for the interested
>>> dev:
>>>
>>> https://sourceware.org/git/?p=newlib-cygwin.git;a=blob;f=winsup/cygwin/fhandler_console.cc;hb=HEAD#l2521
>>>
>>
>> How the hell am I supposed to find that by looking at
>> cygwin-console-helper.cc?
> 
> You aren't.  

But telling me something in the source code would have probably
prevented me from asking.  I don't think --help is helpful in this case
but words in comments about the reasoning for the executable is and
should always be a requirement.  What happens when those who know move
on to something better; then those that are left behind have to struggle
to find the reasons.

> The cygwin-console-helper solution is under-the-hood stuff,
> a solution for a problem which was supposed to be not user visible.

So perhaps the fact that it is user visible is the problem.  Perhaps it
should move to somewhere like /usr/libexec.

> Because, in this case user visible means it doesn't work as desired.

Well it works, it is a library helper app that hides the console of a
windowed app.  It shouldn't be in the user application space.  As it is,
it is in the open for the user to dwell on what is this app, it does
nothing useful when I run it from the console; I might as well delete
it.  Oh no, now my mintty has a console attached to every window.

-- 
cyg Simple

--
Problem reports:       http://cygwin.com/problems.html
FAQ:                   http://cygwin.com/faq/
Documentation:         http://cygwin.com/docs.html
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple