setup.exe man page

Robert Collins rbcollins@cygwin.com
Tue Mar 18 02:16:00 GMT 2003


On Tue, 2003-03-18 at 13:07, Gary R. Van Sickle wrote:
> > I'm thinking of writing a man page for setup.exe explaining the
> > basics of how it works and that it is currently the preferred
> > way of installing/updating packages and documenting any command-line
> > options. Does the current http://cygwin.com/setup.exe have any?
> > I see several in CVS, but they are spread out in several files and
> > many checkins, is there any way to have it spit out a list?
>
> 
> It would be good if this could be done in such a way that it could be hooked
> into the regular Windows help systems, i.e. WinHelp and/or HTMLHelp.  That way
> it could be attached to a "?" button on Setup's GUI where people could ignore it
> immediately, instead of being a man page that people have to figure out how to
> install before they can ignore it.

Or better yet, both man and Help.

> About all I know about any of this though is that HTMLHelp takes
> pretty-much-standard HTML and compiles it into a single file, which you then run
> with a spawned HTMLHelp viewer, which works well.  Oh, and that WinHelp (the
> older system) takes some bastardized RTF freakshow and spits out a
> difficult-to-use mess.  I don't know if there are any Free HTMLHelp compilers
> around, or if we particularly care, but MS's is free for the downloading, and it
> works OK in a build script.

There is a docbook->man tool, and IIRC a docbook->htmlHelp converter as
well. That would be wirth investigating IMO.

Rob
-- 
Robert Collins <rbcollins@cygwin.com>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://cygwin.com/pipermail/cygwin-apps/attachments/20030318/031143b5/attachment.sig>


More information about the Cygwin-apps mailing list