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:references:to:reply-to:from:message-id
	:date:mime-version:in-reply-to:content-type; q=dns; s=default; b=
	RZfwqtjQ6nLWpYkYk6/FGlxPtdPoTxOP7Xk6zihv5szf/8fQ4pS4O4ADmE+3qAJU
	8ABrWuEN61G870Q6ImkYfHA5q7TRcJ6JTywKkg4/B6ESt77WgD9nMwqXZvTNVskf
	FvnLu+XV/d8h1E9RVsLbf7JgGcr2Zsj7Dpwke2VoGao=
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Subject: Re: cygwin-doc html/ missing docbook.css and index dups cygwin-{api,ug-net}
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> <0cb50b7b-1fc8-0af0-973a-205356825076 AT dronecode DOT org DOT uk>
To: cygwin AT cygwin DOT com
Reply-To: Brian DOT Inglis AT SystematicSw DOT ab DOT ca
From: Brian Inglis <Brian DOT Inglis AT SystematicSw DOT ab DOT ca>
Message-ID: <dab8f805-5790-839f-25df-4b0574dd3ec8@SystematicSw.ab.ca>
Date: Thu, 20 Apr 2017 21:00:14 -0600
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: <0cb50b7b-1fc8-0af0-973a-205356825076@dronecode.org.uk>
Content-Type: multipart/mixed; boundary="------------D42D91B991EC1CACF4C8E1AF"

--------------D42D91B991EC1CACF4C8E1AF
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit

On 2017-04-19 15:47, Jon Turney wrote:
> 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?

Darn - hoped you wouldn't ask - attached, and preremove (if not filtered).
Both tested on W10 without, and with CYGWINFORALL=-A and elevated/admin rights.
Comments or improvements you could suggest, or changes you need made?

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

Thanks Jon - makes things more straightforward.

-- 
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada

--------------D42D91B991EC1CACF4C8E1AF
Content-Type: text/plain; charset=UTF-8;
 name="etc.preremove.cygwin-doc.sh"
Content-Transfer-Encoding: base64
Content-Disposition: attachment;
 filename="etc.preremove.cygwin-doc.sh"

IyEvYmluL2Jhc2gKIyAvZXRjL3ByZXJlbW92ZS9jeWd3aW4tZG9jLnNoIC0g
Y3lnd2luLWRvYyBwcmVyZW1vdmUgc2NyaXB0LgojIHJlbW92ZXMgQ3lnd2lu
IFN0YXJ0IE1lbnUgc2hvcnRjdXRzIGZvciBDeWd3aW4gVXNlciBHdWlkZSBh
bmQgQVBJIFBERiBhbmQKIyBIVE1MLCBhbmQgbGlua3MgdG8gQ3lnd2luIHdl
YiBzaXRlIGhvbWUgcGFnZSBhbmQgRkFRCiMKIyBDWUdXSU5GT1JBTEw9LUEg
aWYgcmVtb3ZlIGZvciBBbGwgVXNlcnMKIyByZW1vdmUgbG9jYWwgc2hvcnRj
dXRzIGZvciBBbGwgVXNlcnMgb3IgQ3VycmVudCBVc2VyIGluCiMge1Byb2dy
YW1EYXRhLH4vQXBwZGF0YS9Sb2FtaW5nfS9NaWNyb3NvZnQvV2luZG93cy9T
dGFydCBNZW51L1Byb2dyYW1zL0N5Z3dpbi8KCmNkICIkKC9iaW4vY3lncGF0
aCAkQ1lHV0lORk9SQUxMIC1QIC1VKS9DeWd3aW4iCXx8IGV4aXQgMgoKL2Jp
bi9ybSAtZiAtLSAiVXNlciBHdWlkZSAoUERGKS5sbmsiICJVc2VyIEd1aWRl
IChIVE1MKS5sbmsiIFwKCSJBUEkgKFBERikubG5rIiAiQVBJIChIVE1MKS5s
bmsiICJIb21lIFBhZ2UubG5rIiAiRkFRLmxuayIKCg==

--------------D42D91B991EC1CACF4C8E1AF
Content-Type: text/plain; charset=UTF-8;
 name="etc.postinstall.cygwin-doc.sh"
Content-Transfer-Encoding: base64
Content-Disposition: attachment;
 filename="etc.postinstall.cygwin-doc.sh"

