"Fossies" - the Fresh Open Source Software Archive

Member "tin-2.6.2/doc/INSTALL" (22 Dec 2022, 33852 Bytes) of package /linux/misc/tin-2.6.2.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.1_vs_2.6.2.

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