"Fossies" - the Fresh Open Source Software Archive

Member "tin-2.6.1/doc/INSTALL" (3 Nov 2021, 32950 Bytes) of package /linux/misc/tin-2.6.1.tar.xz:


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 latest Fossies "Diffs" side-by-side code changes report for "INSTALL": 2.6.0_vs_2.6.1.

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