X-Recipient: archive-cygwin AT delorie DOT com
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=
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; 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; s=default; bh=vmMlc0qa8TOaeEhnDM3Ja/
	OGKbU=; b=scvKcp3XQulfG4p6EtaZtA438e6fP10hAE+smIDAexUrvy57x4gn0l
	fm1rigImu2kkIMSDgMoVBuQtZqXfUmtaeyl5ycq6/pdALuLHJw8+PtHX9PShai6/
	PP6DnT89w3WAkfxAn4XGtBkuVerCHzcwHRasaSgttMIrvfmhsUcNs=
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com
Authentication-Results: sourceware.org; auth=none
X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=AWL,BAYES_00,FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_PASS autolearn=ham version=3.3.2 spammy=struggle, dwell, prevented
X-HELO: mail-it0-f41.google.com
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;        d=gmail.com; s=20161025;        h=subject:to:references:from:openpgp:message-id:date:user-agent         :mime-version:in-reply-to:content-language:content-transfer-encoding;        bh=+ZWZFoyntFm2ujtX+lN+/WxTklhLnrHtHCFUsX33qCo=;        b=Utw2myMC74/Sk+x4S+s3jsU/efSXtoPUhBVczCnXKUoygRJXEoW+dEBd2wXnLD7m1X         Tc4VjirVVoRkCGtMuv7wemXTiwOGZ3Qxg1Df6RwTbPe41g5ZE64Pp+O1OolmPdUO0b63         xG+DutRvPLlbU7O9OH+/+DtfEeG8k+nLfJgmAnj7mSrOeYYuyaRU4D+Uej7tavtnl/Oz         8zX/Q3WBEvcvoeEBPWDyVUl868VUSmgYwQ0gzjFlX6K14FFMr83uMYm2/c80a3M3jPhh         xluDJMvqX71QSZn4TN4A2Y0lWTn5kfhRRtY6iv2fIM+5OW135nMIQlU87vdC+tawryRx         ZwaA==
Subject: Re: Documentation for cygwin-console-helper.exe
To: cygwin AT cygwin DOT com
References: <1b1fd757-dd11-72a7-cc2c-7280d89a0500 AT gmail DOT com> <20180813075342 DOT GG3747 AT calimero DOT vinschen DOT de> <165ec576-622d-a33a-9e38-722afc834af3 AT gmail DOT com> <20180813144529 DOT GN3747 AT calimero DOT vinschen DOT de>
From: cyg Simple <cygsimple AT gmail DOT 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
X-IsSubscribed: yes

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