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=bD4Kj7Nl1qnJ5BFU
	/K2RfEsOz4wKpMvGFg4PGs1dejyo5NNalPqcxfzM/4HWXHygcM867tirlut1baMn
	orgLCVhWrdR12BzP9z0p6QB3yIi5Q4ZLmsyAiXwDqvkB2gD6coJSDrPDAWt4i0uK
	iCcqxgSQtsUty7K8iwone5uTo1k=
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=hQL4SR7dPN8zPNgIca5wJU
	oFm7E=; b=s0qmvRQh1oq5RIhMyeuUGqrZ5v5IX3iEfnCETnFuWw1vO/yJYblb4C
	kE1MCVAhnKBmFNE4QCpwsZ1eVaUhh+WKK5iJBjyB3+qqUBUfrKAOq5Hc0fGmk/t2
	1Xkmz/KZAPrGs7MKcU1Bh6yZHEN7N5Xh2Dl2ywHC2kEWw5cRf1CdQ=
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-Virus-Found: No
X-Spam-SWARE-Status: No, score=-7.5 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_1,RCVD_IN_DNSWL_LOW autolearn=ham version=3.3.2 spammy=Hx-spam-relays-external:ESMTPA
X-HELO: out1-smtp.messagingengine.com
X-ME-Sender: <xms:-dr3WPJFVEf9CUUefe9y_t1Z4ne2gA59KxxYVdiYSvCDaLqMW_vj7Q>
Subject: Re: cygwin-doc html/ missing docbook.css and index dups cygwin-{api,ug-net}
To: The Cygwin Mailing List <cygwin AT cygwin DOT com>
References: <970c5445-007e-1817-3006-973e8e26b77a AT SystematicSw DOT ab DOT ca> <20170419105814 DOT GB19304 AT calimero DOT vinschen DOT de> <4d562b86-271a-9774-efd5-f1d1eecb1b93 AT SystematicSw DOT ab DOT ca>
From: Jon Turney <jon DOT turney AT dronecode DOT org DOT uk>
Message-ID: <0cb50b7b-1fc8-0af0-973a-205356825076@dronecode.org.uk>
Date: Wed, 19 Apr 2017 22:47:31 +0100
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0
MIME-Version: 1.0
In-Reply-To: <4d562b86-271a-9774-efd5-f1d1eecb1b93@SystematicSw.ab.ca>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit

On 19/04/2017 16:42, Brian Inglis wrote:
> On 2017-04-19 04:58, Corinna Vinschen wrote:
>> On Apr 16 12:22, Brian Inglis wrote:
>
>>> Could you please consider having setup-x86{,_64} install Windows
>>> shortcuts to at least the UG .pdf and index.html if present, in
>>> the .../Start Menu/Programs/Cygwin folder?
>>> A Windows URL shortcut to https://cygwin.com would also be helpful
>>> for some.
>> That requires to change setup or to provide a postinstall script.
>> Are you willing to provide the latter?
>
> I am not aware of any arguments passed to postinstall scripts, so a
> /etc/postinstall/cygwin-doc.sh would have to check for the folders
> "$(cygpath -APU)"/Cygwin or "$(cygpath -PU)"/Cygwin, cd there,
> mkshortcut(s), then cd back, as mkshortcut does not support folders,
> as far as I can tell.
> The postinstall script would also have to run elevated as admin to
> make shortcuts in AllUsers/ProgramData, from what I have found.
> An /etc/preremove/cygwin-doc.sh script would also have to be
> provided to remove those shortcuts.
> Any problems with that approach or improvements you could suggest?

This needs documenting, but when running postinstall scripts, Cygwin 
setup sets the CYGWINFORALL env var to "-A" if installing for "All 
Users" [1], for exactly this purpose.

[1] 
https://sourceware.org/git/gitweb.cgi?p=cygwin-setup.git;a=commitdiff;h=c3d07c1372904c915b5895808f2cc6462975901e

--
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