From: Brian Inglis <Brian.Inglis@SystematicSw.ab.ca>
To: cygwin@cygwin.com
Subject: Re: cygwin-doc html/ missing docbook.css and index dups cygwin-{api,ug-net}
Date: Thu, 20 Apr 2017 13:44:00 -0000 [thread overview]
Message-ID: <4d562b86-271a-9774-efd5-f1d1eecb1b93@SystematicSw.ab.ca> (raw)
In-Reply-To: <20170419105814.GB19304@calimero.vinschen.de>
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
next prev parent reply other threads:[~2017-04-19 15:42 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
2017-04-16 21:53 Brian Inglis
2017-04-19 15:08 ` Corinna Vinschen
2017-04-20 13:44 ` Brian Inglis [this message]
2017-04-20 15:55 ` Jon Turney
2017-04-21 8:00 ` Brian Inglis
2017-04-21 18:44 ` Andrey Repin
2017-04-21 18:55 ` Brian Inglis
2017-04-23 9:26 ` Andrey Repin
2017-04-21 20:12 ` Andrey Repin
2017-04-22 17:21 ` Corinna Vinschen
2017-04-23 3:05 ` Brian Inglis
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=4d562b86-271a-9774-efd5-f1d1eecb1b93@SystematicSw.ab.ca \
--to=brian.inglis@systematicsw.ab.ca \
--cc=cygwin@cygwin.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).