Ethereal-users: Re: [Ethereal-users] HTML documentation and NSIS installer

Note: This archive is from the project's previous web site, ethereal.com. This list is no longer active.

From: "Gilbert Ramirez" <gram@xxxxxxxxxx>
Date: Thu, 26 Apr 2001 15:22:26 -0500
Thanks for trying the NT build. You have found a corner of the build which
is undocumented (except in ethereal-dev mailing list archives...). I need to
document the fact that the documentation Makefile (doc/Makefile.nmake)
is not included in the normal build chain. Right now, you have to:

cd doc
nmake -f Makefile.nmake

to make the documentation.

So, to build a package, you build ethereal, build the docs, and then
build the NSIS package.

The reason we don't have rules to build the HTML docs on Unix is
just an accident. Our docs, as you have noticed, are written in POD,
which are converted to manpages for Unix -- manpages being the
most common form of documentation on Unix. Since manpages
are rather foreign on Windows systems, I decided to provide HTML
instead, but since I didn't have a need for them on Unix, I never
thought about putting in that rule for the Unix build.  I could if
it were deemed useful and were optional.

Thanks for the note about 1.4beta2 changes.

--gilbert

----- Original Message -----
From: "David O Shea" <david_oshea@xxxxxxxxxxxxx>
To: <ethereal-users@xxxxxxxxxxxx>
Sent: Thursday, April 26, 2001 2:51 PM
Subject: [Ethereal-users] HTML documentation and NSIS installer


> First, let me say that I've found Ethereal to be really great, and I
apologise for having so many questions related to the NT build!  I love the
way it was so easy to write new dissectors from the template!
>
> Now, I have yet another question about building on NT.  I went into
packaging/nsis and ran "make -f Makefile.nmake" and got:
>
> Microsoft (R) Program Maintenance Utility   Version 1.62.7022
> Copyright (C) Microsoft Corp 1988-1997. All rights reserved.
>
> NMAKE : fatal error U1073: don't know how to make
'../../doc/ethereal.html'
> Stop.
>
> I note that under Solaris, I can't make HTML documentation, and there
isn't even a Makefile.nmake in the doc directory.  Out of sheer laziness
I'll not be putting documentation into my installer, but I just wanted to
ask why this is so.
>
> Other than that, making the NSIS installer went quite well, except that I
also had to remove references to the HTML files from ethereal.nsi.in and
also had to add SectionEnd commands to the same file (I guess I have a new
version of NSIS - 1.4 beta 2).
>
> Thanks,
> David
>
> --
> Find the best deals on the web at AltaVista Shopping!
> http://www.shopping.altavista.com
>
> _______________________________________________
> Ethereal-users mailing list
> Ethereal-users@xxxxxxxxxxxx
> http://www.ethereal.com/mailman/listinfo/ethereal-users
>