"Fossies" - the Fresh Open Source Software Archive

Member "tin-2.6.0/doc/INSTALL" (7 May 2021, 32381 Bytes) of package /linux/misc/tin-2.6.0.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.4.5_vs_2.6.0.

    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`.
   12 Note: The section 'News machine names' is now at the beginning as it
   13       seemed to be the most sought after section.
   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
   55   ENFORCE_RFC1034                         HAVE_UUDEVIEW_H
   56   EVIL_INSIDE                             NNTP_INEWS
   57   FOLLOW_USEFOR_DRAFT                     NNTP_SERVER_FILE
   58   FORGERY                                 PROFILE
   60   HAVE_LIBUU                              REREAD_ACTIVE_FILE_SECS
   61   HAVE_BROKEN_SSCANF                      DISABLE_PIPELINING
   62   OPTIMIZE_JUST_STAR                      MATCH_TAR_PATTERN
   65 Not yet documented configure options and defines:
   66 -------------------------------------------------
   67 TIN related:
   68   --with-socks                           --with-socks5
   69   --with-sum
   71   BACKUP_FILE_EXT                         FILE_MODE_BROKEN
   72   DEBUG_ART                               NO_LOCKING
   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
   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.
   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".
  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.
  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? :-)
  115 Tin can be compiled to read news in any of the following ways:
  117   o  locally from your machines news spool dir (default /var/spool/news,
  118      can be set via --with-spool-dir).
  120   o  locally and remotely via NNTP (rtin or tin -r option) (--enable-nntp).
  122   o  remotely via NNTP (--enable-nntp-only).
  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/
  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.
  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.
  139 2)  Change conf-tin for your needs or run ./configure with all needed
  140     options.
  142 3)  Type 'make build' to build tin in the src/ directory.
  143     Alternatively go to the src subdirectory and type 'make'.
  145 4)  Type 'make install' to install.
  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.
  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.
  158 Things to test:
  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.
  167    If reading news works fine, then:
  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.
  177    If posting news works fine, then:
  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.
  184 Further testing is desirable, but left to your individual conscience and
  185 ingenuity.
  187 Detailed list of configure options (beginning with '--') and compiler flags
  188 (-D<name> directives):
  191 Compiler and machine options
  192 ----------------------------
  193 --enable-warnings (default: off)
  194 Enable if you want to see all GCC compiler warnings during compilation.
  196 --enable-echo (default: on)
  197 Enable if you want to see full display compiling commands during compilation.
  199 --enable-prototypes (default: off)
  200 Enable if you want configure to check for various fallback prototype
  201 declarations.
  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.
  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!).
  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!).
  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!).
  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!).
  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!).
  246 NNTP - Reading & posting news
  247 -----------------------------
  248 --enable-nntp (default: on)
  249 Enable if you wish to read news locally and remotely via an 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.
  253 --enable-nntp-only (default: off)
  254 Enable if you [want to | can] ONLY read news remotely via an NNTP server.
  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.
  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 subsequent cmds. fail.
  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.
  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.
  277         --disable-fcntl         disable fcntl() locking
  278         --enable-lockf          enable lockf() locking
  279         --enable-flock          enable flock() locking
  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.
  291 NNTP_SERVER_FILE (default: /etc/nntpserver)
  292 Only define if your NNTP-server file is other than /etc/nntpserver.
  295 Define if your newsserver can't handle pipelined commands.
  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.
  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.
  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.
  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.
  325 --with-mailer=PROG (default: empty)
  326 Define the default mailer program.
  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.
  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).
  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.
  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.
  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.
  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
  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)
  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.
  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.
  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.
  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.
  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.
  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.
  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).
  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 '&'.
  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.
  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.
  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.
  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.
  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.
  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.
  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.
  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.
  479 --enable-posting (default: on)
  480 If disabled, TIN does not allow posting/followup of articles.
  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
  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.
  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.
  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.
  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.
  519 --enable-cancel-locks (default: off)
  520 Turn on Cancel-Locks (RFC 8315). This feature requires the client to know
  521 the 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.
  524 --with-canlock[=PATH] (default: bundled copy of canlock)
  525 If --enable-cancel-locks is used, use this option to also specify if you
  526 wish to use an externally-installed copy of the canlock (Cancel-Locks)
  527 library. If you specify a PATH, it should be the root of a directory
  528 containing the include- and lib-directories where canlock is installed.
  529 If you do not specify a PATH, the makefile will use the standard
  530 locations for this library.
  532 --enable-heapsort (default: on)
  533 Enable heapsort(3) as alternative to qsort(3). In large groups with a long
  534 retention and long threads this may be a performance win as the data in
  535 the group is somewhat presorted. Use --disable-heapsort to deactivate
  536 heapsort(3) inclusion.
  538 --disable-ipv6 (default: enabled)
  539 Disable IPv6 support.
  541 --enable-nls (default: on)
  542 The --enable-nls option enables Native Language Support (NLS), which allows
  543 tin to run in languages other than American English. Native Language
  544 Support is enabled by default, the --disable-nls option disables NLS.
  546 --with-included-gettext (default:off)
  547 If NLS is enabled, the --with-included-gettext option causes the build
  548 procedure to prefer its copy of GNU gettext.
  550 --disable-included-msgs (default:off)
  551 If NLS is enabled, the --disable-included-msgs option causes the build
  552 procedure to assume message libraries are already installed, and to
  553 not build them.
  555 HAVE_LIBUU (default: set automatically)
  556 HAVE_UUDEVIEW_H (default: set automatically)
  557 Define *both* if you want to use libuu for uudecoding and collecting
  558 multipart binary articles (libuu is part of uudeview, which can be found at
  559 <http://www.fpx.de/fp/Software/UUDeview/>). libuu must be somewhere in the
  560 library paths, uudeview.h somewhere in the include paths when compiling. If
  561 they are found there by configure, these defines are set automatically.
  564 Debug/test options
  565 ------------------
  566 --with-dbmalloc (default: off)
  567 Link with Conor Cahill's dbmalloc library, used to check for memory leaks,
  568 incorrect frees, etc.
  570 --enable-debug (default: off)
  571 Define if you want tin to log debug information to files in $TMPDIR.
  572 Activated by tin -Dn where n is 1 = NNTP-dialog, 2 = filter-file,
  573 4 = newsrc-file, 8 = threading, 16 = memory allocation (malloc/free),
  574 32 = misc (-D 63 = debug all). Debug files written to $TMPDIR are ARTS,
  576 the debuglevel some files may not be generated. As the files written in
  577 $TMPDIR are world readable and may contain unencrypted password information
  578 (e.g. when using -D 1) don't run "-D n" on multiuser systems without setting
  579 $TMPDIR to a safe location, e.g. "TMPDIR=$HOME ./tin -D 1".
  581 --with-trace (default: off)
  582 Trace data which is formatted and written to the screen. Use this to debug
  583 changes to the curses or termcap interfaces. A file trace will be created in
  584 $PWD when tin is started.
  586 --with-dmalloc (default: off)
  587 Link with Gray Watson's dmalloc library, used to check for memory leaks,
  588 incorrect frees, etc.
  591 profile time consuming operations
  594 Miscellaneous options
  595 ---------------------
  596 --disable-append-pid (default: on)
  597 Disable if you want tin not to append its process id to any file that a user
  598 edits (.article, .cancel, .letter etc.). Keeping the default is highly
  599 recommended if a user wants to start several instances of tin at a time;
  600 otherwise files might be overwritten.
  602 --disable-break-long-lines (default: on)
  603 Disable if you want tin not to break long MIME encoded header lines in
  604 accordance with RFC 2047 (i.e. after 76 characters) in postings as well as
  605 in e-mail. Default is to break ("fold") such lines in news postings.
  606 Some very old news servers and clients can't handle folded lines very
  607 well. This option only affects headers in postings; e-mail headers are
  608 always folded if they have MIME encoded words and are longer than 76
  609 characters.
  611 --enable-broken-system-fix (default: off)
  612 Ignore system()s return value. This is only needed on some very old OSs,
  613 e.g. NEXTSTEP3, SEIUX, DG/UX where the WIFEXITED()/WEXITSTATUS() macros do
  614 not work.
  616 --prefix=dirname
  617 Specify the toplevel installation directory. This is the recommended way to
  618 install tin into a directory other than the default. The toplevel
  619 installation directory defaults to /usr/local.
  621 --exec-prefix=dirname
  622 Specify the toplevel installation directory for architecture-dependent
  623 files. The default is prefix.
  625 --bindir=dirname
  626 Specify the installation directory for the executables called by users (such
  627 as tin and rtin). The default is exec-prefix/bin.
  629 --mandir=dirname
  630 Specify the installation directory for manual pages. The default is
  631 prefix/man.
  633 --program-prefix=prefix
  634 Tin supports transformations of its name when installing it. This option
  635 prepends prefix to the name of the program to be installed in bindir. For
  636 example, specifying --program-prefix=foo- would result in tin being
  637 installed as /usr/local/bin/foo-tin.
  639 --program-suffix=suffix
  640 Appends suffix to the name the program to be installed in bindir. For
  641 example, specifying --program-suffix=-1.5 would result in tin being
  642 installed as /usr/local/bin/tin-1.5
  644 --program-transform-name=pattern
  645 sed script pattern to be applied to the name of the program to be install in
  646 bindir. pattern has to consist of one or more basic sed editing commands,
  647 separated by semicolons. For example, if you want tin program name to be
  648 transformed to the installed program /usr/local/bin/myowntin you could use
  649 the pattern --program-transform-name='s/^tin$/myowntin/' to achieve this
  650 effect.
  653 Define if you want to be able to cancel postings you did not write
  654 yourself. The !cyberspam and cancel conventions are supported. Be
  655 careful with this feature, it should not be used in a free accessible
  656 tin. This feature does not work with INN using the INN-inews (when
  657 using without NNTP), because INN-inews rejects these cancels.
  659 ENFORCE_RFC1034
  660 require domain name components not to start with a digit (GNKSA-check)
  663 require domain literals to be enclosed in square brackets (GNKSA-check)
  665 TINC_DNS
  666 allow additional toplevel domains (GNKSA-check)
  669 let tin generate Message-IDs
  672 issue a warning instead of an error-message if Newsgroups: or
  673 Followup-To:-header contains spaces, newlines or tabs.
  674 See RFC 5536 3.1.4. and RFC 5536 3.2.6.
  677 initial default value for tinrc variable reread_active_file_secs,
  678 see tin(5) for details.
  681 treat a wildmat of * as a match without inspecting the text to match. this
  682 is a simple optimization and hard set to 1 in wildmat.c
  685 do tar(1) matching rules, which ignore a trailing slash. this is hard unset
  686 in wildmat.c to disable it.
  688 DEBUG
  689 allow various debug levels via -D the command-line switch. this may expose
  690 sensitive data (i.e. your username & password used to autheticate on the
  691 news-server) on the local system; read the SECURITY-section in man-page.
  693 License
  694 -------
  695 SPDX-License-Identifier: BSD-3-Clause
  696 See <https://spdx.org/licenses/BSD-3-Clause.html> and/or
  697 <https://opensource.org/licenses/BSD-3-Clause>
  699 Compiled & installed
  700 --------------------
  701 Tin was successfully built and installed on a variety of platforms including
  702 Linux, FreeBSD, OpenBSD, NetBSD, BSDi, Darwin, Solaris, IRIX, HP-UX, Ultrix,
  703 Tru64, AIX, SINIX, UXP/V, SUPER-UX, Unicos, QNX, GNU Hurd, DG/UX, SEIUX,
  704 Openstep, MiNT, Haiku, MINIX, Syllable, Bitrig, UnixWare and Cygwin.
  705 For a detailed list see <http://www.tin.org/builds.html>