This is the mail archive of the mailing list for the Cygwin project.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

RE: setup.exe man page

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

Robert Collins <rbcollins at cygwin dot com>

Attachment: signature.asc
Description: This is a digitally signed message part

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]