IyEvYmluL2Jhc2gKIyAvZXRjL3Bvc3RpbnN0YWxsL2N5Z3dpbi1kb2Muc2gg
LSBjeWd3aW4tZG9jIHBvc3RpbnN0YWxsIHNjcmlwdC4KIyBpbnN0YWxscyBD
eWd3aW4gU3RhcnQgTWVudSBzaG9ydGN1dHMgZm9yIEN5Z3dpbiBVc2VyIEd1
aWRlIGFuZCBBUEkgUERGIGFuZAojIEhUTUwgaWYgaW4gZG9jIGRpciwgYW5k
IGxpbmtzIHRvIEN5Z3dpbiB3ZWIgc2l0ZSBob21lIHBhZ2UgYW5kIEZBUQoj
CiMgQXNzdW1lcyB5b3UgYXJlIHJ1bm5pbmcgc2V0dXAuZXhlIDIuNTEwLjIu
MiBvciBuZXdlciwgZXhlY3V0ZWQgYnkgL2Jpbi9iYXNoIAojIGFuZCBub3Qg
L2Jpbi9bZGFdc2ggKGlmIHlvdSBhcmUgcnVubmluZyBhbiBvbGRlciBzZXR1
cC5leGUsIHRoaXMgcG9zdGluc3RhbGwgCiMgc2NyaXB0IGNhbid0IGRvIGFu
eXRoaW5nKS4KIwojIENZR1dJTkZPUkFMTD0tQSBpZiBpbnN0YWxsIGZvciBB
bGwgVXNlcnMKIyBpbnN0YWxscyBsb2NhbCBzaG9ydGN1dHMgZm9yIEFsbCBV
c2VycyBvciBDdXJyZW50IFVzZXIgaW4KIyB7UHJvZ3JhbURhdGEsfi9BcHBk
YXRhL1JvYW1pbmd9L01pY3Jvc29mdC9XaW5kb3dzL1N0YXJ0IE1lbnUvUHJv
Z3JhbXMvQ3lnd2luLwoKY3lncD0vYmluL2N5Z3BhdGgKbWtzPS9iaW4vbWtz
aG9ydGN1dAp1bj0vYmluL3VuYW1lCnNpdGU9aHR0cHM6Ly9jeWd3aW4uY29t
CgojIGNoZWNrIGZvciBwcm9ncmFtcwpmb3IgcCBpbiAkdW4gJGN5Z3AgJG1r
cwpkbwoJaWYgWyAhIC14ICRwIF0KCXRoZW4KCQllY2hvICJDYW4ndCBmaW5k
IHByb2dyYW0gJyRwJyIKCQlleGl0IDIKCWZpCmRvbmUKCmN5Z3Zlcj0kKCR1
biAtcikJIyByZWxlYXNlIC0gbnVtZXJpYyB2ZXJzaW9uIChidWlsZCBpbmZv
KQpjeWd2ZXI9JHtjeWd2ZXIlXCgqXCl9CSMgc3RyaXAgYnVpbGQgaW5mbwpk
b2M9L3Vzci9zaGFyZS9kb2MvY3lnd2luLSRjeWd2ZXIKaHRtbD0kZG9jL2h0
bWwKc21wY19kaXI9IiQoJGN5Z3AgJENZR1dJTkZPUkFMTCAtUCAtVSkvQ3ln
d2luIgoKZm9yIGQgaW4gJGRvYyAkaHRtbCAiJHNtcGNfZGlyIgpkbwoJaWYg
WyAhIC1kICIkZC8iIF0KCXRoZW4KCQllY2hvICJDYW4ndCBmaW5kIGRpcmVj
dG9yeSAnJGQnIgoJCWV4aXQgMgoJZmkKZG9uZQoKaWYgWyAhIC13ICIkc21w
Y19kaXIvIiBdCnRoZW4KCWVjaG8gIkNhbid0IHdyaXRlIHRvIGRpcmVjdG9y
eSAnJHNtcGNfZGlyJyIKCWV4aXQgMQpmaQoKIyBta3Nob3J0Y3V0IHdvcmtz
IG9ubHkgaW4gY3VycmVudCBkaXJlY3RvcnkgLSBjaGFuZ2UgdG8gQ3lnd2lu
IFN0YXJ0IE1lbnUKY2QgIiRzbXBjX2RpciIgfHwgZXhpdCAyCSMgcXVpdCBp
ZiBub3QgZm91bmQKCiMgVXNlciBHdWlkZSBQREYgJiBIVE1MCnA9JGRvYy9j
eWd3aW4tdWctbmV0LnBkZgpuPSJVc2VyIEd1aWRlIChQREYpIgpkPSJQREYg
Q3lnd2luIFVzZXIgR3VpZGUiCgpbIC1yICRwIF0gJiYgJG1rcyAtbiAiJG4i
IC1kICIkZCIgJHAgCgppPSRodG1sL2N5Z3dpbi11Zy1uZXQvaW5kZXguaHRt
bApuPSJVc2VyIEd1aWRlIChIVE1MKSIKZD0iSFRNTCBDeWd3aW4gVXNlciBH
dWlkZSIKClsgLXIgJGkgXSAmJiAkbWtzIC1uICIkbiIgLWQgIiRkIiAkaSAK
CiMgQVBJIFBERiAmIEhUTUwKcD0kZG9jL2N5Z3dpbi1hcGkucGRmCm49IkFQ
SSAoUERGKSIKZD0iUERGIEN5Z3dpbiBBUEkgUmVmZXJlbmNlIgoKWyAtciAk
cCBdICYmICRta3MgLW4gIiRuIiAtZCAiJGQiICRwIAoKaT0kaHRtbC9jeWd3
aW4tYXBpL2luZGV4Lmh0bWwKbj0iQVBJIChIVE1MKSIKZD0iSFRNTCBDeWd3
aW4gQVBJIFJlZmVyZW5jZSIKClsgLXIgJGkgXSAmJiAkbWtzIC1uICIkbiIg
LWQgIiRkIiAkaSAKCiMgSG9tZSBQYWdlIFVSTApoPSRzaXRlL2luZGV4Lmh0
bWwKbj0iSG9tZSBQYWdlIgpkPSJDeWd3aW4gJG4iCgokbWtzIC1uICIkbiIg
LWQgIiRkIiAkaCAKCiMgRkFRIFVSTApoPSRzaXRlL2ZhcS5odG1sCm49IkZB
USIKZD0iQ3lnd2luIEZyZXF1ZW50bHkgQXNrZWQgUXVlc3Rpb25zICh3aXRo
IGFuc3dlcnMpIgoKJG1rcyAtbiAiJG4iIC1kICIkZCIgJGggCgo=


--------------D42D91B991EC1CACF4C8E1AF
Content-Type: text/plain; charset=us-ascii


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