"Fossies" - the Fresh Open Source Software Archive

Member "tin-2.4.1/doc/INSTALL" (2 Jun 2016, 31071 Bytes) of archive /linux/misc/tin-2.4.1.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the last Fossies "Diffs" side-by-side code changes report for "INSTALL": 2.3.3_vs_2.3.4.

    1 Compilation and installation notes for tin - 2002-06-04 (still incomplete!)
    2 -------------------------------------------------------
    3 Note: Tin requires a valid fully qualified domain name for the host you are
    4       running tin on. IF YOU DON'T HAVE A HOST NAME WITH A VALID DOMAIN GO
    5       AND GET ONE AND CONFIGURE YOUR HOST -- NOW! (This will prevent
    6       problems with other software, too.) Otherwise users may get "Invalid
    7       Sender" error messages and won't be able to post using the internal
    8       inews. You may optionally have a look at the tin.defaults file (watch
    9       out for disable_sender) and install it in the --with-defaults-dir
   10       directory using `make install_sysdefs`.
   11 
   12 Note: The section 'News machine names' is now at the beginning as it
   13       seemed to be the most sought after section.
   14 
   15 
   16 The following configure options and defines are documented in detail:
   17 ---------------------------------------------------------------------
   18   --disable-fcntl                         --prefix
   19   --disable-included-msgs                 --program-prefix
   20   --enable-8bit-keys                      --program-suffix
   21   --enable-append-pid                     --program-transform-name
   22   --disable-break-long-lines              --with-coffee
   23   --enable-broken-listgroup-fix           --with-curses-dir
   24   --enable-broken-system-fix              --with-dbmalloc
   25   --enable-cancel-locks                   --with-defaults-dir
   26   --enable-color                          --with-dmalloc
   27   --enable-curses                         --with-domain-name
   28   --enable-debug                          --with-editor
   29   --enable-echo                           --with-gpg
   30   --enable-etiquette                      --with-included-gettext
   31   --enable-fascist-newsadmin              --with-inews-dir
   32   --enable-flock                          --with-slrnface
   33   --enable-heapsort                       --with-iso-to-ascii
   34   --enable-inverse-video                  --with-ispell
   35   --enable-locale                         --with-libdir
   36   --enable-lockf                          --with-libiconv-prefix
   37   --enable-long-article-numbers           --with-mailbox
   38   --enable-mh-mail-handling               --with-mailer
   39   --enable-mime-strict-charset            --with-metamail
   40   --enable-nls                            --with-mime-default-charset
   41   --enable-nntp                           --with-ncurses
   42   --enable-nntp-only                      --with-nntp-default-server
   43   --enable-pgp-gpg                        --with-nov-dir
   44   --enable-piping                         --with-nov-fname
   45   --enable-posting                        --with-pcre
   46   --enable-printing                       --with-pgp
   47   --enable-prototypes                     --with-pgpk
   48   --enable-shell-escape                   --with-screen
   49   --enable-warnings                       --with-shell
   50   --enable-xhdr-xref                      --with-spooldir
   51   --exec-prefix                           --with-trace
   52   --mandir
   53 
   54 
   55   ENFORCE_RFC1034                         HAVE_UUDEVIEW_H
   56   EVIL_INSIDE                             NNTP_INEWS
   57   FOLLOW_USEFOR_DRAFT                     NNTP_SERVER_FILE
   58   FORGERY                                 PROFILE
   59   REQUIRE_BRACKETS_IN_DOMAIN_LITERAL      SMALL_MEMORY_MACHINE
   60   HAVE_LIBUU
   61   HAVE_BROKEN_SSCANF                      DISABLE_PIPELINING
   62 
   63 
   64 Not yet documented configure options and defines:
   65 -------------------------------------------------
   66 TIN related:
   67   --disable-ipv6                         --with-socks5
   68   --with-socks                           --with-sum
   69 
   70   DEBUG                                   MATCH_TAR_PATTERN
   71   JUST_TESTING                            NEW_HASH_METHOD
   72   OPTIMIZE_JUST_STAR                      REREAD_ACTIVE_FILE_SECS
   73   NO_LOCKING                              FILE_MODE_BROKEN
   74 
   75 System related:
   76   --datadir                               --localstatedir
   77   --includedir                            --oldincludedir
   78   --infodir                               --sbindir
   79   --install-prefix                        --sharedstatedir
   80   --libdir                                --srcdir
   81   --libexecdir                            --sysconfdir
   82   --with-x                                --with-Xaw3d
   83   --with-neXtaw                           --with-XawPlus
   84   --with-build-cc                         --with-build-cflags
   85   --with-build-cppflags                   --with-build-ldflags
   86   --with-build-libs                       --build
   87   --host                                  --target
   88   --with-pkg-config                       --with-textdomain
   89 
   90 News machine names
   91 ------------------
   92 --with-domain-name (default: unset)
   93 Defines the name of your news gateway machine. Useful if you don't want
   94 your internal network visible to the outside world, or if your inews script
   95 or NNTP server rewrites your address for you.
   96 If the first letter of the string is a '/' the gateway name will be read from
   97 the specified file.
   98 
   99 Example: If you are on machine 'tragic' at network domain 'confusion.com',
  100 Tin will assume your From: line should read "user@tragic.confusion.com". If
  101 your inews script instead rewrites your address as "user@confusion.com", you
  102 will be unable to cancel your own postings. To make your posts and cancels
  103 work properly, configure using --with-domain-name="confusion.com".
  104 
  105 
  106 General Notes on Building Tin
  107 -----------------------------
  108 Tin has been compiled on a wide range of Un*x machines with cc and gcc.
  109 A list of these machines can be found at the end of this file.
  110 
  111 This file is long (so was the yellow brick road) but please read it all
  112 as it could save you problems later and we don't want an unhappy ending
  113 do we? :-)
  114 
  115 Tin can be compiled to read news in any of the following ways:
  116 
  117   o  locally from your machines news spool dir (default /var/spool/news,
  118      can be set via --with-spool-dir).
  119 
  120   o  locally and remotely via NNTP (rtin or tin -r option) (--enable-nntp).
  121 
  122   o  remotely via NNTP (--enable-nntp-only).
  123 
  124 If the remote server supports NOV overview indexing, then tin will retrieve
  125 overview data on the fly using the NNTP XOVER extension. Otherwise tin will
  126 create its own NOV style index files on the local machine for each user in
  127 ${TIN_INDEX_NEWSDIR-"${TIN_HOMEDIR-"$HOME"}/.tin"}/.news/
  128 
  129 Many machines require the name of the news gateway machine or the news
  130 domain to be set via the --with-domain-name configure options. This is
  131 true of both NNTP and local news systems.
  132 
  133 
  134 Building the Normal version:
  135 ----------------------------
  136 1)  Type './configure --help' to see which options are needed for your
  137     local setup. These options are described below, too.
  138 
  139 2)  Change conf-tin for your needs or run ./configure with all needed
  140     options.
  141 
  142 3)  Type 'make build' to build tin in the src/ directory.
  143     Alternatively go to the src subdirectory and type 'make'.
  144 
  145 4)  Type 'make install' to install.
  146 
  147 5)  Have a look at doc/tin.defaults and set options as you need them (if
  148     they differ from your compile time options). If you make any changes,
  149     type 'make install_sysdefs' afterwards.
  150 
  151 
  152 Testing Tin
  153 -----------
  154 Of course you _were_ going to test it before installing it for anyone else
  155 to use, weren't you? This is just a little reminder and some suggestions
  156 on what to test first, and where to look first if it's broken.
  157 
  158 Things to test:
  159 
  160 1) Check that you can read news from several local and world-wide groups.
  161    If this fails, check that the NNTP define directives are correctly set,
  162    and for local news systems, that the News directory structure define
  163    directives are correctly set. For NNTP versions, check that the server is
  164    actually running and can be connected to from your machine. This should
  165    help you find and fix some of the most common problems.
  166 
  167    If reading news works fine, then:
  168 
  169 2) Check that you can post a test message to a local distribution group,
  170    preferably a test-only group. (Remember, the world does not care to know
  171    whether you are testing Tin.) If it fails, check that the
  172    --with-inews-dir option is correctly set, that NNTP_INEWS is correctly
  173    set, and that the News machine name define directives are correctly set.
  174    If possible, check whether you can post via some other mechanism, such
  175    as Pnews. This should help you isolate and fix the most common problems.
  176 
  177    If posting news works fine, then:
  178 
  179 3) Check that you can cancel one of your test postings. If not, it is
  180    almost certain that your News machine defines need to be set correctly,
  181    because Tin thinks your From: line is different from what has actually
  182    been posted. See the section on News machine names above and below.
  183 
  184 Further testing is desirable, but left to your individual conscience and
  185 ingenuity.
  186 
  187 Detailed list of configure options (beginning with '--') and compiler flags
  188 (-D<name> directives):
  189 
  190 
  191 Compiler and machine options
  192 ----------------------------
  193 --enable-warnings (default: off)
  194 Enable if you want to see all GCC compiler warnings during compilation.
  195 
  196 --enable-echo (default: on)
  197 Enable if you want to see full display compiling commands during compilation.
  198 
  199 --enable-prototypes (default: off)
  200 Enable if you want configure to check for various fallback prototype
  201 declarations.
  202 
  203 SMALL_MEMORY_MACHINE (default: not set)
  204 Define if you are running a machine with little memory (<4MB). Tin will
  205 run slightly slower but be more efficient in how memory is allocated and
  206 reclaimed.
  207 
  208 
  209 News directory structure
  210 ------------------------
  211 --with-libdir=PATH (default: /usr/lib/news or not set)
  212 Define if news software is not in /usr/lib/news. (Only needed if not
  213 running --enable-nntp-only.) Compiled-in value can be overridden by setting
  214 the newslibdir entry in doc/tin.defaults (don't forget to 'make
  215 install_sysdefs' to install the tin.defaults file at a location where tin
  216 can find it!).
  217 
  218 --with-spooldir=PATH (default: /var/spool/news or not set)
  219 Define if news articles are not in /var/spool/news. (Only needed if not
  220 running --enable-nntp-only.) Compiled-in value can be overridden by setting
  221 the spooldir entry in tin.defaults (don't forget to 'make install_sysdefs'
  222 to install the tin.defaults file at a location where tin can find it!).
  223 
  224 --with-nov-dir=PATH (default: same as --with-spooldir)
  225 Define if news overview (NOV) files are not stored in SPOOLDIR. (only
  226 needed if not running --enable-nntp-only) Compiled-in value can be
  227 overridden by setting the overviewdir entry in tin.defaults (don't forget
  228 to 'make install_sysdefs' to install the tin.defaults file at a location
  229 where tin can find it!).
  230 
  231 --with-nov-fname=NAME (default: .overview or not set)
  232 Define if your news overview files are not named .overview. (Only needed if
  233 not running --enable-nntp-only.) Compiled-in value can be overridden by
  234 setting the overviewfile entry in tin.defaults (don't forget to 'make
  235 install_sysdefs' to install the tin.defaults file at a location where tin
  236 can find it!).
  237 
  238 --with-inews-dir=PATH (default: same as --with-libdir or /usr/lib/news)
  239 Define if the 'inews' program is not in the directory specified with
  240 --with-libdir (if not running --enable-nntp-only) or /usr/lib/news (if
  241 running --enable-nntp-only). Compiled-in value can be overridden by setting
  242 the inewsdir entry in tin.defaults (don't forget to 'make install_sysdefs'
  243 to install the tin.defaults file at a location where tin can find it!).
  244 
  245 
  246 NNTP - Reading & posting news
  247 -----------------------------
  248 --enable-nntp (default: on)
  249 Enable if you wish to read news locally and remotely via a NNTP server.
  250 Disable if you only want to read from local spool. Note: If you disable
  251 this feature, you won't be able to connect to any NNTP server.
  252 
  253 --enable-nntp-only (default: off)
  254 Enable if you [want to | can] ONLY read news remotely via a NNTP server.
  255 
  256 --with-nntp-default-server (default: news.$DOMAIN_NAME)
  257 Defines the name of the default NNTP server that tin should connect to.
  258 Can be overridden by setting the environment variable NNTPSERVER.
  259 
  260 --enable-broken-listgroup-fix (default: off)
  261 Bypass a bug in some broken NNTPservers which need an extra GROUP command
  262 before accepting a LISTGROUP command. This can be also used to bypass the
  263 bug in some servers (i.e. DeleGate, SurgeNews) where LISTGROUP doesn't
  264 select the group and thus subseqent cmds. fail.
  265 
  266 --enable-xhdr-xref (default: on)
  267 If disabled, don't allow using XHDR XREF if XOVER doesn't work to mark
  268 crossposted articles as read in all groups.
  269 
  270 The following options determine which locking method should be used when
  271 appending posted or postponed messages to mailbox-style files. Tin will
  272 try each method that can be configured, in succession. If none of your
  273 selections can be configured, tin will try each possibility anyway. The
  274 intent of these options is to prevent particular locking methods from
  275 being configured into the executable.
  276 
  277         --disable-fcntl         disable fcntl() locking
  278         --enable-lockf          enable lockf() locking
  279         --enable-flock          enable flock() locking
  280 
  281 NNTP_INEWS (default: set if using --enable-nntp or enable-nntp-only;
  282                      unset if not using NNTP)
  283 Define if you want to use the built-in NNTP POST routine so that you no
  284 longer have to rely on the mini-inews from NNTP to be installed on each
  285 client machine. Also check that --with-domain-name is correctly set to
  286 produce a correct From: headers for your site. If defined then the
  287 ~/.tin/tinrc variable "inews_prog" default will be set to --internal.
  288 The tinrc file is created automatically for each user the first
  289 time they use tin.
  290 
  291 NNTP_SERVER_FILE (default: /etc/nntpserver)
  292 Only define if your NNTP-server file is other than /etc/nntpserver.
  293 
  294 DISABLE_PIPELINING
  295 Define if your newsserver can't handle pipelined commands.
  296 
  297 --enable-long-article-numbers (default: off)
  298 Add code to handle huge (>2^31) article numbers, such article numbers violate
  299 the NNTP RFC and support for them may sensible increases tins memory usage.
  300 If SMALL_MEMORY_MACHINE is defined --enable-long-article-numbers has no
  301 effect.
  302 
  303 
  304 Options to set some default values
  305 ----------------------------------
  306 --with-shell=PROG (default: sh, except on BSD where csh is used)
  307 Define the default shell which is used if the $SHELL variable is not set,
  308 and the user has not defined it in their tinrc file. Do not give the
  309 directory as part of the program name; the configure script will look for
  310 it in standard locations.
  311 
  312 --with-defaults-dir=PATH (default: /etc/tin)
  313 Define the directory for the tin.defaults file. With the entries in the
  314 tin.defaults you can set some machine specific options and override some
  315 compile time defaults. See the tin.defaults file in the doc directory for
  316 more information.
  317 
  318 --with-editor=PROG (default: empty)
  319 Define if the standard editor should be anything other than the value of
  320 your EDITOR or VISUAL environment variable or, at as the last resort, vi.
  321 You can also add some default command line options to the editor. Users
  322 can overwrite this value by setting default_editor_format in their tinrc
  323 file.
  324 
  325 --with-mailer=PROG (default: empty)
  326 Define the default mailer program.
  327 
  328 --with-mailbox=PATH (default: empty)
  329 Define the directory for incoming mailboxes. If none is given,
  330 /var/spool/mail, /usr/spool/mail, /var/mail, /usr/mail, and /mail are
  331 checked automatically.
  332 
  333 --enable-etiquette (default: on)
  334 If enabled, prints netiquette before posting by default. Users can turn
  335 this off by setting beginner_level to OFF in their tinrc. If disabled,
  336 netiquette is never displayed (cannot be turned on without recompiling).
  337 
  338 
  339 Input and screen output options
  340 -------------------------------
  341 --enable-locale (default: on)
  342 If enabled, tin uses multi language support, as described in locale(7). If
  343 you don't have locale support installed on your system, try
  344 --disable-locale, otherwise you won't see any 8-bit-characters. See
  345 doc/umlauts.txt (english text) or doc/umlaute.txt (german text) for further
  346 information.
  347 
  348 --with-mime-default-charset=charset (default: US-ASCII)
  349 Define if your users usually post messages in another charset than
  350 US-ASCII. Europeans should use one of the ISO-8859-X series here.
  351 Compiled-in default value can be overridden by setting the mm_charset entry
  352 in tin.defaults (don't forget to 'make install_sysdefs' to install the
  353 tin.defaults file at a location where tin can find it!). Users can override
  354 this value by setting MM_CHARSET in the options menu or using the
  355 MM_CHARSET environment variable.
  356 
  357 --enable-mime-strict-charset (default: on)
  358 If this option is turned on, any characters of charsets other than that
  359 defined in MM_CHARSET will be considered non-displayable. If your standard
  360 encoding is ISO-8859-X then you probably want to disable this option.
  361 
  362 --with-iso-to-ascii=value (default: -1)
  363 Define if you want tin to do ISO-8859-1 to ASCII charset conversions by
  364 default for all groups. You must specify a value of "0-6" to get tin to use
  365 one of the following 7 conversion tables for different languages
  366 
  367         0  replace 8-bit letters by 7-bit counterpart without diacritics
  368            ( -> A) and other characters by similar 7-bit ones ( -> >>)
  369         1  same as 0, but use only one character (preserves layout)
  370         2  convert 8-bit letters to 7-bit replacements ( -> Ae)
  371            (useful for Danish, Dutch, German, Norwegian and Swedish)
  372         3  replace 8-bit letters by 7-bit ISO 646 characters
  373            (mostly for Danish, Finnish, Norwegian and Swedish)
  374         4  convert 8-bit characters according to RFC 1345
  375         5  build 8-bit characters by combining several 7-bit chars and
  376            using backspace (useful for printers)
  377         6  table for IBM PC character set (code page 437)
  378 
  379 E.g., adding --with-iso-to-ascii=2 to the configure options would be useful
  380 in german language newsgroups. For more detailed info read the file
  381 ./doc/iso2asc.txt. Default value for --with-iso-to-ascii is "-1", which
  382 means no conversion at all. Users can override this value by setting an
  383 environment variable ISO2ASC.
  384 
  385 --with-curses-dir=dir (default: empty)
  386 If (n)curses is not installed in a standard location (i.e below /usr) you
  387 can specify its installation directory here.
  388 
  389 --with-screen=type (default: termcap)
  390 This is a simpler way (than --with-ncurses and --enable-curses) to specify
  391 the screen library. If you give none of these options, the configure script
  392 will look for the termcap or terminfo interfaces, and attempt to use the
  393 most appropriate one that your system supports. The other screen types which
  394 you may select are: curses, ncurses, ncursesw, pdcurses.
  395 
  396 --with-ncurses
  397 Define this if you want to link with ncurses instead of termcap. Note: This
  398 is required on some Linux distributions (i.e., SuSE) where there is either a
  399 curses or termcap library which is not ncurses. If ncurses is installed as
  400 the curses library, this option is usually not needed. This option is
  401 deprecated, use --with-screen=ncurses (see above) instead.
  402 
  403 --enable-curses (default: off)
  404 Enable this if you wish to use the curses screen optimizing rather than
  405 termcap. This has been tested well starting with ncurses 4.1; it should work
  406 (except for mouse support and screen resizing) with SVr4 curses (Solaris 2.5
  407 is known to have a bug in libc which prevents use of curses, ncurses works
  408 well on that platform). To build with ncurses screen optimizing, you must
  409 give both the --with-ncurses and --enable-curses options. This option is
  410 deprecated, use --with-screen=ncurses (see above) instead.
  411 
  412 --enable-inverse-video (default: on)
  413 Disable if you want inverse video and highlighted bar disabled by default.
  414 Can be toggled in tin by the 'I' command. Users can also set draw_arrow and
  415 inverse_ok variables in their tinrc to override this default.
  416 
  417 --enable-8bit-keys (default: on)
  418 Enable if your terminal generates 8-bit controls. For Unix systems we
  419 assume this may imply your arrow keys begin either with CSI (0x9b) or SS3
  420 (0x8f). Most ANSI terminals generate 7-bit controls (e.g., CSI is
  421 "<esc>["), but some such as VT220 can be configured more efficiently to
  422 generate 8-bit prefix codes, saving a byte per control sequence. This
  423 applies to cursor movement at the same time. The actual codes are read
  424 from termcap (this does not affect the curses configuration).
  425 
  426 
  427 Feature options
  428 ---------------
  429 --enable-color (default: on)
  430 Enable if you want to have ANSI-color support. This works on most color
  431 displays and the color xterm. The color mode can be switched on/off in
  432 ~/.tin/tinrc (use_color) and can be toggled with option -a or key '&'.
  433 
  434 --enable-pgp-gpg (default: on)
  435 Use --disable-pgp-gpg to turn off all pgp/gpg support, use
  436 --with[out]-[pgp|pgpk|gpg] to select exactly one of the encryption
  437 systems! Once again: if you have more than one method installed on
  438 your system, _disable_ all but one of the offered pgp/pgp supports.
  439 
  440 --with-pcre[=PATH] (default: bundled copy of pcre)
  441 Define if you wish to use an externally-installed copy of PCRE
  442 (Perl-compatible regular expressions). If you specify a PATH, it should
  443 be the root of a directory containing the include- and lib-directories
  444 where PCRE is installed. If you do not specify a PATH, the makefile
  445 will use the standard locations for this library. Tin will build with
  446 PCRE 2.08 and later.
  447 
  448 --with-pgp=PATH (default: from system $PATH)
  449 Define if you have PGP-2 (Pretty Good Privacy encryption system)
  450 installed and want the option of checking signatures, extract keys,
  451 sign messages and add public key to messages. This is bound to the
  452 key 'g' or '^G'. Say --without-pgp if you don't want pgp-2 support.
  453 
  454 --with-pgpk=PATH (default: from system $PATH)
  455 Define if you have PGP-5 (Pretty Good Privacy encryption system)
  456 installed and want the option of checking signatures, extract keys,
  457 sign messages and add public key to messages. This is bound to the
  458 key 'g' or '^G'. Say --without-pgpk if you don't want pgp-5 support.
  459 
  460 --with-gpg=PATH (default: from system $PATH)
  461 Define if you have GPG (GNU Privacy Guard encryption system)
  462 installed and want the option of checking signatures, extract keys,
  463 sign messages and add public key to messages. This is bound to the
  464 key 'g' or '^G'. Say --without-gpg if you don't want gpg support.
  465 
  466 --with-ispell=PATH (default: set automatically)
  467 Define if you have ispell (interactive spell-checker) installed and want
  468 the option of checking your articles, mails before posting/mailing them. If
  469 found in search path, this is used automatically.
  470 
  471 --with-metamail=PATH (default: set automatically)
  472 Define if you want metamail display your MIME messages. If found in search
  473 path, this is used automatically.
  474 
  475 --with-slrnface=PATH (default: set automatically)
  476 Define if you have slrnface installed and want to use it to show X-Faces. If
  477 found in search path, this is used automatically.
  478 
  479 --enable-posting (default: on)
  480 If disabled, TIN does not allow posting/followup of articles.
  481 
  482 --enable-fascist-newsadmin (default: off)
  483 Enable if you want to restrict articles posted with your tin a bit to
  484 enforce some formal rules. This will change the following warnings to an
  485 error in the article checking routine therefore causing the user to reenter
  486 the editor and change the article or to abort posting:
  487  - Group(s) in Newsgroups: or Followup-To: header were not found in
  488    the sites' active file
  489  - Approved: header was found when user was in beginner level
  490  - Signature has more than MAX_SIG_LINES (see include/tin.h) lines
  491  - Crossposting without Followup-To: header
  492  - Followup-To: header with more than one newsgroup
  493 
  494 --enable-shell-escape (default: on)
  495 If disabled, do not allow shell escapes. Note: There may still be
  496 possibilities for users to start a shell (e.g. from within an editor or
  497 using a shell as the "editor"), even if you disable this feature here.
  498 They are just not able to use the '!' key to do so.
  499 
  500 --enable-piping (default: on)
  501 Disable if your system does not support piping of articles to shell commands
  502 or if you don't want your users to have such support. Note: There may still
  503 be possibilities for users to "pipe" an article to a command, even if you
  504 disable this feature. They are just not able to use the '|' key to do so.
  505 
  506 --enable-printing (default: on)
  507 Disable if your system does not support printing or if you don't want your
  508 users to have such support. Note: There may still be possibilities for users
  509 to print an article, even if you disable this feature. They are just not
  510 able to use the 'o' key to do so.
  511 
  512 --enable-mh-mail-handling (default: off)
  513 Enable if you want to use the MH style mail handling & reading code in
  514 mail.c. It should be noted that mail handling is not well tested and not
  515 yet fully implemented. You can expect errors if you use this option so let
  516 me know the problems by sending me a bug report ('R' bug command from
  517 within tin). See doc/reading-mail.txt for further information.
  518 
  519 --enable-cancel-locks (default: off)
  520 Turn on Cancel-Locks. This feature requires the client to know the
  521 Message-ID of the posting, so if your server does not offer server side
  522 purposed IDs you have to mess around with EVIL_INSIDE
  523 
  524 --enable-heapsort (default: on)
  525 Enable heapsort(3) as alternative to qsort(3). In large groups with a long
  526 retention and long threads this may be a performance win as the data in
  527 the group is somewhat presorted. Use --disable-heapsort to deactivate
  528 heapsort(3) inclusion.
  529 
  530 --enable-nls (default: on)
  531 The --enable-nls option enables Native Language Support (NLS), which allows
  532 tin to run in languages other than American English. Native Language
  533 Support is enabled by default, the --disable-nls option disables NLS.
  534 
  535 --with-included-gettext  (default:off)
  536 If NLS is enabled, the --with-included-gettext option causes the build
  537 procedure to prefer its copy of GNU gettext.
  538 
  539 --disable-included-msgs  (default:off)
  540 If NLS is enabled, the --disable-included-msgs option causes the build
  541 procedure to assume message libraries are already installed, and to
  542 not build them.
  543 
  544 HAVE_LIBUU (default: set automatically)
  545 HAVE_UUDEVIEW_H (default: set automatically)
  546 Define *both* if you want to use libuu for uudecoding and collecting
  547 multipart binary articles (libuu is part of uudeview, which can be found at
  548 <http://www.fpx.de/fp/Software/UUDeview/>). libuu must be somewhere in the
  549 library paths, uudeview.h somewhere in the include paths when compiling. If
  550 they are found there by configure, these defines are set automatically.
  551 
  552 
  553 Debug/test options
  554 ------------------
  555 --with-dbmalloc (default: off)
  556 Link with Conor Cahill's dbmalloc library, used to check for memory leaks,
  557 incorrect frees, etc.
  558 
  559 --enable-debug (default: off)
  560 Define if you want tin to log debug information to files in $TMPDIR.
  561 Activated by tin -Dn where n is 1 = NNTP-dialog, 2 = filter-file,
  562 4 = newsrc-file, 8 = threading, 16 = memory allocation (malloc/free),
  563 32 = misc (-D 63 = debug all). Debug files written to $TMPDIR are ARTS,
  564 ACTIVE, BASE, NNTP, SAVE_COMP, BITMAP, MALLOC and FILTER. Depending on
  565 the debuglevel some files may not be generated. As the files written in
  566 $TMPDIR are world readable and may contain uncryted password information
  567 (e.g. when using -D 1) don't run "-D n" on multiuser systems without setting
  568 $TMPDIR to a safe location, e.g. "TMPDIR=$HOME ./tin -D 1".
  569 
  570 --with-trace (default: off)
  571 Trace data which is formatted and written to the screen. Use this to debug
  572 changes to the curses or termcap interfaces. A file trace will be created in
  573 $PWD when tin is started.
  574 
  575 --with-dmalloc (default: off)
  576 Link with Gray Watson's dmalloc library, used to check for memory leaks,
  577 incorrect frees, etc.
  578 
  579 PROFILE
  580 profile time consuming operations
  581 
  582 
  583 Miscellaneous options
  584 ---------------------
  585 --disable-append-pid (default: on)
  586 Disable if you want tin not to append its process id to any file that a user
  587 edits (.article, .cancel, .letter etc.). Keeping the default is highly
  588 recommended if a user wants to start several instances of tin at a time;
  589 otherwise files might be overwritten.
  590 
  591 --disable-break-long-lines (default: on)
  592 Disable if you want tin not to break long MIME encoded header lines in
  593 accordance with RFC 2047 (i.e. after 76 characters) in postings as well as
  594 in e-mail. Default is to break ("fold") such lines in news postings.
  595 Some very old news servers and clients can't handle folded lines very
  596 well. This option only affects headers in postings; e-mail headers are
  597 always folded if they have MIME encoded words and are longer than 76
  598 characters.
  599 
  600 --enable-broken-system-fix (default: off)
  601 Ignore system()s return value. This is only needed on some very old OSs,
  602 e.g. NEXTSTEP3, SEIUX, DG/UX where the WIFEXITED()/WEXITSTATUS() macros do
  603 not work.
  604 
  605 --prefix=dirname
  606 Specify the toplevel installation directory. This is the recommended way to
  607 install tin into a directory other than the default. The toplevel
  608 installation directory defaults to /usr/local.
  609 
  610 --exec-prefix=dirname
  611 Specify the toplevel installation directory for architecture-dependent
  612 files. The default is prefix.
  613 
  614 --bindir=dirname
  615 Specify the installation directory for the executables called by users (such
  616 as tin and rtin). The default is exec-prefix/bin.
  617 
  618 --mandir=dirname
  619 Specify the installation directory for manual pages. The default is
  620 prefix/man.
  621 
  622 --program-prefix=prefix
  623 Tin supports transformations of its name when installing it. This option
  624 prepends prefix to the name of the program to be installed in bindir. For
  625 example, specifying --program-prefix=foo- would result in tin being
  626 installed as /usr/local/bin/foo-tin.
  627 
  628 --program-suffix=suffix
  629 Appends suffix to the name the program to be installed in bindir. For
  630 example, specifying --program-suffix=-1.5 would result in tin being
  631 installed as /usr/local/bin/tin-1.5
  632 
  633 --program-transform-name=pattern
  634 sed script pattern to be applied to the name of the program to be install in
  635 bindir. pattern has to consist of one or more basic sed editing commands,
  636 separated by semicolons. For example, if you want tin program name to be
  637 transformed to the installed program /usr/local/bin/myowntin you could use
  638 the pattern --program-transform-name='s/^tin$/myowntin/' to achieve this
  639 effect.
  640 
  641 FORGERY
  642 Define if you want to be able to cancel postings you did not write
  643 yourself. The !cyberspam and cancel conventions are supported. Be
  644 careful with this feature, it should not be used in a free accessible
  645 tin. This feature does not work with INN using the INN-inews (when
  646 using without NNTP), because INN-inews rejects these cancels.
  647 
  648 ENFORCE_RFC1034
  649 require domain name components not to start with a digit (GNKSA-check)
  650 
  651 REQUIRE_BRACKETS_IN_DOMAIN_LITERAL
  652 require domain literals to be enclosed in square brackets (GNKSA-check)
  653 
  654 TINC_DNS
  655 allow additional toplevel domains (GNKSA-check)
  656 
  657 EVIL_INSIDE
  658 let tin generate Message-IDs
  659 
  660 FOLLOW_USEFOR_DRAFT
  661 issue a warning instead of an error-message if Newsgroups: or
  662 Followup-To:-header contains spaces, newlines or tabs.
  663 
  664 
  665 Compiled & installed
  666 --------------------
  667 Tin was successfully built and installed on a variety of platforms including
  668 Linux, FreeBSD, OpenBSD, NetBSD, BSDi, Darwin, Solaris, IRIX, HP-UX, Ultrix,
  669 Tru64, AIX, SINIX, UXP/V, SUPER-UX, Unicos, QNX, GNU Hurd, DG/UX, SEIUX,
  670 Openstep, MiNT, Haiku, MINIX, Syllable and Cygwin.
  671 For a detailed list see <http://www.tin.org/builds.html>