"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>