install

将HTML转换为TXT文件的程序

$Id: INSTALL,v 1.6 1999/11/23 19:35:36 arno Exp $

Compiling HTML2TEXT
===================

HTML2TEXT can be compiled on many UNIX-like platforms. It was developed and/or
tested on the following platforms:

   SINIX/CFRONT 3.1B20  (no longer supported)
   SINIX/CDS++ 1.0C32
   SINIX/CDS++ 2.0A00
   Linux 2.0.35/G++ 2.7.2.1
   Linux 2.2.5/egcs-2.91.66
   AIX 4.2/egcs-2.91.60
   AIX 4.3/g++ 2.95.1

To generate the make files, issue:

      $ sh configure
      Checking for socket libraries...  use "-lsocket -lnsl"
      Checking C++ compiler...  use "CC"
      Checking "bool"...  built-in
      Checking for Standard C++ library...  none; use "./libstd"
      Checking "string::erase()"...  works
      Checking "auto_ptr"...  use "./libstd/include/auto_ptr.h"
      Checking "makedepend" includes...  use "-I/opt/CC/include"
      Creating "./Makefile" from "./Makefile.in"...  done
      Creating "libstd/Makefile" from "libstd/Makefile.in"...  done

      You can now run "make depend" (if you have the MAKEDEPEND utility) and
      then "make".
      $

(The exact output depends on your platform.)

Then compile HTML2TEXT with:

      $ make

Some MAKE utilities have weird built-in rules which collide with the rules
in the make files. If "make" failes, then you must disable the built-in
rules. For most MAKE utilities, this can be achieved by specifying the "-r"
command line option:

      $ make -r

Notice: You need "bison++", "proposed Version 2.2" to generate "HTMLParser.C"
and "HTMLParser.h" from "HTMLParser.y". BISON++ is written by Alain Coetmeur,
and 2.2 is a March 1993 version. I don't know if there is an "official"
place where BISON++ can be found; at least I couldn't find it in the S.u.S.E.
distribution CDs. If somebody knows more about the current status of BISON++,
please let me know.

Anyway, for those who don't have BISON++ 2.2, I have included the
generated "HTMLParser.C" and "HTMLParser.h" files, so you won't need BISON++.

There is no "make install"; just install the "html2text" binary and the
"html2text.1" manual page to whereever you want.


Hints for porting HTML2TEXT to other platforms
==============================================

From version 1.02, HTML2TEXT requires the "socket()" function and its
friends, which live in different libraries for the different systems.
"configure" tries several sets of "-l" linker options to find the right
libraries.

Some C++ compilers lack a built-in "bool" data type. "configure" attempts
to find a suitable definition which it passes to the compiler with
"-DBOOL_DEFINITION=...".

HTML2TEXT requires a Standard C++ Library. Since some old C++ compilers do
not come with a Standard C++ Library, I have implemented parts of the
library in the "libstd" subdirectory; the exported header files are in
"libstd/include". For platforms which come with a (working) Standard C++
Library, the "home-grown" library in "./libstd" is not compiled and linked.

Some old GNU Standard C++ Library versions falsely re-names "list::erase()" as
"list::remove()". I fixed this with a "-DSTRING_ERASE=remove" on the "g++"
command line.

Some compilers do come with a Standard C++ Library, but the definition of the
"auto_ptr" template is missing from "<memory>", or is not standard-compliant.
This condition is checked by "configure" and "./libstd/include/auto_ptr.h" is
included if necessary (preprocessor symbol "HAS_WORKING_AUTO_PTR").

"make depend" attempts to run the MAKEDEPEND utility (not included in this
package). Unfortunately, most C++ compilers implicitly use some "secret"
include directories, which MAKEDEPEND doesn't know of; as a result,
MAKEDEPEND may issue some "could not find..." errors, which shouldn't worry
you. The "configure" script attempts to guess the "secret include directory"
and passes it with "-I" to MAKEDEPEND.


Have fun,

Arno