cygwin-doc html/ missing docbook.css and index dups cygwin-{api,ug-net}

Brian Inglis
Thu Apr 20 13:44:00 GMT 2017

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 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/ 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/ 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:
Unsubscribe info:

More information about the Cygwin mailing list