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:references:to:from:reply-to:message-id
	:date:mime-version:in-reply-to:content-type
	:content-transfer-encoding; q=dns; s=default; b=uxhWVo37uNE8bJbm
	KfG0tKhP1F8TzAua40FGxbttUrnrTt5hTEjwCCz5BSKKh0IYe53JL0ArGbbspRjw
	uBdDbiT5BirAgNg9by6mSXZL9cZyEpo491CAejsLcSEI9i+Qw4kszBH574dx5IUS
	n/PXVqFtQqJS9KbtUWYcY7/3VwY=
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:references:to:from:reply-to:message-id
	:date:mime-version:in-reply-to:content-type
	:content-transfer-encoding; s=default; bh=34bwTsho3X7qszu8XIaCk1
	ImIIE=; b=WPRf2oI1ie/KnGxqa9gEyqSU+YlTjoRN+N2FqXxwwZ+V4D7aU+s033
	xYMpDTVyRjxJmKHr1pi28ebaEO2jkjFDsuQB/N8J2krIkHCBbPaIOU0rzlUkFUDv
	VSWJ6tuGyWULvCeojtCphonaz6Pk04MVjHf+lGlzj+vjyWFHs6vaQ=
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=-5.9 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_1,KAM_LAZY_DOMAIN_SECURITY,RCVD_IN_DNSWL_LOW autolearn=ham version=3.3.2 spammy=H*R:D*ca, Hx-spam-relays-external:!192.168.1.100!, H*RU:!192.168.1.100!, H*r:ip*192.168.1.100
X-HELO: smtp-out-so.shaw.ca
X-Authority-Analysis: v=2.2 cv=B8rJ6KlM c=1 sm=1 tr=0 a=WqCeCkldcEjBO3QZneQsCg==:117 a=WqCeCkldcEjBO3QZneQsCg==:17 a=IkcTkHD0fZMA:10 a=w_pzkKWiAAAA:8 a=wn2tWnfOKRrLvmu7J_sA:9 a=QEXdDO2ut3YA:10 a=sRI3_1zDfAgwuvI8zelB:22
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>
To: cygwin AT cygwin DOT com
From: Brian Inglis <Brian DOT Inglis AT SystematicSw DOT ab DOT ca>
Reply-To: Brian DOT Inglis AT SystematicSw DOT ab DOT ca
Message-ID: <4d562b86-271a-9774-efd5-f1d1eecb1b93@SystematicSw.ab.ca>
Date: Wed, 19 Apr 2017 09:42:11 -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: <20170419105814.GB19304@calimero.vinschen.de>
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
X-CMAE-Envelope: MS4wfMSXCS9umAVRzlBHF+0Lka4ZCdjy6emGqbITt/CCVqV8/h/MpJUweUvBaD6wbqwKNsBc8Q90gyzxDqiD0vs4/Y1Zmo60QLWo9K6CXrWzO7cRUfKlnkIU Wckzf35ZzXh+S+19c2JqM/eRoKhwCCgWVJ/C4jbE5A27vFzAKNtFHHDmM20kyIOqe1pT551fZC14lQ==
X-IsSubscribed: yes

On 2017-04-19 04:58, Corinna Vinschen wrote:
> On Apr 16 12:22, Brian Inglis wrote:
>> Package cygwin-doc files
>> 	/usr/share/doc/cygwin-2.8.0/html/cygwin-{api,ug-net}/*.html 
>> all contain references to docbook.css: 
>> 	<link rel="stylesheet" type="text/css" href="docbook.css">
>> but docbook.css is missing from the .../html/cygwin-{api,ug-net}/ 
>> directories.
>> Could you please add docbook.css to the
>> .../html/cygwin-{api,ug-net}/ directories in the cygwin-doc
>> package.
> I applied a patch for that.
>> Under .../html/cygwin-{api,ug-net}/ index.html duplicates the
>> contents of cygwin-{api,ug-net}.html: to avoid duplication, each
>> index.html could be replaced by a file containing only an HTML
>> "symlink":
>> 	<meta http-equiv="refresh" content="0;cygwin-api.html">
>> or
>> 	<meta http-equiv="refresh" content="0;cygwin-ug-net.html">
> index.html will be installed as hardlink next time.

Thank you.

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

If I was doing that, I would probably also like to add URL 
shortcuts to the Cygwin page and FAQ. Would that be best done 
by adding .URLs to /usr/share/doc/cygwin-???/ and postinstall 
them in the Start Menu or postinstall mkshortcut(s) to the URLs?

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

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